ERROR_SEVERITY (Transact-SQL)ERROR_SEVERITY (Transact-SQL)

SE APLICA A: síSQL Server síAzure SQL Database síAzure Synapse Analytics (SQL DW) síAlmacenamiento de datos paralelos APPLIES TO: yesSQL Server yesAzure SQL Database yesAzure Synapse Analytics (SQL DW) yesParallel Data Warehouse

Esta función devuelve el valor de gravedad del error cuando se produce un error, si provoca la ejecución del bloque CATCH de una construcción TRY…CATCH.This function returns the severity value of the error where an error occurs, if that error caused the CATCH block of a TRY...CATCH construct to execute.

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

SintaxisSyntax

ERROR_SEVERITY ( )  

Tipos devueltosReturn Types

intint

Valor devueltoReturn Value

Cuando se llama en un bloque CATCH donde se produce un error, ERROR_SEVERITY devuelve la gravedad del error que provocó la ejecución del bloque CATCH.When called in a CATCH block where an error occurs, ERROR_SEVERITY returns the severity value of the error that caused the CATCH block to run.

ERROR_SEVERITY NULL si se llamó desde fuera del ámbito de un bloque CATCH.ERROR_SEVERITY returns NULL if called outside the scope of a CATCH block.

NotasRemarks

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

ERROR_SEVERITY devuelve el valor de gravedad de un error, con independencia de cuántas veces se ejecute o de dónde se ejecute dentro del ámbito del bloque CATCH.ERROR_SEVERITY returns the error severity value of an error, 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.

ERROR_SEVERITY normalmente funciona en un bloque CATCH anidado.ERROR_SEVERITY typically operates in a nested CATCH block. ERROR_SEVERITY devuelve el valor de gravedad del error específico del ámbito del bloque CATCH al que hace referencia ese bloque CATCH.ERROR_SEVERITY returns the error severity value 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_SEVERITY devuelve el valor de gravedad del error que invocó el bloque CATCH interno.Inside that inner CATCH block, ERROR_SEVERITY returns the severity value of the error that invoked the inner CATCH block. Si ERROR_SEVERITY se ejecuta en el bloque CATCH externo, devuelve el valor de gravedad del error que invocó ese bloque CATCH externo.If ERROR_SEVERITY runs in the outer CATCH block, it returns the error severity value of the error that invoked that outer CATCH block.

Ejemplos: Azure Synapse Analytics (SQL DW)Azure Synapse Analytics (SQL DW) y Almacenamiento de datos paralelosParallel Data WarehouseExamples: Azure Synapse Analytics (SQL DW)Azure Synapse Analytics (SQL DW) and Almacenamiento de datos paralelosParallel Data Warehouse

A.A. Utilizar ERROR_SEVERITY en un bloque CATCHUsing ERROR_SEVERITY in a CATCH block

En este ejemplo se muestra un procedimiento almacenado que genera un error de división por cero.This example shows a stored procedure that generates a divide-by-zero error. ERROR_SEVERITY devuelve el valor de gravedad de ese error.ERROR_SEVERITY returns the severity value of that error.

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

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

-----------

(0 row(s) affected)

ErrorSeverity
-------------
16

(1 row(s) affected)

B.B. Utilizar ERROR_SEVERITY en un bloque CATCH con otras herramientas de control de erroresUsing ERROR_SEVERITY 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. El procedimiento almacenado devuelve información sobre el error.The stored procedure returns information about the 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_NUMBER (Transact-SQL) ERROR_NUMBER (Transact-SQL)
ERROR_PROCEDURE (Transact-SQL) ERROR_PROCEDURE (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)