// PostgreSQL 错误参考

PostgreSQL 23514:检查约束冲突

某行未通过表或域上的 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 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 PostgreSQL 以及你使用的其他数据库。