// Referência de erro do SQL Server

Erro do SQL Server 8178: Consulta parametrizada espera um parâmetro

Uma consulta parametrizada (sp_executesql) declara um parâmetro que a chamada não forneceu, geralmente um valor NULL que a biblioteca do cliente deixou de enviar.

Número do erro
8178
Gravidade
16
Categoria
Nomes e objetos
Mensagem de erro
The parameterized query '%.*ls' expects the parameter '%.*ls', which was not supplied.

O que significa

Bibliotecas cliente enviam SQL parametrizado através de sp_executesql com uma lista de parâmetros declarados e seus valores. Se um parâmetro declarado não tiver valor, o SQL Server gera o erro 8178. No .NET, uma causa clássica é definir o valor de um parâmetro como null, o que significa «não fornecido»; um NULL de banco de dados deve ser DBNull.Value.

Causas comuns

  • Um valor de parâmetro de null no ADO.NET em vez de DBNull.Value.
  • Um parâmetro declarado no texto SQL, mas nunca adicionado ao comando.
  • Uma incompatibilidade entre os nomes dos parâmetros no SQL e os que foram adicionados ao comando.

Como corrigir

  1. Passe DBNull.Value para NULLs no ADO.NET, ou deixe a biblioteca fazer isso (por exemplo, o Dapper converte null para você).

  2. Certifique-se de que cada @parameter no texto SQL tenha um valor, com nomes correspondentes.

  3. No T-SQL, forneça todos os parâmetros declarados.

    EXEC sys.sp_executesql
        N'SELECT * FROM dbo.Orders WHERE CustomerId = @c AND Status = @s',
        N'@c int, @s varchar(20)',
        @c = 42, @s = NULL;

Erros relacionados

Mais erros de nomes e objetos

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.