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

SQLITE_CONSTRAINT_UNIQUE: UNIQUE 制約に違反しました

INSERT または UPDATE で、UNIQUE 列または一意インデックスの値が重複します。メッセージにはテーブル名と列名が示されます。

結果コード
SQLITE_CONSTRAINT_UNIQUE
名前
2067
カテゴリ
拡張結果コード
エラーメッセージ
UNIQUE constraint failed: users.email

意味

SQLite は次を返します SQLITE_CONSTRAINT_UNIQUE (2067) は、書き込みによって同じ値を持つ 2 行が 1 つの UNIQUE 制約またはユニークインデックス。メッセージには次のように列が一覧表示されます table.column、複数列のキーの場合はカンマ区切り。主キーの重複は次で報告されます SQLITE_CONSTRAINT_PRIMARYKEY ただし同じメッセージテキストを使います。

NULL は重複としてカウントされません。ユニークな列には NULL をいくつでも含めることができます。

よくある原因

  • すでに存在する行を挿入する(たとえばインポートの再実行)。
  • 大文字と小文字だけが異なる 2 つの値(次のように宣言された列) COLLATE NOCASE.
  • ある UPDATE 列を、別の行がすでに持つ値に設定するもの。

修正方法

  1. 既存の行を見つけます。

    SELECT * FROM users WHERE email = '[email protected]';
  2. 代わりにアップサート(SQLite 3.24 以降)で既存の行を更新します。

    INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada')
    ON CONFLICT (email) DO UPDATE SET name = excluded.name;
  3. または、意図的に重複をスキップします。

    INSERT OR IGNORE INTO users (email, name) VALUES ('[email protected]', 'Ada');

安全に再現する

CREATE TABLE users (email TEXT UNIQUE);
INSERT INTO users VALUES ('a@x');
INSERT INTO users VALUES ('a@x');  -- Runtime error: UNIQUE constraint failed: users.email (19)

質問

INSERT OR REPLACE とアップサートの違いは何ですか?

INSERT OR REPLACE 競合する行を削除して新しい行を挿入するため、指定しなかった列はリセットされ、削除トリガーや外部キーのアクションが発火することがあります。アップサート ON CONFLICT DO UPDATE 既存の行をその場で変更します。

関連エラー

その他の拡張結果コードのエラー

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

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

SQLly で SQLite を操作する

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