ERROR_NUMBER (Transact-SQL)
Devuelve el número de error del error que ha provocado la ejecución del bloque CATCH de una construcción TRY…CATCH.
Sintaxis
ERROR_NUMBER()
Tipos de valor devueltos
int
Valor devuelto
Si se llama en un bloque CATCH, se devuelve el número de error del mensaje de error que ha provocado la ejecución del bloque CATCH.
Devuelve NULL si se llama fuera del ámbito de un bloque CATCH.
Notas
Se puede llamar a esta función desde cualquier parte del ámbito de un bloque CATCH.
ERROR_NUMBER devuelve el número de error con independencia de las veces que se ejecuta o de la parte donde se ejecuta en el ámbito del bloque CATCH. No ocurre lo mismo con @@ERROR, que sólo devuelve el número de error en la instrucción inmediatamente posterior a la que provoca un error o la primera instrucción de un bloque CATCH.
En los bloques CATCH anidados, ERROR_NUMBER devuelve el número de error específico para el ámbito del bloque CATCH donde se hace referencia a él. Por ejemplo, el bloque CATCH de una construcción TRY...CATCH externa puede tener una construcción TRY...CATCH anidada. En el bloque CATCH anidado, ERROR_NUMBER devuelve el número del error que ha invocado el bloque CATCH anidado. Si ERROR_NUMBER se ejecuta en el bloque CATCH externo, devuelve el número del error que ha invocado el bloque CATCH.
Ejemplos
A. Usar ERROR_NUMBER en un bloque CATCH
En el siguiente ejemplo de código se muestra una instrucción SELECT que genera un error de división por cero. Se devuelve el número de error.
USE AdventureWorks;
GO
BEGIN TRY
-- Generate a divide-by-zero error.
SELECT 1/0;
END TRY
BEGIN CATCH
SELECT ERROR_NUMBER() AS ErrorNumber;
END CATCH;
GO
B. Usar ERROR_NUMBER en un bloque CATCH con otras herramientas de control de errores
En el siguiente ejemplo de código se muestra una instrucción SELECT que genera un error de división por cero. Además del número de error, se devuelve información relacionada con el error.
USE AdventureWorks;
GO
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
Vea también
Referencia
sys.messages (Transact-SQL)
TRY...CATCH (Transact-SQL)
ERROR_LINE (Transact-SQL)
ERROR_MESSAGE (Transact-SQL)
ERROR_PROCEDURE (Transact-SQL)
ERROR_SEVERITY (Transact-SQL)
ERROR_STATE (Transact-SQL)
RAISERROR (Transact-SQL)
@@ERROR (Transact-SQL)
Otros recursos
Recuperar información de errores en Transact-SQL
Usar TRY...CATCH en Transact-SQL
Usar RAISERROR
Usar @@ERROR
Niveles de gravedad de error del motor de base de datos