// SQLite 錯誤參考
SQLITE_CONSTRAINT:約束失敗
某個 INSERT 或 UPDATE 違反了約束:UNIQUE、PRIMARY KEY、NOT NULL、CHECK 或 FOREIGN KEY。訊息和延伸錯誤碼會指出是哪一個。
- 結果代碼
SQLITE_CONSTRAINT- 名稱
19- 類別
- 主要結果代碼
它的意義
SQLITE_CONSTRAINT (19) 表示某個語句會違反資料表的某條規則,所以 SQLite 中止了它。通用文字是 constraint failed,但訊息通常會點名規則和欄位,例如 UNIQUE constraint failed: users.email,而延伸錯誤碼會告訴你錯誤的種類: SQLITE_CONSTRAINT_UNIQUE, _PRIMARYKEY, _NOTNULL, _CHECK, _FOREIGNKEY, _DATATYPE (STRICT 資料表)或 _TRIGGER (觸發程序中的 RAISE() 在觸發器中)。
預設情況下,失敗的陳述式會被復原(衝突模式 ABORT),但同一交易中較早的陳述式會保留。
常見原因
- 主鍵或唯一欄位的重複值。
- 一個 NULL 出現在
NOT NULL欄位,通常是因為 INSERT 漏了該欄位,而它又沒有預設值。 - 值不符合
CHECK運算式。 - 找不到父資料列的子資料列,附帶
PRAGMA foreign_keys = ON. - 型別錯誤的值出現在
STRICT表中。
如何修正
-
閱讀訊息或延伸錯誤碼,確認是哪個條件約束失敗,再看資料表定義。
SELECT sql FROM sqlite_schema WHERE name = 'users';
-
對於希望合併或跳過的重複項,使用 upsert 或 conflict 子句。
INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada') ON CONFLICT (email) DO UPDATE SET name = excluded.name; -
至於其他條件約束,請修正你要寫入的資料:補上缺少的值、先插入父資料列,或改正未通過檢查的值。
相關錯誤
SQLITE_CONSTRAINT_UNIQUE唯一約束失敗SQLITE_CONSTRAINT_PRIMARYKEY主鍵條件約束失敗SQLITE_CONSTRAINT_NOTNULLNOT NULL 條件約束失敗SQLITE_CONSTRAINT_CHECKCHECK 條件約束失敗SQLITE_CONSTRAINT_FOREIGNKEY外鍵約束失敗SQLITE_CONSTRAINT_DATATYPE值不符合 STRICT 欄位的要求
更多主要結果碼錯誤
SQLITE_ERRORSQL 邏輯錯誤SQLITE_PERM存取權限遭拒SQLITE_ABORT查詢已中止SQLITE_BUSY資料庫已鎖定SQLITE_LOCKED資料庫資料表已鎖定SQLITE_NOMEM記憶體不足SQLITE_READONLY嘗試寫入唯讀資料庫SQLITE_INTERRUPT已中斷
程式碼和訊息文字來自 SQLite 結果代碼與錯誤碼文件。瀏覽完整的 SQLite 錯誤清單 或 搜尋每個資料庫錯誤.
// 錯誤更少,修復更快
在 SQLly 裡操作 SQLite
適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 SQLite 和你使用的其他資料庫。