// PostgreSQL エラーリファレンス

PostgreSQL 21000: サブクエリが複数の行を返しました

単一の値が想定される場所で使われたスカラーサブクエリが、複数の行を返しました。フィルター、集計、LIMIT 1 を追加するか、IN または結合を使ってください。

SQLSTATE
21000
名前
cardinality_violation
カテゴリ
カーディナリティ違反
エラーメッセージ
more than one row returned by a subquery used as an expression

意味

選択リスト内、比較内のサブクエリ(= (SELECT ...))、または SET 句は最大1行しか生成してはいけません。PostgreSQLは実行時になって初めて、サブクエリが2行目を返したときにそれを検出し、21000で失敗します(cardinality_violation).

同じコードが次で使われています ON CONFLICT DO UPDATE command cannot affect row a second time、1 つが INSERT 同じキーを 2 回提案します。

よくある原因

  • 名前で顧客を照合するなど、一意でない列に対するルックアップサブクエリ。
  • 結合条件の一部が欠けている相関サブクエリ。
  • かつては一意だったが、今はそうでなくなったデータ。
  • ある INSERT ... ON CONFLICT DO UPDATE 入力に重複キーが含まれるもの。

修正方法

  1. 複数の値のうちどれでもよい場合、またはそのうちの 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 をはじめ、お使いの他のデータベースにも対応します。