// PostgreSQL 錯誤參考

PostgreSQL 23514:違反 CHECK 條件約束

有一列未通過資料表上的 CHECK 約束,或未通過領域(domain)的檢查,INSERT 或 UPDATE 因此被拒絕。

SQLSTATE
23514
名稱
check_violation
類別
完整性約束違規
錯誤訊息
new row for relation "orders" violates check constraint "orders_qty_check"
DETAIL:  Failing row contains (12, -1).

它的意義

A CHECK 約束是每個資料列都必須滿足的條件,例如 qty > 0。23514 表示新增或更新的資料列讓條件不成立。若條件評估為 NULL 的條件通過,因此檢查不會單獨拒絕 NULL 值會單獨呈現。

訊息會列出條件約束的名稱; \d table_name 在 psql 或 pg_get_constraintdef 會顯示其條件。對已經有不良資料列的資料表新增 CHECK 條件約束時,也會以同樣方式失敗,並顯示 check constraint ... of relation ... is violated by some row.

常見原因

  • 超出允許範圍或集合的資料,例如負數數量或未知狀態。
  • 與資料庫規則不同的應用程式驗證。
  • 新增一個 CHECK 把約束加到已有資料列違反它的資料表上。
  • domain 類型帶有 CHECK (value for domain ... violates check constraint).

如何修正

  1. 閱讀條件約束的條件。

    SELECT conname, pg_get_constraintdef(oid)
    FROM pg_constraint
    WHERE conrelid = 'orders'::regclass AND contype = 'c';
  2. 修正正在寫入的資料,使其符合條件。

  3. 要為含有舊壞資料列的資料表新增檢查約束,請加上 NOT VALID (只對新資料列強制執行),先清理,再驗證。

    ALTER TABLE orders ADD CONSTRAINT orders_qty_check CHECK (qty > 0) NOT VALID;
    UPDATE orders SET qty = 1 WHERE qty <= 0;
    ALTER TABLE orders VALIDATE CONSTRAINT orders_qty_check;

安全地重現問題

CREATE TEMP TABLE o (qty int CHECK (qty > 0));
INSERT INTO o VALUES (-1);  -- ERROR: new row for relation "o" violates check constraint "o_qty_check"

相關錯誤

更多完整性條件約束違規錯誤

程式碼和訊息文字來自 PostgreSQL 文件,附錄 A:PostgreSQL 錯誤碼。瀏覽完整的 PostgreSQL 錯誤清單 或 搜尋每個資料庫錯誤.

// 錯誤更少,修復更快

在 SQLly 裡操作 PostgreSQL

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