// Referência de erro do SQL Server

Erro do SQL Server 512: Subconsulta retornou mais de 1 valor

Uma subconsulta usada como um valor único (após =, <, > ou no SET) retornou várias linhas. Faça-a retornar uma linha, ou use IN, EXISTS ou um join.

Número do erro
512
Gravidade
16
Categoria
Conversão e truncamento de dados
Mensagem de erro
Subquery returned more than 1 value. This is not permitted when the subquery follows =, !=, <, <= , >, >= or when the subquery is used as an expression.

O que significa

Uma subconsulta em um local que espera um valor, como WHERE x = (SELECT ...), SET @v = (SELECT ...) ou uma coluna na lista de seleção, deve retornar no máximo uma linha. Se retornar duas ou mais no tempo de execução, o SQL Server gera o erro 512. A consulta pode funcionar por meses e então falhar quando os dados contêm um duplicado.

Causas comuns

  • O filtro da subconsulta não é único, por exemplo, ao procurar um cliente pelo nome quando dois clientes compartilham o mesmo nome.
  • Um gatilho escrito para alterações de uma única linha que faz SELECT @id = (SELECT id FROM inserted), falhando em inserções ou atualizações de várias linhas.
  • Linhas duplicadas em uma tabela de pesquisa que deveria ser única.

Como corrigir

  1. Se qualquer linha correspondente servir, use IN ou EXISTS em vez de =.

    SELECT * FROM dbo.Orders
    WHERE CustomerId IN (SELECT CustomerId FROM dbo.Customers WHERE Country = 'NL');
  2. Se você precisa de exatamente um valor, especifique qual com TOP (1) e ORDER BY, ou um agregado.

    SELECT @lastOrder = (SELECT TOP (1) OrderId FROM dbo.Orders WHERE CustomerId = @c ORDER BY OrderDate DESC);
  3. Reescreva os gatilhos para funcionar no todo inserted conjunto com uma junção.

    UPDATE c SET c.LastOrderAt = i.OrderDate
    FROM dbo.Customers AS c
    JOIN inserted AS i ON i.CustomerId = c.CustomerId;
  4. Encontre as duplicatas que quebraram a premissa e adicione uma restrição de unicidade se a coluna deve ser única.

    SELECT Name, COUNT(*) FROM dbo.Customers GROUP BY Name HAVING COUNT(*) > 1;

Reproduza com segurança

SELECT (SELECT v FROM (VALUES (1), (2)) AS t(v));  -- Msg 512

Erros relacionados

Mais erros de conversão de dados e truncamento

O código e o texto da mensagem são de Referência de eventos e erros do Microsoft Database Engine. Veja toda a Lista de erros do SQL Server ou pesquise todos os erros do banco de dados.

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

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