...
Eroare PostgreSQL · Tabele, view-uri, indecși și partiții

ERROR: relation "clienti" already exists

Pe scurt

Încerci să creezi un tabel, view, index sau secvență cu un nume care există deja în schema respectivă. Fie scriptul rulează a doua oară, fie numele e ocupat de alt obiect (un index și un tabel nu pot avea același nume). Folosește CREATE ... IF NOT EXISTS sau alege alt nume.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Tabelele, view-urile, view-urile materializate, indecșii, secvențele și tipurile compuse împart același spațiu de nume în fiecare schemă (sunt toate „relații” în pg_class). Mesajul apare când creezi un obiect cu un nume deja folosit, chiar de un obiect de alt fel: un index numit comenzi intră în conflict cu tabelul comenzi.

Cel mai des, un script de inițializare rulează a doua oară. Pentru scripturi idempotente există CREATE TABLE IF NOT EXISTS, CREATE INDEX IF NOT EXISTS, CREATE OR REPLACE VIEW, care dau doar un NOTICE dacă obiectul există. Atenție: IF NOT EXISTS nu verifică dacă structura e aceeași; un tabel vechi cu alte coloane rămâne neschimbat. Pentru evoluția schemei, folosește un instrument de migrări (Flyway, Liquibase, Alembic), care ține evidența scripturilor aplicate.

De ce apare: cauzele frecvente

1Script rulat de două ori

Greșit
SQL
CREATE TABLE clienti (...);
Corect
SQL
CREATE TABLE IF NOT EXISTS clienti (...);

A doua rulare dă doar un NOTICE.

2Index cu numele unui tabel

Greșit
SQL
CREATE INDEX comenzi ON comenzi (client_id);
Corect
SQL
CREATE INDEX comenzi_client_id_idx ON comenzi (client_id);

Indecșii și tabelele împart același spațiu de nume.

Repară tu

Repară eroarea, direct în pagină

Scriptul de inițializare a bazei de date rulează la fiecare pornire a aplicației, iar a doua rulare dă relation "jurnal" already exists. Fă crearea tabelului idempotentă, apoi inserează un rând și afișează numărul de rânduri din jurnal.

Codul care dă eroarea
SQL
CREATE TABLE jurnal (id int GENERATED ALWAYS AS IDENTITY PRIMARY KEY, mesaj text);
INSERT INTO jurnal (mesaj) VALUES ('a doua pornire');
SELECT count(*) FROM jurnal;
După reparație, programul afișează
NOTICE:  relation "jurnal" already exists, skipping
CREATE TABLE
INSERT 0 1
 count
-------
     2
(1 rând)
Indiciu

CREATE TABLE IF NOT EXISTS

Alte forme ale mesajului

  • ERROR: relation "comenzi_client_id_idx" already exists

Cum o eviți pe viitor

  • Fă scripturile de inițializare idempotente cu IF NOT EXISTS sau CREATE OR REPLACE.
  • Folosește un instrument de migrări pentru schimbările de schemă.
  • Adoptă o convenție de nume pentru indecși (tabel_coloana_idx) și constrângeri.
  • Verifică existența cu to_regclass('nume') în scripturi condiționale.

Întrebări frecvente

IF NOT EXISTS verifică și coloanele?

Nu. Verifică doar numele. Un tabel existent cu altă structură rămâne așa.

Pot avea două tabele cu același nume?

Da, în scheme diferite (vanzari.clienti și public.clienti). search_path decide pe care îl găsești fără schemă.

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.