// Référence des erreurs PostgreSQL

PostgreSQL 23514 : violation de contrainte CHECK

Une ligne viole une contrainte CHECK sur la table ou le check d'un domaine, donc l'INSERT ou l'UPDATE a été rejeté.

SQLSTATE
23514
Nom
check_violation
Catégorie
Violation de contrainte d'intégrité
Message d'erreur
new row for relation "orders" violates check constraint "orders_qty_check"
DETAIL:  Failing row contains (12, -1).

Ce que cela signifie

A CHECK une contrainte est une condition que chaque ligne doit satisfaire, telle que qty > 0. 23514 signifie que la nouvelle ligne ou la ligne mise à jour a rendu la condition fausse. Une condition qui s'évalue à NULL est validée, donc les vérifications ne rejettent pas NULL les valeurs seules.

Le message indique le nom de la contrainte ; \d table_name dans psql ou pg_get_constraintdef affiche sa condition. Ajouter une contrainte CHECK à une table contenant déjà des lignes non conformes échoue de la même manière, avec check constraint ... of relation ... is violated by some row.

Causes courantes

  • Données en dehors de la plage ou de l'ensemble autorisé, par exemple une quantité négative ou un statut inconnu.
  • Validation de l'application qui diffère des règles de la base de données.
  • Ajouter une CHECK contrainte à une table qui a déjà des lignes la violant.
  • Un type de domaine avec un CHECK (value for domain ... violates check constraint).

Comment le corriger

  1. Lire la condition de la contrainte.

    SELECT conname, pg_get_constraintdef(oid)
    FROM pg_constraint
    WHERE conrelid = 'orders'::regclass AND contype = 'c';
  2. Corriger les données écrites afin qu'elles respectent la condition.

  3. Pour ajouter une vérification à une table contenant d'anciennes lignes invalides, ajoutez-la NOT VALID (appliquée uniquement pour les nouvelles lignes), nettoyer, puis valider.

    ALTER TABLE orders ADD CONSTRAINT orders_qty_check CHECK (qty > 0) NOT VALID;
    UPDATE orders SET qty = 1 WHERE qty <= 0;
    ALTER TABLE orders VALIDATE CONSTRAINT orders_qty_check;

Reproduisez-le en toute sécurité

CREATE TEMP TABLE o (qty int CHECK (qty > 0));
INSERT INTO o VALUES (-1);  -- ERROR: new row for relation "o" violates check constraint "o_qty_check"

Erreurs liées

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.

// moins d'erreurs, corrections plus rapides

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.