ERROR_NUMBER (Transact-SQL)ERROR_NUMBER (Transact-SQL)

03/16/2017
Tiempo de lectura: 3 minutos

SE APLICA A: SQL Server Azure SQL Database Azure Synapse Analytics (SQL DW) Almacenamiento de datos paralelos APPLIES TO: yes SQL Server yes Azure SQL Database yes Azure Synapse Analytics (SQL DW) yes Parallel Data Warehouse

Esta función devuelve el número del error que ha provocado la ejecución del bloque CATCH de una construcción TRY…CATCH.This function returns the error number of the error that caused the CATCH block of a TRY...CATCH construct to execute.

Icono de vínculo de tema Convenciones de sintaxis de Transact-SQL Topic link icon Transact-SQL Syntax Conventions

SintaxisSyntax

ERROR_NUMBER ( )

Tipos devueltosReturn Types

intint

Valor devueltoReturn Value

Si se llama en un bloque CATCH, ERROR_NUMBER devuelve el número del error que ha provocado la ejecución del bloque CATCH.When called in a CATCH block, ERROR_NUMBER returns the error number of the error that caused the CATCH block to run.

ERROR_NUMBER devuelve NULL si se llama desde fuera del ámbito de un bloque CATCH.ERROR_NUMBER returns NULL when called outside the scope of a CATCH block.

NotasRemarks

ERROR_NUMBER admite llamadas en cualquier lugar del ámbito de un bloque CATCH.ERROR_NUMBER supports calls anywhere within the scope of a CATCH block.

ERROR_NUMBER devuelve un número de error relevante, con independencia de cuántas veces se ejecute o de dónde se ejecute dentro del ámbito del bloque CATCH.ERROR_NUMBER returns a relevant error number regardless of how many times it runs, or where it runs within the scope of the CATCH block. Esto contrasta con funciones como @@ERROR, que solo devuelve un número de error en la instrucción inmediatamente posterior a la que produjo el error.This contrasts with a function like @@ERROR, which only returns an error number in the statement immediately following the one that causes an error.

En un bloque CATCH anidado, ERROR_NUMBER devuelve el número de error específico del ámbito del bloque CATCH al que hace referencia ese bloque CATCH.In a nested CATCH block, ERROR_NUMBER returns the error number specific to the scope of the CATCH block that referenced that CATCH block. Por ejemplo, el bloque CATCH de una construcción TRY...CATCH externa podría tener una construcción TRY...CATCH interna.For example, the CATCH block of an outer TRY...CATCH construct could have an inner TRY...CATCH construct. Dentro de ese bloque interno CATCH, ERROR_NUMBER devuelve el número del error que invocó el bloque CATCH interno.Inside that inner CATCH block, ERROR_NUMBER returns the number of the error that invoked the inner CATCH block. Si ERROR_NUMBER se ejecuta en el bloque CATCH externo, devuelve el número del error que invocó ese bloque CATCH externo.If ERROR_NUMBER runs in the outer CATCH block, it returns the number of the error that invoked that outer CATCH block.

EjemplosExamples

A.A. Usar ERROR_NUMBER en un bloque CATCHUsing ERROR_NUMBER in a CATCH block

En este ejemplo se muestra una instrucción SELECT que genera un error de división por cero.This example shows a SELECT statement that generates a divide-by-zero error. El bloque CATCH devuelve el número de error.The CATCH block returns the error number.

BEGIN TRY  
    -- Generate a divide-by-zero error.  
    SELECT 1/0;  
END TRY  
BEGIN CATCH  
    SELECT ERROR_NUMBER() AS ErrorNumber;  
END CATCH;  
GO

El conjunto de resultados es el siguiente.Here is the result set.

-----------

(0 row(s) affected)

ErrorNumber
-----------
8134

(1 row(s) affected)

B.B. Usar ERROR_NUMBER en un bloque CATCH con otras herramientas de control de erroresUsing ERROR_NUMBER in a CATCH block with other error-handling tools

En este ejemplo se muestra una instrucción SELECT que genera un error de división por cero.This example shows a SELECT statement that generates a divide-by-zero error. Junto con el número de error, el bloque CATCH devuelve información sobre ese error.Along with the error number, the CATCH block returns information about that error.

BEGIN TRY  
    -- Generate a divide-by-zero error.  
    SELECT 1/0;  
END TRY  
BEGIN CATCH  
    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;  
END CATCH;  
GO