// PostgreSQL 错误参考

PostgreSQL 42830:无效的外键

外键指向的列,没有被引用表上的主键或唯一约束覆盖。

SQLSTATE
42830
名称
invalid_foreign_key
类别
语法错误或访问规则违规
错误信息
there is no unique constraint matching given keys for referenced table "customers"

它的意思

外键必须引用父表中保证唯一的列,依据是其主键或 UNIQUE 约束(或没有谓词的唯一索引)必须正好在这些列上。否则 PostgreSQL 无法判断子行引用的是哪个父行,创建外键会以 42830 错误失败。

各列必须作为一个集合来匹配: (tenant_id, id) 不允许外键引用 id 保持原样。

常见原因

  • 被引用的列根本没有主键或唯一约束。
  • 外键引用的列是唯一约束所含列的子集或超集。
  • 父表上的唯一索引是部分索引(有一个 WHERE 子句),它不能作为外键的目标。

如何修复它

  1. 在被引用的列上添加主键或唯一约束,然后再创建外键。

    ALTER TABLE customers ADD CONSTRAINT customers_email_key UNIQUE (email);
    ALTER TABLE orders ADD FOREIGN KEY (customer_email) REFERENCES customers (email);
  2. 或者使用相同的列列表引用现有的键。

    ALTER TABLE orders
        ADD FOREIGN KEY (tenant_id, customer_id) REFERENCES customers (tenant_id, id);

安全地复现它

CREATE TEMP TABLE p (id int);
CREATE TEMP TABLE c (p_id int REFERENCES p (id));  -- ERROR: there is no unique constraint matching given keys for referenced table "p"

相关错误

更多语法错误或访问规则违例错误

代码和消息文本来自 PostgreSQL 文档,附录 A:PostgreSQL 错误代码。浏览完整的 PostgreSQL 错误列表 或者 搜索每个数据库错误.

// 错误更少,修复更快

在 SQLly 中使用 PostgreSQL

适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 PostgreSQL 以及你使用的其他数据库。