ERROR_PROCEDURE (Transact-SQL)ERROR_PROCEDURE (Transact-SQL)

Dieses Thema gilt für: JaSQL Server (ab 2008)JaAzure SQL-DatenbankJaAzure SQL Data Warehouse Ja Parallel Datawarehouse THIS TOPIC APPLIES TO: yesSQL Server (starting with 2008)yesAzure SQL DatabaseyesAzure SQL Data Warehouse yesParallel Data Warehouse

Gibt den Namen der gespeicherten Prozedur oder des Triggers zurück, an der bzw. an dem ein Fehler aufgetreten ist, durch den die Ausführung des CATCH-Blocks eines TRY…CATCH-Konstrukts verursacht wurde.Returns the name of the stored procedure or trigger where an error occurred that caused the CATCH block of a TRY…CATCH construct to be run.

Themenlinksymbol Transact-SQL Syntax Conventions (Transact-SQL-Syntaxkonventionen)Topic link icon Transact-SQL Syntax Conventions

SyntaxSyntax

ERROR_PROCEDURE ( )  

RückgabetypenReturn Types

nvarchar(128)nvarchar(128)

RückgabewertReturn Value

Gibt beim Aufruf in einem CATCH-Block den Namen der gespeicherten Prozedur zurück, in der der Fehler aufgetreten ist.When called in a CATCH block, returns the stored procedure name where the error occurred.

Gibt NULL zurück, wenn der Fehler nicht in einer gespeicherten Prozedur bzw. nicht in einem Trigger aufgetreten ist.Returns NULL if the error did not occur within a stored procedure or trigger.

Gibt NULL zurück, wenn die Funktion außerhalb des Bereichs eines CATCH-Blockes aufgerufen wird.Returns NULL if called outside the scope of a CATCH block.

RemarksRemarks

ERROR_PROCEDURE kann innerhalb des Bereichs eines CATCH-Blocks an beliebigen Stellen aufgerufen werden.ERROR_PROCEDURE may be called anywhere within the scope of a CATCH block.

ERROR_PROCEDURE gibt den Namen der gespeicherten Prozedur bzw. des Triggers zurück, in der bzw. in dem der Fehler aufgetreten ist, unabhängig davon, wie oft die Funktion aufgerufen wurde bzw. wo sie innerhalb des Bereichs des CATCH-Blocks aufgerufen wurde.ERROR_PROCEDURE returns the name of the stored procedure or trigger where the error occurred, regardless of the number of times it is called or where it is called within the scope of the CATCH block. Dies steht im Gegensatz zu Funktionen wie @@ERROR, die die Fehlernummer in der Anweisung sofort (gefolgt von der Nummer, die den Fehler verursacht hat) oder in der ersten Anweisung des CATCH-Blocks zurückgeben.This contrasts with functions, such as @@ERROR, which return the error number in the statement immediately following the one that caused the error or in the first statement of the CATCH block.

In geschachtelten CATCH-Blöcken gibt ERROR_PROCEDURE den Namen der gespeicherten Prozedur oder des Triggers im Bereich des CATCH-Blocks zurück, in dem auf die gespeicherte Prozedur bzw. auf den Trigger verwiesen wird.In nested CATCH blocks, ERROR_PROCEDURE returns the name of the stored procedure or trigger specific to the scope of the CATCH block in which it is referenced. Der CATCH-Block eines TRY…CATCH-Konstrukts kann beispielsweise ein geschachteltes TRY…CATCH-Konstrukt enthalten.For example, the CATCH block of a TRY…CATCH construct could have a nested TRY…CATCH. Innerhalb des geschachtelten CATCH-Blocks gibt ERROR_PROCEDURE den Namen der gespeicherten Prozedur oder des Triggers zurück, in der bzw. in dem der Fehler aufgetreten ist, mit dem der geschachtelte CATCH-Block aufgerufen wurde.Within the nested CATCH block, ERROR_PROCEDURE returns the name of the stored procedure or trigger where the error occurred that invoked the nested CATCH block. Wenn ERROR_PROCEDURE im äußeren CATCH-Block ausgeführt wird, gibt die Funktion den Namen der gespeicherten Prozedur oder des Triggers zurück, in der bzw. in dem der Fehler aufgetreten ist, mit dem dieser CATCH-Block aufgerufen wurde.If ERROR_PROCEDURE is run in the outer CATCH block, it returns the name of the stored procedure or trigger where the error occurred that invoked that CATCH block.

BeispieleExamples

A.A. Verwenden von ERROR_PROCEDURE in einem CATCH-BlockUsing ERROR_PROCEDURE in a CATCH block

Das folgende Codebeispiel zeigt eine gespeicherte Prozedur, in der ein Fehler aufgrund einer Division durch 0 generiert wird.The following code example shows a stored procedure that generates a divide-by-zero error. ERROR_PROCEDURE gibt den Namen der gespeicherten Prozedur zurück, in der der Fehler aufgetreten ist.ERROR_PROCEDURE returns the name of the stored procedure in which the error occurred.

-- Verify that the stored procedure does not already exist.  
IF OBJECT_ID ( 'usp_ExampleProc', 'P' ) IS NOT NULL   
    DROP PROCEDURE usp_ExampleProc;  
GO  

-- Create a stored procedure that   
-- generates a divide-by-zero error.  
CREATE PROCEDURE usp_ExampleProc  
AS  
    SELECT 1/0;  
GO  

BEGIN TRY  
    -- Execute the stored procedure inside the TRY block.  
    EXECUTE usp_ExampleProc;  
END TRY  
BEGIN CATCH  
    SELECT ERROR_PROCEDURE() AS ErrorProcedure;  
END CATCH;  
GO  

B.B. Verwenden von ERROR_PROCEDURE in einem CATCH-Block mit anderen Tools zur FehlerbehandlungUsing ERROR_PROCEDURE in a CATCH block with other error-handling tools

Das folgende Codebeispiel zeigt eine gespeicherte Prozedur, in der ein Fehler aufgrund einer Division durch 0 generiert wird.The following code example shows a stored procedure that generates a divide-by-zero error. Zusammen mit dem Namen der gespeicherten Prozedur, in der der Fehler aufgetreten ist, werden Informationen zurückgegeben, die sich auf den Fehler beziehen.Along with the name of the stored procedure in which the error occurred, information that relates to the error is returned.


-- Verify that the stored procedure does not already exist.  
IF OBJECT_ID ( 'usp_ExampleProc', 'P' ) IS NOT NULL   
    DROP PROCEDURE usp_ExampleProc;  
GO  

-- Create a stored procedure that   
-- generates a divide-by-zero error.  
CREATE PROCEDURE usp_ExampleProc  
AS  
    SELECT 1/0;  
GO  

BEGIN TRY  
    -- Execute the stored procedure inside the TRY block.  
    EXECUTE usp_ExampleProc;  
END TRY  
BEGIN CATCH  
    SELECT   
        ERROR_NUMBER() AS ErrorNumber,  
        ERROR_SEVERITY() AS ErrorSeverity,  
        ERROR_STATE() AS ErrorState,  
        ERROR_PROCEDURE() AS ErrorProcedure,  
        ERROR_MESSAGE() AS ErrorMessage,  
        ERROR_LINE() AS ErrorLine;  
        END CATCH;  
GO  

Beispiele: Azure SQL Data WarehouseAzure SQL Data Warehouse und Parallel Data WarehouseParallel Data Warehouse.Examples: Azure SQL Data WarehouseAzure SQL Data Warehouse and Parallel Data WarehouseParallel Data Warehouse

C.C. Verwenden von ERROR_PROCEDURE in einem CATCH-BlockUsing ERROR_PROCEDURE in a CATCH block

Das folgende Codebeispiel zeigt eine gespeicherte Prozedur, in der ein Fehler aufgrund einer Division durch 0 generiert wird.The following code example shows a stored procedure that generates a divide-by-zero error. ERROR_PROCEDURE gibt den Namen der gespeicherten Prozedur zurück, in der der Fehler aufgetreten ist.ERROR_PROCEDURE returns the name of the stored procedure in which the error occurred.

-- Verify that the stored procedure does not already exist.  
IF OBJECT_ID ( 'usp_ExampleProc', 'P' ) IS NOT NULL   
    DROP PROCEDURE usp_ExampleProc;  
GO  

-- Create a stored procedure that   
-- generates a divide-by-zero error.  
CREATE PROCEDURE usp_ExampleProc  
AS  
    SELECT 1/0;  
GO  

BEGIN TRY  
    -- Execute the stored procedure inside the TRY block.  
    EXECUTE usp_ExampleProc;  
END TRY  
BEGIN CATCH  
    SELECT ERROR_PROCEDURE() AS ErrorProcedure;  
END CATCH;  
GO  

D.D. Verwenden von ERROR_PROCEDURE in einem CATCH-Block mit anderen Tools zur FehlerbehandlungUsing ERROR_PROCEDURE in a CATCH block with other error-handling tools

Das folgende Codebeispiel zeigt eine gespeicherte Prozedur, in der ein Fehler aufgrund einer Division durch 0 generiert wird.The following code example shows a stored procedure that generates a divide-by-zero error. Zusammen mit dem Namen der gespeicherten Prozedur, in der der Fehler aufgetreten ist, werden Informationen zurückgegeben, die sich auf den Fehler beziehen.Along with the name of the stored procedure in which the error occurred, information that relates to the error is returned.


-- Verify that the stored procedure does not already exist.  
IF OBJECT_ID ( 'usp_ExampleProc', 'P' ) IS NOT NULL   
    DROP PROCEDURE usp_ExampleProc;  
GO  

-- Create a stored procedure that   
-- generates a divide-by-zero error.  
CREATE PROCEDURE usp_ExampleProc  
AS  
    SELECT 1/0;  
GO  

BEGIN TRY  
    -- Execute the stored procedure inside the TRY block.  
    EXECUTE usp_ExampleProc;  
END TRY  
BEGIN CATCH  
    SELECT   
        ERROR_NUMBER() AS ErrorNumber,  
        ERROR_SEVERITY() AS ErrorSeverity,  
        ERROR_STATE() AS ErrorState,  
        ERROR_PROCEDURE() AS ErrorProcedure,  
        ERROR_MESSAGE() AS ErrorMessage;  
        END CATCH;  
GO  

Weitere Informationen finden Sie unterSee Also

sys.messages (Transact-SQL) sys.messages (Transact-SQL)
TRY...CATCH (Transact-SQL) TRY...CATCH (Transact-SQL)
ERROR_LINE (Transact-SQL) ERROR_LINE (Transact-SQL)
ERROR_MESSAGE (Transact-SQL) ERROR_MESSAGE (Transact-SQL)
ERROR_NUMBER (Transact-SQL) ERROR_NUMBER (Transact-SQL)
ERROR_SEVERITY (Transact-SQL) ERROR_SEVERITY (Transact-SQL)
ERROR_STATE (Transact-SQL) ERROR_STATE (Transact-SQL)
RAISERROR (Transact-SQL) RAISERROR (Transact-SQL)
@@ERROR (Transact-SQL)@@ERROR (Transact-SQL)