ERROR: value too long for type character varying(5)
Valoarea are mai multe caractere decât permite coloana varchar(n). Fie mărești limita (sau treci la text), fie validezi și scurtezi valoarea în aplicație. PostgreSQL nu taie automat textul la INSERT, ca să nu pierzi date.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
varchar(n) (sau character varying(n)) permite maximum n caractere (nu octeți), iar PostgreSQL refuză valorile mai lungi cu această eroare. Mesajul spune limita, dar nu și coloana; dacă tabelul are mai multe coloane varchar(5), găsește-o comparând lungimile valorilor cu \d tabel.
Spre deosebire de MySQL în mod non-strict, PostgreSQL nu trunchiază niciodată în tăcere la INSERT sau UPDATE. Excepția este conversia explicită, valoare::varchar(5), care taie textul. În PostgreSQL nu există avantaj de performanță pentru varchar(n) față de text, deci limita are sens doar ca regulă de business. Mărirea limitei (ALTER COLUMN ... TYPE varchar(20)) e instantanee; trecerea la text la fel.
De ce apare: cauzele frecvente
1Limită prea mică pentru date reale
CREATE TABLE judete (cod varchar(2), nume varchar(10));
INSERT INTO judete VALUES ('CS', 'Caraș-Severin');CREATE TABLE judete (cod varchar(2), nume text);
INSERT INTO judete VALUES ('CS', 'Caraș-Severin');Numele reale pot depăși limite alese „din ochi”; text nu are limită.
2Valoare neașteptată din aplicație
INSERT INTO judete VALUES ('CJ ', 'Cluj'); -- cu spațiuINSERT INTO judete VALUES (trim('CJ '), 'Cluj');Spațiile în plus contează la lungime; curăță valoarea înainte.
3Mărirea limitei pe coloana existentă
INSERT INTO clienti_ro (telefon) VALUES ('+40 722 123 456'); -- varchar(10)ALTER TABLE clienti_ro ALTER COLUMN telefon TYPE varchar(20);Mărirea limitei nu rescrie tabelul și se face rapid.
Repară eroarea, direct în pagină
Tabelul judete are coloana nume varchar(10). Adăugarea județului Caraș-Severin dă value too long for type character varying(10). Modifică tipul coloanei ca să accepte numele complet, apoi inserează județul și afișează codul și numele județelor, ordonate după cod.
INSERT INTO judete VALUES ('CS', 'Caraș-Severin');
SELECT cod, nume FROM judete ORDER BY cod;ALTER TABLE INSERT 0 1 cod | nume -----+--------------- CJ | Cluj CS | Caraș-Severin (2 rânduri)
Indiciu
ALTER TABLE ... ALTER COLUMN ... TYPE
Reparația
ALTER TABLE judete ALTER COLUMN nume TYPE text;
INSERT INTO judete VALUES ('CS', 'Caraș-Severin');
SELECT cod, nume FROM judete ORDER BY cod;De ce merge
„Caraș-Severin” are 13 caractere, peste limita de 10. Cu ALTER COLUMN nume TYPE text, limita dispare, iar operația e instantanee, pentru că datele existente sunt compatibile. Varianta varchar(50) ar fi fost la fel de bună. INSERT-ul trece, iar lista afișează cele două județe.
Alte forme ale mesajului
ERROR: value too long for type character(2)
Cum o eviți pe viitor
- Folosește
textdacă nu există o regulă reală de lungime; pune regula într-unCHECK (char_length(col) <= n)când există. - Validează lungimea în aplicație, ca utilizatorul să primească un mesaj clar.
- Alege limitele după datele reale (nume de județe, adrese internaționale, numere de telefon cu prefix), nu după obiceiuri.
Întrebări frecvente
Limita e în caractere sau în octeți?
În caractere. Un text cu diacritice ocupă mai mulți octeți, dar varchar(5) permite tot 5 caractere.
De ce ::varchar(5) nu dă eroare, iar INSERT da?
Conversia explicită este definită de standard să trunchieze. Atribuirea către o coloană (INSERT, UPDATE) verifică și refuză.
Erori înrudite
ERROR: numeric field overflow Valoarea nu încape în precizia coloanei numeric(p, s): numeric(5,2) acceptă cel mult 999.99. Mesajul vine cu DETAIL: A field with precision 5, scale 2 must round to an absolute value less than 10^3. Mărește precizia coloanei sau verifică dacă valoarea e corectă. ERROR: integer out of range Un calcul sau o valoare depășește limitele tipului integer (aproximativ ±2,1 miliarde). Apare la sume mari (sum pe integer întoarce bigint, dar înmulțirea a două integer nu), la conversii (valoare::int) sau la coloane id care au ajuns la limită. Folosește bigint sau numeric pentru valori mari. ERROR: new row for relation "produse" violates check constraint "produse_pret_check" Rândul nou sau modificat nu respectă o constrângere CHECK, de exemplu un preț zero sau negativ când regula cere pret > 0. DETAIL arată rândul complet. Corectează valoarea; dacă regula s-a schimbat, modifică constrângerea, nu o ocoli. Învață PostgreSQL de la zero, cu exerciții la fiecare lecție
Curs PostgreSQL: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.
