...
Eroare PostgreSQL · Constrângeri, chei și secvențe

ERROR: foreign key constraint "comenzi_client_id_fkey" cannot be implemented

Pe scurt

Coloana cheii străine și coloana referită au tipuri incompatibile, de exemplu text în tabelul copil și integer în părinte. DETAIL spune ambele tipuri. Folosește în tabelul copil exact tipul cheii referite (int cu int, bigint cu bigint, uuid cu uuid).

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

Ce înseamnă

O cheie străină compară valorile coloanei copil cu cele din coloana părinte folosind operatorul de egalitate al indexului unic. Dacă tipurile nu au un operator de egalitate compatibil cu acel index (text și integer, uuid și text), PostgreSQL nu poate verifica referința și dă această eroare, cu DETAIL: Key columns "client_id" and "id" are of incompatible types: text and integer.

Apare la scripturi scrise în grabă, la tabele de import transformate în tabele finale fără conversia tipurilor sau la migrări în care cheia primară a trecut la bigint/uuid, iar tabelele copil au rămas cu tipul vechi. Tipurile compatibile (de exemplu integer în copil și bigint în părinte) sunt acceptate, dar e bine să fie identice, ca JOIN-urile să folosească indecșii fără conversii.

De ce apare: cauzele frecvente

1Tip text pentru o cheie integer

Greșit
SQL
CREATE TABLE comenzi_noi (client_id text REFERENCES clienti(id));
Corect
SQL
CREATE TABLE comenzi_noi (client_id int REFERENCES clienti(id));

Coloana copil are același tip cu cheia părinte.

2Tabel copil rămas pe tipul vechi după migrare

Greșit
SQL
-- clienti.id e acum uuid
ALTER TABLE comenzi ADD FOREIGN KEY (client_id) REFERENCES clienti(id);  -- client_id int
Corect
SQL
ALTER TABLE comenzi ALTER COLUMN client_id TYPE uuid USING ...;
ALTER TABLE comenzi ADD FOREIGN KEY (client_id) REFERENCES clienti(id);

Coloanele copil se migrează împreună cu cheia primară.

Repară tu

Repară eroarea, direct în pagină

Tabelul recenzii a fost creat cu client_id text, iar cheia străină spre clienti(id) dă foreign key constraint "recenzii_client_id_fkey" cannot be implemented. Creează tabelul cu tipul corect pentru client_id, inserează recenzia clientului 1 și afișează numele clientului și nota.

Codul care dă eroarea
SQL
CREATE TABLE recenzii (id int PRIMARY KEY, client_id text REFERENCES clienti(id), nota int);
INSERT INTO recenzii VALUES (1, 1, 5);
SELECT c.nume, r.nota FROM recenzii r JOIN clienti c ON c.id = r.client_id;
După reparație, programul afișează
CREATE TABLE
INSERT 0 1
  nume   | nota
---------+------
 Ana Pop |    5
(1 rând)
Indiciu

clienti.id este integer.

Cum o eviți pe viitor

  • Folosește exact același tip pentru cheia străină și cheia referită.
  • Când schimbi tipul unei chei primare, planifică migrarea tuturor coloanelor care o referă.
  • Convertește tabelele de import în tipurile finale înainte să adaugi chei străine.
  • Verifică tipurile cu \d pe ambele tabele când apare eroarea.

Întrebări frecvente

integer referind bigint este acceptat?

Da, sunt compatibile, dar e preferabil același tip, ca să eviți conversii la JOIN și surprize când valorile cresc.

Pot converti valorile direct în definiția cheii?

Nu. Cheia străină se definește pe coloane, nu pe expresii; coloana trebuie să aibă tipul potrivit.

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.