// Référence des erreurs PostgreSQL

PostgreSQL 21000 : plus d'une ligne renvoyée par une sous-requête

Une sous-requête scalaire, utilisée là où une seule valeur est attendue, a renvoyé plusieurs lignes. Ajoutez un filtre, un agrégat, LIMIT 1, ou utilisez IN ou une jointure.

SQLSTATE
21000
Nom
cardinality_violation
Catégorie
Violation de cardinalité
Message d'erreur
more than one row returned by a subquery used as an expression

Ce que cela signifie

Une sous-requête dans la liste de sélection, dans une comparaison (= (SELECT ...)) ou dans une SET clause doit produire au maximum une ligne. PostgreSQL ne s'en rend compte qu'au moment de l'exécution, lorsque la sous-requête renvoie une deuxième ligne, et échoue alors avec 21000 (cardinality_violation).

Le même code est utilisé par ON CONFLICT DO UPDATE command cannot affect row a second time, quand un INSERT propose la même clé deux fois.

Causes courantes

  • Une sous-requête de recherche sur une colonne qui n’est pas unique, par exemple rapprocher des clients par leur nom.
  • Une sous-requête corrélée à laquelle il manque une partie de sa condition de jointure.
  • Des données qui étaient uniques et ne le sont plus.
  • Une INSERT ... ON CONFLICT DO UPDATE dont l'entrée contient des clés en double.

Comment le corriger

  1. Si n'importe laquelle de plusieurs valeurs convient, ou si vous voulez l'une d'elles de manière déterministe, choisissez-la explicitement.

    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. Si toutes les lignes correspondantes comptent, utilisez IN, ANY ou une jointure au lieu de =.

    SELECT * FROM orders WHERE customer_id IN (SELECT id FROM customers WHERE name = 'Ada');
  3. Trouvez les clés qui renvoient plus d'une ligne.

    SELECT customer_id, count(*) FROM contacts GROUP BY customer_id HAVING count(*) > 1;
  4. Pour ON CONFLICT, supprimez d'abord les clés en double de l'entrée.

    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;

Reproduisez-le en toute sécurité

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

Erreurs liées

Le code et le texte du message sont issus de Documentation PostgreSQL, annexe A : Codes d’erreur PostgreSQL. Parcourir la liste complète Liste des erreurs PostgreSQL ou Rechercher toutes les erreurs de base de données.

// moins d'erreurs, corrections plus rapides

Travailler sur PostgreSQL dans SQLly

Un client SQL natif pour macOS, Windows et Linux avec IntelliSense conscient du schéma, des garde-fous pour les instructions risquées et des messages d'erreur clairs, pour PostgreSQL et les autres bases de données que vous utilisez.