SQL Server 異常代碼處理

SQL Server使用TRY...CATCH 結構實現TSQL語句的錯誤處理，TRY命令負責監控語句執行的狀況，若是有TSQL語句發生異常，而且嚴重級別（Severity Level）大於10，而且小於20，那麼CATCH命令會捕獲到異常的錯誤。

BEGIN TRY  
     { sql_statement | statement_block }  
END TRY  
BEGIN CATCH  
     [ { sql_statement | statement_block } ]  
END CATCH  

數據庫開發工程師須要把一條或多條語句寫入到TRY代碼塊中，若是TRY代碼塊中的代碼在執行過程當中發生錯誤，那麼在錯誤發生的點以後的代碼再也不執行，程序的控制權轉移到CATCH代碼塊塊中。若是TRY代碼塊沒有發生錯誤，那麼不會執行CATCH代碼塊，程序的控制權轉移到END CATCH以後的語句。

注意，在CATCH代碼塊中捕獲的異常不會返回給調用程序，若是須要把錯誤消息返回給調用程序，須要在CATCH代碼塊中使用THROW（或RAISERROR，不推薦使用）命令顯式拋出錯誤。

一，獲取異常消息

在TSQL中，使用TRY和 CATCH編寫異常處理代碼塊，在CATCH子句中，使用如下函數，可以獲取異常發生時的信息。

--返回發生錯誤的代碼行號（LineNumber）
ERROR_LINE ( ) 
--返回錯誤號（ErrorNumber）
ERROR_NUMBER ( ) 
@@ERROR 
--返回錯誤消息（ErrorMessage）
ERROR_MESSAGE ( ) 
--返回發生錯誤的SP Name
ERROR_PROCEDURE ( ) 
--返回錯誤的嚴重度（Error Severity）
ERROR_SEVERITY ( ) 
--返回錯誤的狀態（Error State）
ERROR_STATE()

SQL Server拋出的一個錯誤，一般包括錯誤代碼（Error Number）、嚴重級別（Severity Level）、錯誤狀態（Error State）和錯誤消息（Error Message）等信息。

1，錯誤代碼

錯誤代碼，能夠由變量@@ERROR 和函數ERROR_NUMBER()得到，用於返回上一條語句的錯誤代碼，該代碼惟一標識該錯誤。

2，錯誤的嚴重級別

錯誤的嚴重程序（Severity Level）共有24個級別，代表SQL Sever遇到問題的類型，Severity Level是一個int類型，能夠由函數ERROR_SEVERITY() 返回，數值越大，說明問題越嚴重。

按照錯誤對系統的影響程序，把嚴重級別分爲四組：

• 0-10：信息，能夠認爲是warning
• 11-16：錯誤，是用戶代碼致使的
• 17-19：很是嚴重的錯誤，只能由系統管理員來修復
• 20-24：致命的錯誤，可能致使整個系統沒法正常使用

從17-19，錯誤不能被用戶修正，只能由系統管理員來修復問題。

從20-24，這個級別的錯誤遇到的狀況比較少，一旦遇到，那麼基本上代表整個數據庫系統遇到了很是嚴重的錯誤：

3，錯誤狀態

錯誤狀態（Error State）是用戶自定義的編碼，用於使開發者可以輕易識別引發異常的確切位置。

4，錯誤消息

錯誤消息，是關於錯誤的描述性文本，能夠是SQL Server系統預約義的錯誤信息，也能夠是THROW命令拋出的用戶自定義的文本。

二，拋出異常消息

在SQL Server 2012及以後的版本中，使用 Throw 關鍵字代替RAISERROR，用於拋出異常，並將執行控制權轉移到Catch 代碼塊。

THROW [error_number, error_message, error_state];

參數註釋：

• error_number：錯誤代碼，是一個int類型，數值必須大於5000，小於 2147483647，這是用戶自定義的錯誤代碼。
• error_message：錯誤消息，類型是nvarchar(2048)
• state：跟錯誤相關聯的一個state，類型是tinyint，取值範圍是：0-255

注意：在THROW語句以前的語句，必須以分號; 結尾。

當THROW語句用於拋出自定義的異常時，severty level 經常被設置爲默認的16；當THROW用於re-throw，此時THROW 沒有任何參數，處於CATCH代碼塊中，僅僅用於把CATCH捕獲的異常從新拋出，severty level，state，錯誤消息跟原始異常相同。

例子1，拋出自定義的異常：

BEGIN TRY  
    SELECT 1/0
END TRY  
BEGIN CATCH  
    ;THROW 51000, 'Divide by zero error encountered', 1;   
END CATCH; 

SQL Server拋出的異常消息是，自定義的錯誤代碼是51000，嚴重級別（Severity Level）是16，錯誤狀態是1，錯誤行是5：

Msg 51000, Level 16, State 1, Line 5
Divide by zero error encountered

例子2，重拋異常，把系統檢測到的錯誤從Catch代碼塊中拋出：

BEGIN TRY  
    SELECT 1/0
END TRY  
BEGIN CATCH  
    ;THROW;   
END CATCH; 

SQL Server拋出的異常消息是，錯誤代碼是8134，嚴重級別（Severity Level）是16，錯誤狀態是1，錯誤行是2：

Msg 8134, Level 16, State 1, Line 2
Divide by zero error encountered.

三，不受TRY...CATCH結構影響的錯誤

TRY...CATCH 只捕獲嚴重級別從11到19的錯誤，不會捕獲嚴重級別是1-10，20-24的錯誤。

若是session會系統管理員使用KILL命令殺掉，那麼TRY...CATCH結構不會捕獲。

四，在事務中處理異常

若是在TRY代碼塊生成的錯誤，致使當前事務的狀態變成無效，那麼該事務就是不可提交的事務（uncommittable transaction）。一個不可提交的事務，只能執行read操做，或者回滾（ROLLBACK TRANSACTION），不能執行TSQL語句來執行寫操做，該事務也不能提交。函數XACT_STATE() 返回-1表示，當前的事務是不可提交的事務；返回1表示當前的事務是能夠提交的。數據庫開發人員須要經過XACT_STATE() 來對事務執行提交或回滾的操做。

例如，在事務中處理異常，能夠參考如下代碼，在實際應用程序，能夠把異常信息記錄在數據表中，便於進行故障排除：

-- SET XACT_ABORT ON will render the transaction uncommittable when the constraint violation occurs.
SET XACT_ABORT ON;  
  
BEGIN TRY  
    BEGIN TRANSACTION;  
        -- A FOREIGN KEY constraint exists on this table. This statement will generate a constraint violation error.
        DELETE FROM Production.Product  
        WHERE ProductID = 980;  
    -- If the delete operation succeeds, commit the transaction. The CATCH block will not execute.
    COMMIT TRANSACTION;  
END TRY  
BEGIN CATCH  
    -- Test XACT_STATE for 0, 1, or -1.  
    -- If 1, the transaction is committable.  
    -- If -1, the transaction is uncommittable and should be rolled back.
    -- XACT_STATE = 0 means there is no transaction and a commit or rollback operation would generate an error.
  
    -- Test whether the transaction is uncommittable.
    IF (XACT_STATE()) = -1  
    BEGIN  
        --Logging Exception info, as the transaction is in an uncommittable state. Rolling back transaction.
        SELECT  
            ERROR_NUMBER() AS ErrorNumber,  
            ERROR_SEVERITY() AS ErrorSeverity,  
            ERROR_STATE() AS ErrorState,  
            ERROR_PROCEDURE() AS ErrorProcedure,  
            ERROR_LINE() AS ErrorLine,  
            ERROR_MESSAGE() AS ErrorMessage;   
        ROLLBACK TRANSACTION;  
    END;  
    -- Test whether the transaction is active and valid.  
    IF (XACT_STATE()) = 1  
    BEGIN  
        --'The transaction is committable. Committing transaction.'  
        COMMIT TRANSACTION;     
    END;  
END CATCH;

 

參考文檔：