// SQL Server 錯誤參考
SQL Server 錯誤 8178:參數化查詢需要參數
參數化查詢(sp_executesql)宣告了某個參數,但呼叫端沒有提供,通常是用戶端程式庫略過了 NULL 值。
- 錯誤號碼
8178- 嚴重性
- 16
- 類別
- 名稱與物件
它的意義
客戶端程式庫透過 sp_executesql 送出參數化 SQL,並附上宣告的參數及其值清單。如果宣告的參數沒有值,SQL Server 會引發 8178。在 .NET 中,一個典型原因是將參數值設為 null,意思是「未提供」;資料庫的 NULL 必須是 DBNull.Value.
常見原因
- 參數值為
null而不是DBNull.Value. - 在 SQL 文字中宣告、卻從未加進命令的參數。
- SQL 裡的參數名稱與加入命令中的名稱不一致。
如何修正
-
傳遞
DBNull.Value來表示 ADO.NET 中的 NULL,或者交給函式庫處理(例如 Dapper 會轉換null替你代勞)。 -
確保每個
@parameter都有一個值,且名稱符合。 -
在 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;
相關錯誤
更多名稱和物件錯誤
208無效的物件名稱207無效的欄位名稱4104多重部分識別碼未繫結209欄位名稱不明確2812找不到預存程序2714已經有名稱為3701無法刪除,找不到物件3702無法刪除資料庫,目前正在使用中
程式碼和訊息文字來自 Microsoft 資料庫引擎事件和錯誤參考。瀏覽完整的 SQL Server 錯誤清單 或 搜尋每個資料庫錯誤.
// 錯誤更少,修復更快
在 SQLly 裡操作 SQL Server
適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 SQL Server 和你使用的其他資料庫。