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

PostgreSQL 23514: CHECK 制約違反

行がテーブルの CHECK 制約またはドメインのチェックに違反したため、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 constraint ... of relation ... is violated by some row.

よくある原因

  • 許可された範囲または集合の外にあるデータ (たとえば負の数量や未知のステータス)。
  • データベースのルールとは異なる、アプリケーション側のバリデーション。
  • 次を追加すると CHECK すでに制約に違反する行があるテーブルに制約を追加すること。
  • 次の制約を持つドメイン型 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. 不正な行が既にあるテーブルに CHECK 制約を追加するには、 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 をはじめ、お使いの他のデータベースにも対応します。