// SQLite エラーリファレンス

SQLITE_CONSTRAINT: 制約に違反しました

INSERT または UPDATE が制約(UNIQUE、PRIMARY KEY、NOT NULL、CHECK、FOREIGN KEY)に違反しています。どの制約かは、メッセージと拡張コード名から分かります。

結果コード
SQLITE_CONSTRAINT
名前
19
カテゴリ
主な結果コード
エラーメッセージ
constraint failed

意味

SQLITE_CONSTRAINT (19) は、ステートメントがテーブルのルールの 1 つに違反するため、SQLite が停止したことを意味します。一般的なテキストは constraint failed、ただしメッセージには通常、ルールと列の名前が含まれます。たとえば UNIQUE constraint failed: users.email、拡張コードで種類がわかります: SQLITE_CONSTRAINT_UNIQUE, _PRIMARYKEY, _NOTNULL, _CHECK, _FOREIGNKEY, _DATATYPE (STRICT テーブル)または _TRIGGER ( RAISE() トリガーで)。

既定では、失敗したステートメントは取り消されます (conflict モード ABORT)ただし、同じトランザクション内の先行ステートメントは保持されます。

よくある原因

  • 主キーまたは一意の列での重複した値。
  • 次の中の NULL NOT NULL 列。多くの場合、INSERTでその列が省略され、デフォルト値もないためです。
  • 次に失敗する値 CHECK 式。
  • 親が存在しない子行、 PRAGMA foreign_keys = ON.
  • 次の中で型が合わない値 STRICT テーブル。

修正方法

  1. メッセージまたは拡張コードを読んでどの制約が失敗したかを確認し、テーブル定義を調べてください。

    SELECT sql FROM sqlite_schema WHERE name = 'users';
  2. マージまたはスキップしたい重複には、アップサートまたは競合句を使います。

    INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada')
    ON CONFLICT (email) DO UPDATE SET name = excluded.name;
  3. それ以外の制約については、書き込むデータを修正します。欠けている値を指定する、先に親行を挿入する、またはチェックに失敗する値を訂正します。

関連エラー

その他のプライマリ結果コードのエラー

コードとメッセージのテキストは、 SQLite の結果コードとエラーコードのドキュメント。全容は次で参照 SQLite エラーリスト または すべてのデータベースエラーを検索.

// エラーが減り、修正も速く

SQLly で SQLite を操作する

macOS、Windows、Linux 用のネイティブ SQL クライアント。スキーマを認識する IntelliSense、危険なステートメントへのガードレール、分かりやすいエラーメッセージを備え、SQLite をはじめ、お使いの他のデータベースにも対応します。