Handling SQL Server ErrorsBy Bill Graziano on 5 April 2010 | Tags: Stored Procedures , SQL Server 2005 , Transactions , SQL Server 2008 Features , Error Handling This article covers the basics of TRY CATCH error handling in T-SQL introduced in SQL Server 2005. It includes the usage of common functions to return information about the error and using the TRY CATCH block in stored procedures and transactions. SQL Server uses the following syntax to capture errors in Transact-SQL statements: BEGIN TRY SELECT [First] = 1 SELECT [Second] = 1/0 SELECT [Third] = 3 END TRY BEGIN CATCH PRINT 'An error occurred' END CATCH This returns the following output: First ----------- 1 (1 row(s) affected) Second ----------- (0 row(s) affected) An error occurred A key difference from SQL Server 2000 is that execution is halted when SQL Server encounters an error. At that point execution transfers to the CATCH block. This error isn't returned to the client application or calling program. The TRY CATCH block consumes the error. Error FunctionsInside the CATCH block there are a number of specialized functions to return information about the error. BEGIN TRY SELECT [Second] = 1/0 END TRY BEGIN CATCH SELECT [Error_Line] = ERROR_LINE(), [Error_Number] = ERROR_NUMBER(), [Error_Severity] = ERROR_SEVERITY(), [Error_State] = ERROR_STATE() SELECT [Error_Message] = ERROR_MESSAGE() END CATCH Second ----------- (0 row(s) affected) Error_Line Error_Number Error_Severity Error_State ----------- ------------ -------------- ----------- 2 8134 16 1 (1 row(s) affected) Error_Message --------------------------------------------------- Divide by zero error encountered. (1 row(s) affected) These are the functions you can use inside a CATCH block. These functions all return NULL if they are called from outside a CATCH block.
Trapping Errors in Stored ProceduresA TRY CATCH block can catch errors in stored procedures called by other stored procedures. An example is: BEGIN TRY EXEC ParentError END TRY BEGIN CATCH SELECT Error_Line = ERROR_LINE(), Error_Proc = ERROR_PROCEDURE() END CATCH Assuming that the ParentError stored procedure calls the ChildError stored procedure which generates an error you'd see output like this:
Error_Line Error_Proc
----------- -------------
5 ChildError
Error Handling and TransactionsThe TRY CATCH syntax also works well with transactions. Below is a common pattern used inside stored procedures for transactions. Any errors cause the transaction to roll back. BEGIN TRY BEGIN TRANSACTION INSERT INTO dbo.invoice_header (invoice_number, client_number) VALUES (2367, 19) INSERT INTO dbo.invoice_detail (invoice_number, line_number, part_number) VALUES (2367, 1, 84367) COMMIT TRANSACTION END TRY BEGIN CATCH IF @@TRANCOUNT() > 0 ROLLBACK TRANSACTION -- And do some cool error handling END CATCH
|
- Advertisement - |