// Référence des erreurs SQLite

SQLITE_CONSTRAINT : échec de contrainte

Une instruction INSERT ou UPDATE a enfreint une contrainte : UNIQUE, PRIMARY KEY, NOT NULL, CHECK ou FOREIGN KEY. Le message et le code étendu indiquent laquelle.

Code de résultat
SQLITE_CONSTRAINT
Nom
19
Catégorie
Codes de résultat principaux
Message d'erreur
constraint failed

Ce que cela signifie

SQLITE_CONSTRAINT (19) signifie qu'une instruction aurait enfreint l'une des règles de la table, donc SQLite l'a arrêtée. Le texte générique est constraint failed, mais le message nomme habituellement la règle et la colonne, comme UNIQUE constraint failed: users.email, et le code étendu vous indique le type : SQLITE_CONSTRAINT_UNIQUE, _PRIMARYKEY, _NOTNULL, _CHECK, _FOREIGNKEY, _DATATYPE (tables STRICT) ou _TRIGGER (un RAISE() dans un déclencheur).

Par défaut, l’instruction en échec est annulée (mode de conflit ABORT) mais les instructions précédentes dans la même transaction sont conservées.

Causes courantes

  • Une valeur en double dans une clé primaire ou une colonne unique.
  • Un NULL dans une colonne NOT NULL , souvent parce que l'insertion a laissé la colonne vide et qu'elle n'a pas de valeur par défaut.
  • Une valeur qui échoue à une CHECK expression.
  • Une ligne enfant dont le parent n'existe pas, avec PRAGMA foreign_keys = ON.
  • Une valeur d'un type incorrect dans une STRICT table.

Comment le corriger

  1. Lisez le message ou le code étendu pour voir quelle contrainte a échoué, puis consultez la définition de la table.

    SELECT sql FROM sqlite_schema WHERE name = 'users';
  2. Pour les doublons que vous voulez fusionner ou ignorer, utilisez un upsert ou une clause de conflit.

    INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada')
    ON CONFLICT (email) DO UPDATE SET name = excluded.name;
  3. Pour les autres contraintes, corrigez les données que vous écrivez : fournissez la valeur manquante, insérez d'abord la ligne parent, ou corrigez la valeur qui échoue au contrôle.

Erreurs liées

Plus d'erreurs de codes de résultat principaux

Le code et le texte du message sont issus de documentation des codes de résultat et d'erreur SQLite. Parcourir la liste complète Liste des erreurs SQLite ou Rechercher toutes les erreurs de base de données.

// moins d'erreurs, corrections plus rapides

Travailler sur SQLite 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 SQLite et les autres bases de données que vous utilisez.