// Referência de erro do PostgreSQL

PostgreSQL 21000: mais de uma linha retornada por uma subconsulta

Uma subconsulta escalar, usada onde se espera um único valor, retornou várias linhas. Adicione um filtro, uma agregação, LIMIT 1, ou use IN ou um join.

SQLSTATE
21000
Nome
cardinality_violation
Categoria
Violação de cardinalidade
Mensagem de erro
more than one row returned by a subquery used as an expression

O que significa

Uma subconsulta na lista de seleção, em uma comparação (= (SELECT ...)) ou em uma SET cláusula deve produzir no máximo uma linha. O PostgreSQL só descobre isso em tempo de execução, quando a subconsulta retorna uma segunda linha, e então falha com 21000 (cardinality_violation).

O mesmo código é usado por ON CONFLICT DO UPDATE command cannot affect row a second time, quando um INSERT propõe a mesma chave duas vezes.

Causas comuns

  • Uma subconsulta de busca em uma coluna que não é única, como casar clientes pelo nome.
  • Uma subconsulta correlacionada sem parte da condição de junção.
  • Dados que antes eram únicos e não são mais.
  • Uma INSERT ... ON CONFLICT DO UPDATE cuja entrada contém chaves duplicadas.

Como corrigir

  1. Se qualquer um de vários valores for aceitável, ou você quiser um deles de forma determinística, escolha-o explicitamente.

    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. Se o que conta são todas as linhas correspondentes, use IN, ANY ou uma junção em vez de =.

    SELECT * FROM orders WHERE customer_id IN (SELECT id FROM customers WHERE name = 'Ada');
  3. Encontre as chaves que retornam mais de uma linha.

    SELECT customer_id, count(*) FROM contacts GROUP BY customer_id HAVING count(*) > 1;
  4. Para ON CONFLICT, remova primeiro as chaves duplicadas da 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;

Reproduza com segurança

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

Erros relacionados

O código e o texto da mensagem são de documentação do PostgreSQL, Apêndice A: Códigos de erro do PostgreSQL. Veja toda a Lista de erros do PostgreSQL ou pesquise todos os erros do banco de dados.

// menos erros, correções mais rápidas

Trabalhe com PostgreSQL no SQLly

Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o PostgreSQL e os outros bancos de dados que você usa.