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

ERROR: cannot use subquery in check constraint

Pe scurt

O constrângere CHECK poate folosi doar coloanele rândului curent, nu subinterogări în alte rânduri sau tabele. Pentru reguli care implică alte tabele, folosește o cheie străină; pentru unicitate condiționată, un index unic parțial; pentru reguli complexe, un trigger.

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

Ce înseamnă

PostgreSQL evaluează un CHECK doar când rândul respectiv este inserat sau modificat. O regulă care depinde de alte rânduri (de exemplu „clientul trebuie să fie activ” sau „maximum o adresă implicită pe client”) ar putea fi încălcată de modificări în celelalte tabele, fără ca CHECK să fie reevaluat. De aceea subinterogările sunt interzise, iar mesajul apare la CREATE TABLE sau ALTER TABLE.

Alternativele potrivite: o cheie străină pentru „valoarea trebuie să existe în alt tabel”; un index unic parțial pentru „cel mult un rând cu condiția X pe grup” (CREATE UNIQUE INDEX ON adrese (client_id) WHERE implicita); o constrângere EXCLUDE pentru suprapuneri; un trigger pentru reguli mai complexe, cu grijă la concurență (trigger-ul vede doar datele vizibile tranzacției lui). Ascunderea subinterogării într-o funcție nu rezolvă problema.

De ce apare: cauzele frecvente

1Valoare care trebuie să existe în alt tabel

Greșit
SQL
CREATE TABLE comenzi2 (client_id int CHECK (client_id IN (SELECT id FROM clienti)));
Corect
SQL
CREATE TABLE comenzi2 (client_id int REFERENCES clienti(id));

Cheia străină verifică existența în ambele direcții.

2O singură adresă implicită pe client

Greșit
SQL
ALTER TABLE adrese ADD CHECK ((SELECT count(*) FROM adrese a WHERE a.client_id = client_id AND implicita) <= 1);
Corect
SQL
CREATE UNIQUE INDEX adrese_o_implicita ON adrese (client_id) WHERE implicita;

Indexul unic parțial permite cel mult un rând implicita = true pe client.

Repară tu

Repară eroarea, direct în pagină

Tabelul adrese trebuie să permită cel mult o adresă implicită pe client. Constrângerea CHECK cu subinterogare dă cannot use subquery in check constraint. Înlocuiește-o cu un index unic parțial numit adrese_o_implicita și afișează numărul de adrese implicite ale clientului 1.

Codul care dă eroarea
SQL
ALTER TABLE adrese ADD CONSTRAINT o_implicita CHECK ((SELECT count(*) FROM adrese a WHERE a.client_id = client_id AND a.implicita) <= 1);
SELECT count(*) FROM adrese WHERE client_id = 1 AND implicita;
După reparație, programul afișează
CREATE INDEX
 count
-------
     1
(1 rând)
Indiciu

CREATE UNIQUE INDEX ... ON adrese (client_id) WHERE implicita

Cum o eviți pe viitor

  • Exprimă relațiile dintre tabele cu chei străine.
  • Folosește indecși unici parțiali pentru reguli de tip „cel mult unul pe grup”.
  • Nu ascunde subinterogări în funcții apelate din CHECK: regula nu va fi reevaluată când se schimbă celelalte tabele.
  • Pentru reguli cu adevărat complexe, folosește triggere testate și sub concurență.

Întrebări frecvente

De ce nu pot ascunde subinterogarea într-o funcție?

PostgreSQL te lasă, dar constrângerea nu va fi reevaluată când se schimbă celelalte rânduri, iar pg_dump poate restaura datele în altă ordine și poate eșua.

Ce este un index unic parțial?

Un index unic care conține doar rândurile ce respectă o condiție WHERE, deci unicitatea se aplică doar acelor rânduri.

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.