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

ERROR: collation "ro_RO" for encoding "UTF8" does not exist

Pe scurt

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

Greșit
SQL
SELECT nume FROM clienti ORDER BY nume COLLATE "ro_RO";
Corect
SQL
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

Greșit
SQL
CREATE DATABASE magazin LC_COLLATE 'ro_RO.UTF-8';
Corect
SQL
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

Greșit
SQL
ORDER BY nume COLLATE "ro_RO"
Corect
SQL
CREATE COLLATION romana (provider = icu, locale = 'ro-RO');
... ORDER BY nume COLLATE romana

Un nume propriu rămâne același pe toate serverele.

Repară tu

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.

Codul care dă eroarea
SQL
SELECT nume FROM clienti ORDER BY nume COLLATE "ro_RO";
După reparație, programul afișează
  nume
--------
 Ana
 Sorin
 Ștefan
 Zoe
(4 rânduri)
Indiciu

Numele colației se scrie între ghilimele duble, exact cum apare în pg_collation.

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

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