// 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 提議同一個鍵兩次。

常見原因

  • 針對非唯一欄位的查閱子查詢,例如依名稱比對客戶。
  • 相關子查詢缺少部分的 join 條件。
  • 原本唯一的資料,現在不再唯一。
  • 一個 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 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 PostgreSQL 和你使用的其他資料庫。