// SQL Server 錯誤參考

SQL Server 錯誤 8178:參數化查詢需要參數

參數化查詢(sp_executesql)宣告了某個參數,但呼叫端沒有提供,通常是用戶端程式庫略過了 NULL 值。

錯誤號碼
8178
嚴重性
16
類別
名稱與物件
錯誤訊息
The parameterized query '%.*ls' expects the parameter '%.*ls', which was not supplied.

它的意義

客戶端程式庫透過 sp_executesql 送出參數化 SQL,並附上宣告的參數及其值清單。如果宣告的參數沒有值,SQL Server 會引發 8178。在 .NET 中,一個典型原因是將參數值設為 null,意思是「未提供」;資料庫的 NULL 必須是 DBNull.Value.

常見原因

  • 參數值為 null 而不是 DBNull.Value.
  • 在 SQL 文字中宣告、卻從未加進命令的參數。
  • SQL 裡的參數名稱與加入命令中的名稱不一致。

如何修正

  1. 傳遞 DBNull.Value 來表示 ADO.NET 中的 NULL,或者交給函式庫處理(例如 Dapper 會轉換 null 替你代勞)。

  2. 確保每個 @parameter 都有一個值,且名稱符合。

  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 資料庫引擎事件和錯誤參考。瀏覽完整的 SQL Server 錯誤清單 或 搜尋每個資料庫錯誤.

// 錯誤更少,修復更快

在 SQLly 裡操作 SQL Server

適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 SQL Server 和你使用的其他資料庫。