// PostgreSQL 錯誤參考
PostgreSQL 21000:子查詢傳回了多筆資料列
純量子查詢在需要單一值的地方傳回了多列。請加上篩選條件、彙總函式或 LIMIT 1,否則改用 IN 或聯結。
- SQLSTATE
21000- 名稱
cardinality_violation- 類別
- 基數違規
它的意義
選取清單中的子查詢,或出現在比較 (= (SELECT ...))或在一個 SET 子句最多只能產生一列資料。PostgreSQL 要到執行階段、子查詢傳回第二列時才會發現,然後以 21000 失敗(cardinality_violation).
相同的代碼也被 ON CONFLICT DO UPDATE command cannot affect row a second time,當其中一個 INSERT 提議同一個鍵兩次。
常見原因
- 針對非唯一欄位的查閱子查詢,例如依名稱比對客戶。
- 相關子查詢缺少部分的 join 條件。
- 原本唯一的資料,現在不再唯一。
- 一個
INSERT ... ON CONFLICT DO UPDATE其輸入包含重複鍵。
如何修正
-
如果多個值中任何一個都行,或你想以可預期的方式選定其中一個,請明確指定。
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; -
如果所有符合的資料列都要計入,請使用
IN,ANY或以聯結代替=.SELECT * FROM orders WHERE customer_id IN (SELECT id FROM customers WHERE name = 'Ada');
-
找出會傳回多筆資料列的鍵。
SELECT customer_id, count(*) FROM contacts GROUP BY customer_id HAVING count(*) > 1;
-
對於
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
相關錯誤
42803欄位必須出現在 GROUP BY 子句中23505重複鍵違反唯一約束512SQL Server:子查詢傳回超過 1 個值1242MySQL:子查詢傳回超過 1 列ORA-01427Oracle:單列子查詢傳回了多筆資料列
程式碼和訊息文字來自 PostgreSQL 文件,附錄 A:PostgreSQL 錯誤碼。瀏覽完整的 PostgreSQL 錯誤清單 或 搜尋每個資料庫錯誤.
// 錯誤更少,修復更快
在 SQLly 裡操作 PostgreSQL
適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 PostgreSQL 和你使用的其他資料庫。