// PostgreSQL-Fehlerreferenz

PostgreSQL 21000: Unterabfrage hat mehr als eine Zeile zurückgegeben

Füge einen Filter, eine Aggregatfunktion oder LIMIT 1 hinzu, oder verwende IN oder einen Join.

SQLSTATE
21000
Name
cardinality_violation
Kategorie
Kardinalitätsverletzung
Fehlermeldung
more than one row returned by a subquery used as an expression

Was es bedeutet

Eine Unterabfrage in der Select-Liste, in einem Vergleich (= (SELECT ...)) oder in einer SET Klausel darf höchstens eine Zeile erzeugen. PostgreSQL stellt dies erst zur Laufzeit fest, wenn die Unterabfrage eine zweite Zeile zurückgibt, und schlägt dann mit 21000 fehl (cardinality_violation).

Derselbe Code wird verwendet von ON CONFLICT DO UPDATE command cannot affect row a second time, wenn ein INSERT denselben Schlüssel zweimal vorschlägt.

Häufige Ursachen

  • Eine Nachschlage-Unterabfrage auf einer Spalte, die nicht eindeutig ist, wie z. B. das Abgleichen von Kunden nach Namen.
  • Eine korrelierte Unterabfrage, der ein Teil ihrer Join-Bedingung fehlt.
  • Daten, die früher eindeutig waren und es jetzt nicht mehr sind.
  • Eine INSERT ... ON CONFLICT DO UPDATE deren Eingabe doppelte Schlüssel enthält.

Wie du es behebst

  1. Wenn einer von mehreren Werten ausreicht oder du einen davon deterministisch willst, wähle ihn explizit aus.

    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. Wenn alle passenden Zeilen zählen, verwende IN, ANY oder einen Join anstelle von =.

    SELECT * FROM orders WHERE customer_id IN (SELECT id FROM customers WHERE name = 'Ada');
  3. Finde die Schlüssel, die mehr als eine Zeile zurückgeben.

    SELECT customer_id, count(*) FROM contacts GROUP BY customer_id HAVING count(*) > 1;
  4. Für ON CONFLICT, entferne zuerst doppelte Schlüssel aus der Eingabe.

    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;

Sicher reproduzieren

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

Zugehörige Fehler

Der Code und der Meldungstext stammen aus der PostgreSQL-Dokumentation, Anhang A: PostgreSQL-Fehlercodes. Durchstöbere die vollständige PostgreSQL-Fehlerliste oder Jeden Datenbankfehler durchsuchen.

// weniger Fehler, schnellere Korrekturen

Arbeiten mit PostgreSQL in SQLly

Ein nativer SQL-Client für macOS, Windows und Linux mit schemabewusstem IntelliSense, Guardrails für riskante Anweisungen und klaren Fehlermeldungen, für PostgreSQL und die anderen Datenbanken, mit denen du arbeitest.