// Referência de erro do MySQL

Erro do MySQL 1242: A subconsulta retorna mais de 1 linha

Uma subconsulta usada como um único valor, por exemplo após = ou na lista de seleção, retornou várias linhas.

Número do erro
1242
Nome
ER_SUBQUERY_NO_1_ROW
SQLSTATE
21000
Categoria
Sintaxe e instruções
Mensagem de erro
Subquery returns more than 1 row

O que significa

Uma subconsulta escalar deve retornar no máximo uma linha. Se retornar mais, o MySQL não consegue transformá-la em um único valor e gera o erro 1242. A consulta pode ter funcionado por meses e falhar agora porque os dados mudaram.

Causas comuns

  • Comparando com = para uma subconsulta que pode corresponder a várias linhas.
  • Uma subconsulta de busca na lista de seleção, sobre uma coluna que não é única.
  • Linhas duplicadas que não estavam presentes quando a consulta foi escrita.

Como corrigir

  1. Use IN (ou EXISTS) quando várias linhas são válidas.

    SELECT * FROM orders WHERE customer_id IN (SELECT id FROM customers WHERE country = 'NL');
  2. Ou reduza a subconsulta para uma linha com um agregado ou LIMIT 1 e uma ordem definida.

    SELECT o.id,
           (SELECT p.amount FROM payments p WHERE p.order_id = o.id ORDER BY p.paid_at DESC LIMIT 1) AS last_payment
    FROM orders o;

Erros relacionados

Mais erros de sintaxe e instruções

O código e o texto da mensagem são de Referência de mensagens de erro do MySQL 8.4. Veja toda a Lista de erros do MySQL ou pesquise todos os erros do banco de dados.

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

Trabalhe com MySQL 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 MySQL e os outros bancos de dados que você usa.