...
Eroare SQL · CREATE TABLE, ALTER TABLE și tranzacții

Cannot add a REFERENCES column with non-NULL default value

Pe scurt

Cu cheile străine activate (PRAGMA foreign_keys = ON), ALTER TABLE ADD COLUMN nu poate adăuga o coloană cu REFERENCES și DEFAULT diferit de NULL, fiindcă nu poate verifica valoarea în rândurile existente. Adaug-o cu DEFAULT NULL, apoi completeaz-o cu UPDATE.

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

Ce înseamnă

Când adaugi o coloană cu ALTER TABLE ... ADD COLUMN, SQLite nu rescrie rândurile existente: ele „văd” automat valoarea din DEFAULT. Dacă noua coloană e o cheie străină (REFERENCES clienti(id)) și cheile străine sunt active, valoarea implicită ar trebui verificată pentru fiecare rând existent. SQLite nu face această verificare la ALTER TABLE, așa că refuză orice DEFAULT diferit de NULL.

NULL e permis pentru că o cheie străină NULL nu face referire la nimic, deci nu încalcă legătura.

Soluția are doi pași: adaugi coloana fără default (sau cu DEFAULT NULL), apoi o completezi cu un UPDATE, care e verificat normal de cheia străină. Pe tabele goale SQLite acceptă și default-ul, de aceea eroarea apare abia pe baza cu date.

De ce apare: cauzele frecvente

1Default pentru o coloană nouă cu cheie străină

Greșit
SQL
PRAGMA foreign_keys = ON;
ALTER TABLE comenzi
ADD COLUMN depozit_id INTEGER REFERENCES depozite(id) DEFAULT 1;
Corect
SQL
PRAGMA foreign_keys = ON;
ALTER TABLE comenzi
ADD COLUMN depozit_id INTEGER REFERENCES depozite(id);
UPDATE comenzi SET depozit_id = 1;

Coloana se adaugă cu NULL, iar UPDATE-ul pune valoarea și e verificat de cheia străină.

2Default adăugat ca să evite NOT NULL

Greșit
SQL
ALTER TABLE comenzi
ADD COLUMN client_id INTEGER NOT NULL DEFAULT 0
REFERENCES clienti(id);
Corect
SQL
ALTER TABLE comenzi
ADD COLUMN client_id INTEGER REFERENCES clienti(id);
UPDATE comenzi SET client_id = 1 WHERE client_id IS NULL;

0 nu există în clienti, deci ar fi încălcat oricum cheia străină. Dacă ai nevoie de NOT NULL, recreează tabelul după ce completezi datele.

Repară tu

Repară eroarea, direct în pagină

Comenzile trebuie legate de depozitul din care pleacă. Scriptul activează cheile străine și adaugă coloana depozit_id cu DEFAULT 1, dar dă Cannot add a REFERENCES column with non-NULL default value. Repară-l ca toate comenzile existente să primească depozitul 1 și afișează id și depozit_id, ordonat după id.

Codul care dă eroarea
SQL
PRAGMA foreign_keys = ON;
ALTER TABLE comenzi
ADD COLUMN depozit_id INTEGER REFERENCES depozite(id) DEFAULT 1;
SELECT id, depozit_id FROM comenzi ORDER BY id;
După reparație, programul afișează
id | depozit_id
10 | 1
11 | 1
12 | 1
Indiciu

Adaugă coloana fără default, apoi completeaz-o cu UPDATE.

Alte forme ale mesajului

  • sqlite3.OperationalError: Cannot add a REFERENCES column with non-NULL default value

Cum o eviți pe viitor

Când adaugi o cheie străină unui tabel cu date, fă-o în doi pași: coloana fără default, apoi UPDATE. Verifică după aceea cu PRAGMA foreign_key_check; că toate valorile au corespondent. Pentru coloane care trebuie să fie și NOT NULL, folosește procedura de recreare a tabelului.

Întrebări frecvente

De ce fără PRAGMA foreign_keys merge?

Cu cheile străine dezactivate (implicit în SQLite), REFERENCES nu e verificat deloc, așa că default-ul e acceptat. Dar asta înseamnă că nici legătura nu e păzită.

Pot activa cheile străine după ALTER TABLE?

Da, dar nu ocoli problema așa: rândurile cu valori fără corespondent vor da FOREIGN KEY constraint failed la următoarele modificări.

Erori înrudite

← Toate erorile SQL

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ță SQL de la zero, cu exerciții la fiecare lecție

Curs SQL: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.