// Referencia de errores de PostgreSQL

PostgreSQL 21000: más de una fila devuelta por una subconsulta

Una subconsulta escalar, utilizada donde se espera un único valor, devolvió varias filas. Añade un filtro, un agregado, LIMIT 1, o usa IN o un JOIN.

SQLSTATE
21000
Nombre
cardinality_violation
Categoría
Violación de cardinalidad
Mensaje de error
more than one row returned by a subquery used as an expression

Qué significa

Una subconsulta en la lista de selección, en una comparación (= (SELECT ...)) o en una SET cláusula debe producir como máximo una fila. PostgreSQL solo se entera en tiempo de ejecución, cuando la subconsulta devuelve una segunda fila, y entonces falla con 21000 (cardinality_violation).

El mismo código lo usa ON CONFLICT DO UPDATE command cannot affect row a second time, cuando uno INSERT propone la misma clave dos veces.

Causas comunes

  • Una subconsulta de búsqueda en una columna que no es única, como al emparejar clientes por nombre.
  • Una subconsulta correlacionada a la que le falta parte de su condición de unión.
  • Datos que antes eran únicos y ya no lo son.
  • Una INSERT ... ON CONFLICT DO UPDATE cuya entrada contiene claves duplicadas.

Cómo solucionarlo

  1. Si cualquiera de varios valores sirve, o quieres uno de ellos de manera determinista, selecciónalo explícitamente.

    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 quieres contar todas las filas coincidentes, usa IN, ANY o una unión en lugar de =.

    SELECT * FROM orders WHERE customer_id IN (SELECT id FROM customers WHERE name = 'Ada');
  3. Encuentra las claves que devuelven más de una fila.

    SELECT customer_id, count(*) FROM contacts GROUP BY customer_id HAVING count(*) > 1;
  4. Para ON CONFLICT, elimina primero las claves duplicadas de la entrada.

    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;

Reprodúcelo de forma segura

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

Errores relacionados

El código y el texto del mensaje son de documentación de PostgreSQL, Apéndice A: Códigos de error de PostgreSQL. Explora la lista completa de Lista de errores de PostgreSQL o buscar cada error de base de datos.

// menos errores, correcciones más rápidas

Trabajar con PostgreSQL en SQLly

Un cliente SQL nativo para macOS, Windows y Linux con IntelliSense que conoce el esquema, protecciones para las instrucciones de riesgo y mensajes de error claros, para PostgreSQL y las demás bases de datos que uses.