...
Eroare PostgreSQL · Tipuri de date, operatori și conversii

ERROR: value too long for type character varying(5)

Pe scurt

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

Greșit
SQL
CREATE TABLE judete (cod varchar(2), nume varchar(10));
INSERT INTO judete VALUES ('CS', 'Caraș-Severin');
Corect
SQL
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

Greșit
SQL
INSERT INTO judete VALUES ('CJ ', 'Cluj');  -- cu spațiu
Corect
SQL
INSERT INTO judete VALUES (trim('CJ '), 'Cluj');

Spațiile în plus contează la lungime; curăță valoarea înainte.

3Mărirea limitei pe coloana existentă

Greșit
SQL
INSERT INTO clienti_ro (telefon) VALUES ('+40 722 123 456');  -- varchar(10)
Corect
SQL
ALTER TABLE clienti_ro ALTER COLUMN telefon TYPE varchar(20);

Mărirea limitei nu rescrie tabelul și se face rapid.

Repară tu

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.

Codul care dă eroarea
SQL
INSERT INTO judete VALUES ('CS', 'Caraș-Severin');
SELECT cod, nume FROM judete ORDER BY cod;
După reparație, programul afișează
ALTER TABLE
INSERT 0 1
 cod |     nume
-----+---------------
 CJ  | Cluj
 CS  | Caraș-Severin
(2 rânduri)
Indiciu

ALTER TABLE ... ALTER COLUMN ... TYPE

Alte forme ale mesajului

  • ERROR: value too long for type character(2)

Cum o eviți pe viitor

  • Folosește text dacă nu există o regulă reală de lungime; pune regula într-un CHECK (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

← Toate erorile PostgreSQL

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.