// SQLite 錯誤參考

SQLITE_MISMATCH:資料類型不符合

SQLite 對類型嚴格的少數情況之一:通常是將 rowid 或 INTEGER PRIMARY KEY 欄位設定為非整數的值。

結果代碼
SQLITE_MISMATCH
名稱
20
類別
主要結果代碼
錯誤訊息
datatype mismatch

它的意義

SQLite 通常允許你在任何欄位儲存任何值。 SQLITE_MISMATCH (20) 只在少數情況下回傳,即 SQLite 堅持要求型別時。SQLite 文件特別點出的是 rowid:資料表的 rowid,以及宣告為 INTEGER PRIMARY KEY (也就是它的別名)必須存放整數。把它設成文字,例如 'abc' 或非整數的實數會失敗,並出現 datatype mismatch;允許 NULL,會自動挑選下一個可用的整數。

類型錯誤在 STRICT 資料表的回報方式不同,會顯示為 SQLITE_CONSTRAINT_DATATYPE.

常見原因

  • 將 UUID 字串之類的非整數值插入到 INTEGER PRIMARY KEY 欄位。
  • 更新中 rowid 到文字值。
  • 從另一個資料庫遷移結構描述,其 id 欄位原本是文字,卻將它宣告為 INTEGER PRIMARY KEY 在 SQLite 中。

如何修正

  1. 插入整數(或使用 NULL 讓 SQLite 自動分配)到 INTEGER PRIMARY KEY 欄位。

    INSERT INTO users (id, name) VALUES (NULL, 'Ada');
  2. 如果索引鍵確實是文字,請改為將其宣告為文字主鍵。

    CREATE TABLE users (
        id   TEXT PRIMARY KEY,
        name TEXT NOT NULL
    );

安全地重現問題

CREATE TABLE t (id INTEGER PRIMARY KEY);
INSERT INTO t VALUES ('abc');   -- Runtime error: datatype mismatch (20)

相關錯誤

更多主要結果碼錯誤

程式碼和訊息文字來自 SQLite 結果代碼與錯誤碼文件。瀏覽完整的 SQLite 錯誤清單 或 搜尋每個資料庫錯誤.

// 錯誤更少,修復更快

在 SQLly 裡操作 SQLite

適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 SQLite 和你使用的其他資料庫。