sql server數據庫中raiserror函數的用法

server數據庫中raiserror的作用就和asp.NET中的throw new Exception一樣，用于拋出一個異常或錯誤。這個錯誤可以被程序捕捉到。

raiserror的常用格式如下：
raiserror('錯誤的描述',錯誤的嚴重級別代碼，錯誤的標識，錯誤的描述中的參數的值(這個可以是多個)，一些其它參數)，在官方上的格式描述如下：

RAISERROR ( { msg_id | msg_str | @local_variable } 
 { ,severity ,state } 
 [ ,argument [ ,...n ] ] ) 
 [ WITH option [ ,...n ] ] 

其中，[ ,argument [ ,...n ] ]與 [ WITH option [ ,...n ] 兩項是可以不寫的。

分別解釋一下各參數的用法：

一、{ msg_id | msg_str | @local_variable }

從這個參數中可以看出，這一項可能為三個值，
1,sys.messages中的自定義錯誤信息的錯誤信息號，自定義錯誤信息可以使用sp_addmessage存儲過程添加到sys.messages中，注意, 用戶定義錯誤消息的錯誤號應當大于 50000。
示例：raiserror(50001,16,1)
2,一條直接的錯誤描述，示例：raiserror('這里是錯誤描述的示例',16,1)
3,一個包含錯誤描述變量，示例:

declare @error_mes varchar(1000) 
set @error_mes='這里是錯誤描述的示例' 
raiserror(@error_mes,16,1) 

二、severity

這個參數為用戶定義的該錯誤信息的級別，我們可以指定 0 到 18 之間的嚴重級別。只有 sysadmin 固定服務器角色成員或具有 ALTER TRACE 權限的用戶才能指定 19 到 25 之間的嚴重級別。若要使用 19 到 25 之間的嚴重級別，必須選擇 WITH LOG 選項。

注意，如果錯誤級別在20~25之間，那么數據庫會認為這個錯誤是致命，那么數據庫會將該錯誤記錄到錯誤日志和應用程序日志后終止數據庫的連接。任何小于 0 的嚴重級別被認為等于0。大于 25 的嚴重級別被認為等于25。

三、state

這個參數是可以是1~127之間任意整數，可以用來標識錯誤的發生位置，如果一段代碼的多個位置都會發生同樣的錯誤，那么就可以將這個參數設置為不同的值，用來標識是那個位
置發生錯誤了。

四、[ ,argument [ ,...n ] ]

如果參數{ msg_id | msg_str | @local_variable }中包含了一些代替符，那么這個參數就是代替符的具體的值，這個和asp.Net中的string.Format用法是一樣的。示例如下:

declare @error_mes varchar(1000) 
set @error_mes='這里是用戶%s引發的錯誤描述' 
raiserror(@error_mes,16,1,'張三') 

也可以是這樣，可能適用性更廣些。

declare @error_mes varchar(1000) 
declare @error_obj varchar(1000) 
select @error_obj=name from table_users where…… 
set @error_mes='這里是用戶%s引發的錯誤描述' 
raiserror(@error_mes,16,1,@error_obj) 

上面代碼中的%s，代表它要替代是一個字符串，如果我們把示例寫成下面這樣就會報錯了：

declare @error_mes varchar(1000) 
set @error_mes='這里是用戶%s引發的錯誤描述' 
raiserror(@error_mes,16,1,1) 

因為1不是一個字符串，如果要替代是一個整數，就需要使用%i或者%d了。所有的對應關系如下：
1,%d或%i代表有符號整數
2,%u代表無符號整數
3,%o代表無符號八進制數
4,%s代表字符串
5,%x或%X代表 無符號十六進制數

五、[ WITH option [ ,...n ] ]

該參數為錯誤的自定義選項，可以是下面三個值中的一個：
1,LOG--在 Microsoft SQL Server 數據庫引擎 實例的錯誤日志和應用程序日志中記錄錯誤。記錄到錯誤日志的錯誤目前被限定為最多 440 字節。只有 sysadmin 固定服務器角色
成員或具有 ALTER TRACE 權限的用戶才能指定 WITH LOG。
2,NOWAIT--將消息立即發送給客戶端。
3,SETERROR--將 @@ERROR 值和 ERROR_NUMBER 值設置為 msg_id 或 50000，不用考慮嚴重級別。

我們還可以在Begin catch中使用raiserror。示例如下:

begin try 
 raiserror('這是一個錯誤',16,1) //注意，只有severity級別在11~19之間，控制才會跳轉到catch塊中。 
end try 
begin catch 
 declare @error_message varchar(1000) 
 set @error_message=error_message() 
 raiserror(@error_message,16,1) 
 return 
end catch 

到此這篇關于sql server數據庫中raiserror函數用法的詳細介紹的文章就介紹到這了,更多相關sql server中raiserror函數用法內容請搜索腳本之家以前的文章或繼續瀏覽下面的相關文章希望大家以后多多支持腳本之家！