// Referencia de errores de SQL Server

Error 8178 de SQL Server: la consulta parametrizada espera un parámetro

Una consulta parametrizada (sp_executesql) declara un parámetro que la llamada no ha suministrado, normalmente un valor NULL que la librería cliente omitió.

Número de error
8178
Gravedad
16
Categoría
Nombres y objetos
Mensaje de error
The parameterized query '%.*ls' expects the parameter '%.*ls', which was not supplied.

Qué significa

Las bibliotecas cliente envían SQL parametrizado a través de sp_executesql con una lista de parámetros declarados y sus valores. Si un parámetro declarado no tiene valor, SQL Server genera el error 8178. En .NET, una causa clásica es establecer el valor de un parámetro a null, lo que significa "no suministrado"; un NULL de base de datos debe ser DBNull.Value.

Causas comunes

  • Un valor de parámetro de null en ADO.NET en lugar de DBNull.Value.
  • Un parámetro declarado en el texto SQL pero nunca añadido al comando.
  • Una discrepancia entre los nombres de los parámetros del SQL y los añadidos al comando.

Cómo solucionarlo

  1. Correcto DBNull.Value para NULLs en ADO.NET, o deja que la biblioteca lo haga (por ejemplo, Dapper convierte null por ti).

  2. Asegúrate de que cada @parameter en el texto SQL tenga un valor, con nombres que coincidan.

  3. En T-SQL, indica todos los 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;

Errores relacionados

Más errores de nombres y objetos

El código y el texto del mensaje son de Referencia de eventos y errores del motor de base de datos de Microsoft. Explora la lista completa de Lista de errores de SQL Server o buscar cada error de base de datos.

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

Trabajar con SQL Server 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 SQL Server y las demás bases de datos que uses.