ERROR: collation "ro_RO" for encoding "UTF8" does not exist
Colația cerută nu există în baza de date, de obicei pentru că numele e scris altfel decât îl știe sistemul (ro_RO.utf8, ro-RO-x-icu) sau pentru că localizarea nu e instalată pe server. Verifică numele disponibile cu SELECT collname FROM pg_collation și folosește-l exact.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
O colație definește regulile de comparare și sortare a textelor. PostgreSQL le citește din sistemul de operare (libc) la initdb și din biblioteca ICU, iar numele diferă: libc folosește forme ca ro_RO.utf8, ICU forme ca ro-RO-x-icu sau ro-x-icu. Numele "ro_RO" fără sufix poate să nu existe, iar mesajul spune și encoding-ul căutat.
Pe imaginile Docker minimale sau în servicii gestionate, multe localizări libc lipsesc, dar colațiile ICU sunt de obicei disponibile (dacă PostgreSQL a fost compilat cu ICU). Soluția stabilă este o colație creată explicit (CREATE COLLATION ro (provider = icu, locale = 'ro-RO')) și folosită în coloane sau interogări. Dacă nicio colație românească nu e disponibilă, sortarea cu C ordonează după coduri, iar literele cu diacritice ajung la final.
De ce apare: cauzele frecvente
1Nume de colație inexistent
SELECT nume FROM clienti ORDER BY nume COLLATE "ro_RO";SELECT collname FROM pg_collation WHERE collname ILIKE 'ro%';
SELECT nume FROM clienti ORDER BY nume COLLATE "ro-RO-x-icu";Verifici numele disponibile și îl folosești exact, între ghilimele.
2Localizare libc lipsă pe server
CREATE DATABASE magazin LC_COLLATE 'ro_RO.UTF-8';CREATE DATABASE magazin LOCALE_PROVIDER icu ICU_LOCALE 'ro-RO' TEMPLATE template0;Providerul ICU nu depinde de localizările instalate în sistemul de operare.
3Colație proprie, cu nume stabil
ORDER BY nume COLLATE "ro_RO"CREATE COLLATION romana (provider = icu, locale = 'ro-RO');
... ORDER BY nume COLLATE romanaUn nume propriu rămâne același pe toate serverele.
Repară eroarea, direct în pagină
Lista de clienți trebuie sortată alfabetic după regulile limbii române, dar interogarea dă collation "ro_RO" for encoding "UTF8" does not exist. În laborator există o colație ICU numită und-x-icu. Folosește-o în locul celei inexistente și afișează numele clienților sortate.
SELECT nume FROM clienti ORDER BY nume COLLATE "ro_RO";nume -------- Ana Sorin Ștefan Zoe (4 rânduri)
Indiciu
Numele colației se scrie între ghilimele duble, exact cum apare în pg_collation.
Reparația
SELECT nume FROM clienti ORDER BY nume COLLATE "und-x-icu";De ce merge
Colația ro_RO nu există în această bază de date. und-x-icu este colația ICU „nedefinită ca limbă”, care aplică regulile generale Unicode: literele cu diacritice sunt sortate lângă literele de bază, nu la final. Pe un server cu colația românească instalată, ai folosi ro-RO-x-icu pentru regulile exacte ale limbii române.
Cum o eviți pe viitor
- Creează o colație cu nume propriu (
romana) în migrări și folosește-o peste tot. - Preferă providerul ICU pentru ordonare lingvistică portabilă între sisteme de operare.
- Verifică pe serverul de producție ce colații există înainte să le folosești în cod.
- Ține minte că schimbarea colației unei coloane indexate reconstruiește indecșii.
Întrebări frecvente
De ce sortarea cu C pune Ștefan după Zoe?
Colația C compară codurile caracterelor, iar „Ș” are un cod mai mare decât toate literele latine de bază.
Merge LIKE cu o colație nedeterministă?
Doar din PostgreSQL 18. În versiunile mai vechi, LIKE pe coloane cu colații nedeterministe dă eroare.
Erori înrudite
ERROR: relation "produse" does not exist PostgreSQL nu găsește tabelul (sau view-ul, secvența) cu acest nume în schemele din search_path. Verifică dacă tabelul există, dacă ești conectat la baza de date corectă, dacă e într-o altă schemă și dacă a fost creat cu majuscule între ghilimele. ERROR: text search configuration "romana" does not exist Numele configurației de căutare full-text nu există. Configurațiile au nume în engleză: pentru română este 'romanian', nu 'romana' sau 'ro'. Verifică lista cu \dF în psql sau SELECT cfgname FROM pg_ts_config. ERROR: type "datetime" does not exist PostgreSQL nu are tipul datetime (din MySQL sau SQL Server). Pentru dată și oră folosești timestamptz (recomandat, cu fus orar) sau timestamp. Același mesaj apare pentru alte tipuri străine: nvarchar, tinyint, longtext. Î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.
