// 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 ADO.NETのNULL用、またはライブラリに任せます(たとえば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 エラー一覧 または すべてのデータベースエラーを検索.

// エラーが減り、修正も速く

SQLly で SQL Server を操作する

macOS、Windows、Linux 用のネイティブ SQL クライアント。スキーマを認識する IntelliSense、危険なステートメントへのガードレール、分かりやすいエラーメッセージを備え、SQL Server をはじめ、お使いの他のデータベースにも対応します。