// PostgreSQL 错误参考

PostgreSQL 21000:子查询返回了多行

标量子查询在需要单个值的地方返回了多行。请添加筛选、聚合、LIMIT 1,或改用 IN 或联接。

SQLSTATE
21000
名称
cardinality_violation
类别
基数违规
错误信息
more than one row returned by a subquery used as an expression

它的意思

位于选择列表中的子查询,或位于比较(= (SELECT ...))中或在一个 SET 子句的子查询最多只能产生一行。PostgreSQL 要到运行时、当子查询返回第二行时才会发现,然后报错 21000(cardinality_violation).

相同的代码也被 ON CONFLICT DO UPDATE command cannot affect row a second time,当其中一个 INSERT 两次提出同一个键。

常见原因

  • 在非唯一列上进行的查找子查询,例如按姓名匹配客户。
  • 相关子查询缺少其连接条件的一部分。
  • 曾经唯一的数据现在不再唯一。
  • 一个 INSERT ... ON CONFLICT DO UPDATE 其输入包含重复键。

如何修复它

  1. 如果几个值中任选其一都可以,或者你希望确定性地选中其中一个,请显式地写出它。

    SELECT o.id,
           (SELECT c.email FROM contacts c
            WHERE c.customer_id = o.customer_id
            ORDER BY c.is_primary DESC, c.id
            LIMIT 1) AS email
    FROM orders o;
  2. 如果需要统计所有匹配的行,请使用 IN, ANY 或使用连接代替 =.

    SELECT * FROM orders WHERE customer_id IN (SELECT id FROM customers WHERE name = 'Ada');
  3. 找到返回多行的键。

    SELECT customer_id, count(*) FROM contacts GROUP BY customer_id HAVING count(*) > 1;
  4. 对于 ON CONFLICT,请先移除输入中的重复键。

    INSERT INTO prices (sku, price)
    SELECT DISTINCT ON (sku) sku, price FROM staging ORDER BY sku, updated_at DESC
    ON CONFLICT (sku) DO UPDATE SET price = EXCLUDED.price;

安全地复现它

SELECT (SELECT x FROM (VALUES (1), (2)) v(x));  -- ERROR: more than one row returned by a subquery used as an expression

相关错误

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

// 错误更少,修复更快

在 SQLly 中使用 PostgreSQL

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