ERROR: extension "uuid-ossp" is not available
Fișierele extensiei nu sunt instalate pe serverul PostgreSQL, deci CREATE EXTENSION nu o găsește. Instalează pachetul sistemului de operare (de exemplu postgresql-contrib sau postgis), verifică lista cu SELECT name FROM pg_available_extensions sau folosește o alternativă încorporată.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
CREATE EXTENSION încarcă în baza de date o extensie ale cărei fișiere (control, SQL, biblioteci) trebuie să existe deja pe server. Dacă lipsesc, apare această eroare (în versiunile mai vechi, could not open extension control file), cu HINT: The extension must first be installed on the system where PostgreSQL is running. Pe servicii gestionate (RDS, Cloud SQL, Azure), doar extensiile din lista furnizorului sunt disponibile.
Lista celor instalate pe server: SELECT name, default_version FROM pg_available_extensions. Pentru multe nevoi există alternative încorporate: gen_random_uuid() (din PostgreSQL 13) și uuidv7() (din 18) înlocuiesc extensia uuid-ossp; full-text search acoperă multe cazuri pentru care se instala pg_trgm. Pentru extensii reale (PostGIS, pgvector, TimescaleDB), instalezi pachetul pe server sau alegi un serviciu care le oferă.
De ce apare: cauzele frecvente
1uuid-ossp pentru generarea de UUID-uri
CREATE EXTENSION "uuid-ossp";
SELECT uuid_generate_v4();SELECT gen_random_uuid();Funcția încorporată nu cere extensii.
2Extensie neinstalată pe server
CREATE EXTENSION postgis;-- pe server (Debian/Ubuntu):
-- apt install postgresql-18-postgis-3
CREATE EXTENSION postgis;Pachetul sistemului de operare aduce fișierele extensiei.
Repară eroarea, direct în pagină
Scriptul de inițializare activează extensia uuid-ossp ca să genereze tokenuri, dar serverul nu o are instalată, iar CREATE EXTENSION dă extension "uuid-ossp" is not available. Renunță la extensie, folosește funcția încorporată pentru UUID-uri și afișează versiunea UUID-ului generat.
CREATE EXTENSION IF NOT EXISTS "uuid-ossp";
INSERT INTO sesiuni VALUES (uuid_generate_v4(), 'ana');
SELECT uuid_extract_version(token) AS versiune FROM sesiuni;INSERT 0 1
versiune
----------
4
(1 rând)Indiciu
gen_random_uuid() și uuid_extract_version()
Reparația
INSERT INTO sesiuni VALUES (gen_random_uuid(), 'ana');
SELECT uuid_extract_version(token) AS versiune FROM sesiuni;De ce merge
Din PostgreSQL 13, gen_random_uuid() este încorporată, deci nu mai e nevoie de extensia uuid-ossp pentru UUID-uri aleatoare. Tokenul generat este un UUID versiunea 4, confirmat de uuid_extract_version (disponibilă din PostgreSQL 17). Pentru UUID-uri ordonate în timp, PostgreSQL 18 are uuidv7().
Alte forme ale mesajului
ERROR: extension "postgis" is not availableERROR: could not open extension control file
Cum o eviți pe viitor
- Verifică
pg_available_extensionspe fiecare mediu (dezvoltare, test, producție) înainte să folosești o extensie. - Preferă funcțiile încorporate când acoperă nevoia (
gen_random_uuid,uuidv7). - Documentează extensiile necesare în README-ul proiectului și în scripturile de provizionare.
- Pe servicii gestionate, consultă lista de extensii suportate înainte de alegerea serviciului.
Întrebări frecvente
Ce diferență e între pg_available_extensions și pg_extension?
pg_available_extensions arată ce poate fi instalat pe server; pg_extension arată ce e deja creat în baza curentă.
Cine poate rula CREATE EXTENSION?
Superuserii, iar pentru extensiile marcate „trusted” și proprietarii bazei de date.
Erori înrudite
ERROR: function datediff(date, date) does not exist datediff este o funcție din MySQL și SQL Server; PostgreSQL nu o are. Diferența în zile dintre două date se calculează direct cu minus (data2 - data1 dă un integer), iar pentru ani și luni folosești age(). La fel, ifnull devine coalesce, iar now() și current_date rămân la fel. ERROR: invalid input syntax for type uuid: "123" Valoarea trimisă într-o coloană uuid nu are formatul de UUID (32 de cifre hexazecimale, de obicei grupate 8-4-4-4-12). Apare când aplicația trimite un id numeric, un text gol sau un id cu caractere în plus. Verifică valoarea și generează UUID-uri cu gen_random_uuid() sau uuidv7(). ERROR: permission denied for schema vanzari Rolul nu are dreptul USAGE pe schemă, deci nu poate accesa niciun obiect din ea, chiar dacă are drepturi pe tabele. La crearea de obiecte, lipsește dreptul CREATE. Acordă GRANT USAGE ON SCHEMA (și CREATE, dacă e nevoie), apoi drepturile pe tabele. Î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.
