...
Eroare PostgreSQL · Roluri, drepturi, configurare și conexiuni

ERROR: extension "uuid-ossp" is not available

Pe scurt

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

Greșit
SQL
CREATE EXTENSION "uuid-ossp";
SELECT uuid_generate_v4();
Corect
SQL
SELECT gen_random_uuid();

Funcția încorporată nu cere extensii.

2Extensie neinstalată pe server

Greșit
SQL
CREATE EXTENSION postgis;
Corect
SQL
-- pe server (Debian/Ubuntu):
-- apt install postgresql-18-postgis-3
CREATE EXTENSION postgis;

Pachetul sistemului de operare aduce fișierele extensiei.

Repară tu

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.

Codul care dă eroarea
SQL
CREATE EXTENSION IF NOT EXISTS "uuid-ossp";
INSERT INTO sesiuni VALUES (uuid_generate_v4(), 'ana');
SELECT uuid_extract_version(token) AS versiune FROM sesiuni;
După reparație, programul afișează
INSERT 0 1
 versiune
----------
        4
(1 rând)
Indiciu

gen_random_uuid() și uuid_extract_version()

Alte forme ale mesajului

  • ERROR: extension "postgis" is not available
  • ERROR: could not open extension control file

Cum o eviți pe viitor

  • Verifică pg_available_extensions pe 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

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