// справочник ошибок SQL Server

Ошибка SQL Server 8178: параметризованный запрос ожидает параметр

Параметризованный запрос (sp_executesql) объявляет параметр, который при вызове не передан, — обычно это NULL, который клиентская библиотека опустила.

Номер ошибки
8178
Уровень серьёзности
16
Категория
Имена и объекты
Сообщение об ошибке
The parameterized query '%.*ls' expects the parameter '%.*ls', which was not supplied.

Что это значит

Клиентские библиотеки отправляют параметризованный SQL через sp_executesql со списком объявленных параметров и их значений. Если у объявленного параметра нет значения, SQL Server выдаёт 8178. В .NET классическая причина — присвоить параметру значение null, что означает «не указано»; в базе данных NULL должен быть DBNull.Value.

Распространённые причины

  • Значение параметра null в ADO.NET вместо DBNull.Value.
  • Параметр, объявленный в SQL-тексте, но никогда не добавленный в команду.
  • Несоответствие между именами параметров в SQL и теми, которые добавлены в команду.

Как исправить

  1. Передайте DBNull.Value для NULL в ADO.NET или позвольте библиотеке сделать это (например, Dapper конвертирует null для вас).

  2. Убедитесь, что каждый @parameter в тексте SQL имеет значение, а имена совпадают.

  3. В T-SQL предоставьте значение для каждого объявленного параметра.

    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;

Связанные ошибки

Больше ошибок имён и объектов

Код и текст сообщения взяты из Справочник по событиям и ошибкам Microsoft Database Engine. Смотрите весь Список ошибок SQL Server или поиск по всем ошибкам баз данных.

// меньше ошибок, быстрее исправления

Работа с SQL Server в SQLly

Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для SQL Server и других баз данных, которые вы используете.