// PostgreSQL 错误参考

PostgreSQL 42P10:无效的列引用

最常见的情况是 ON CONFLICT 目标没有匹配的唯一索引,或者在 SELECT DISTINCT 中对未选中的列使用 ORDER BY。

SQLSTATE
42P10
名称
invalid_column_reference
类别
语法错误或访问规则违规
错误信息
there is no unique or exclusion constraint matching the ON CONFLICT specification

它的意思

42P10 (invalid_column_reference)会在列列表以该语句不允许的方式引用列时引发。人们最常碰到的两种情况:

INSERT ... ON CONFLICT (cols) 需要正好在这些列上建立唯一索引或约束(或排除约束),这样 PostgreSQL 才知道什么算冲突。而配合 SELECT DISTINCT,每个 ORDER BY 表达式必须出现在 select 列表中: for SELECT DISTINCT, ORDER BY expressions must appear in select list.

常见原因

  • ON CONFLICT (email) 在没有唯一索引的表上 email,或者建有唯一索引,位于 lower(email) 或另一组不同的列。
  • 部分唯一索引,它 ON CONFLICT 仅在语句重复其 WHERE 谓词。
  • SELECT DISTINCT a FROM t ORDER BY b.

如何修复它

  1. 创建用于定义冲突的唯一索引,或指定与现有索引匹配的冲突目标。

    CREATE UNIQUE INDEX users_email_key ON users (email);
    INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada')
    ON CONFLICT (email) DO UPDATE SET name = EXCLUDED.name;
  2. 对于表达式或部分索引,在冲突目标中重复表达式或谓词。

    CREATE UNIQUE INDEX users_email_lower_key ON users (lower(email));
    INSERT INTO users (email) VALUES ('[email protected]')
    ON CONFLICT ((lower(email))) DO NOTHING;
  3. 开启 DISTINCT,选择你排序的内容,或使用 DISTINCT ON.

    SELECT DISTINCT customer_id, created_at FROM orders ORDER BY created_at;
    -- or one row per customer, newest first:
    SELECT DISTINCT ON (customer_id) customer_id, created_at
    FROM orders ORDER BY customer_id, created_at DESC;

安全地复现它

CREATE TEMP TABLE u (email text);
INSERT INTO u VALUES ('a') ON CONFLICT (email) DO NOTHING;  -- ERROR: there is no unique or exclusion constraint matching the ON CONFLICT specification

相关错误

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

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

// 错误更少,修复更快

在 SQLly 中使用 PostgreSQL

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