ERROR_NUMBER (Transact-SQL)ERROR_NUMBER (Transact-SQL)
SQL Server
Azure SQL Database
Azure Synapse Analytics (SQL DW)
Almacenamiento de datos paralelos
SQL Server
Azure SQL Database
Azure Synapse Analytics (SQL DW)
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.
Convenciones de sintaxis de Transact-SQL
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
El conjunto de resultados es el siguiente.Here is the result set.
-----------
(0 row(s) affected)
ErrorNumber ErrorSeverity ErrorState ErrorProcedure ErrorLine ErrorMessage
----------- ------------- ----------- --------------- ---------- ----------------------------------
8134 16 1 NULL 4 Divide by zero error encountered.
(1 row(s) affected)
Consulte tambiénSee 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_PROCEDURE (Transact-SQL) ERROR_PROCEDURE (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)
Referencia de errores y eventos (Motor de base de datos)Errors and Events Reference (Database Engine)
Comentarios
Cargando comentarios...