PostgreSQL 23502 : la valeur nulle enfreint la contrainte NOT NULL
Un INSERT ou UPDATE a laissé une colonne NOT NULL vide, souvent parce que la colonne a été omise et n'a pas de valeur par défaut.
- SQLSTATE
23502- Nom
not_null_violation- Catégorie
- Violation de contrainte d'intégrité
Ce que cela signifie
A NOT NULL la colonne doit avoir une valeur dans chaque ligne. 23502 signifie que la ligne nouvelle ou mise à jour avait NULL là, soit explicitement, soit parce que la colonne a été omise dans un INSERT et sa valeur par défaut est NULL.
Le DETAIL la ligne montre la ligne en échec entière. PostgreSQL 13 et suivants nomment la table dans le message ; les versions antérieures indiquent seulement null value in column "email" violates not-null constraint.
Causes courantes
- Le
INSERTne liste pas la colonne et la colonne n'a pas deDEFAULT. - L'application a envoyé
NULL, par exemple un champ non défini ou une recherche échouée. INSERT ... SELECTou unUPDATEavec une sous-requête qui n'a retourné aucune ligne, produisantNULL.- Une colonne ajoutée avec
NOT NULLque le code existant ne connaît pas.
Comment le corriger
-
Fournissez la valeur, ou donnez à la colonne une valeur par défaut.
INSERT INTO users (id, name, email) VALUES (7, 'Ada', '[email protected]'); ALTER TABLE users ALTER COLUMN created_at SET DEFAULT now();
-
Utilisez
COALESCElorsqu'une recherche ou une expression peut retournerNULL.UPDATE orders o SET region = COALESCE((SELECT region FROM customers c WHERE c.id = o.customer_id), 'unknown');
-
Si la colonne doit autoriser les valeurs manquantes, supprimez la contrainte.
ALTER TABLE users ALTER COLUMN phone DROP NOT NULL;
Reproduisez-le en toute sécurité
CREATE TEMP TABLE u (id int, email text NOT NULL); INSERT INTO u (id) VALUES (1); -- ERROR: null value in column "email" of relation "u" violates not-null constraint
Erreurs liées
23505une clé dupliquée viole la contrainte unique23503violation de contrainte de clé étrangère23514violation de contrainte CHECK515SQL Server : Impossible d'insérer la valeur NULL dans la colonne1048MySQL : La colonne ne peut pas être nulle1364MySQL : Le champ n'a pas de valeur par défautORA-01400Oracle : impossible d'insérer NULL dans la colonneSQLITE_CONSTRAINT_NOTNULLSQLite : échec de la contrainte NOT NULL
Plus d'erreurs de violation de contrainte d'intégrité
Le code et le texte du message sont issus de Documentation PostgreSQL, annexe A : Codes d’erreur PostgreSQL. Parcourir la liste complète Liste des erreurs PostgreSQL ou Rechercher toutes les erreurs de base de données.
Travailler sur PostgreSQL dans SQLly
Un client SQL natif pour macOS, Windows et Linux avec IntelliSense conscient du schéma, des garde-fous pour les instructions risquées et des messages d'erreur clairs, pour PostgreSQL et les autres bases de données que vous utilisez.