ERROR_NUMBER (Transact-SQL)

Article
11/16/2023

S’applique à :SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)Point de terminaison analytique SQL dans Microsoft Fabric Entrepôt dans Microsoft Fabric

Cette fonction retourne le numéro d’erreur de l’erreur qui a provoqué l’exécution du bloc CATCH d’une construction TRY...CATCH.

Conventions de la syntaxe Transact-SQL

Syntaxe

ERROR_NUMBER ( )

Remarque

Pour afficher la syntaxe Transact-SQL pour SQL Server 2014 (12.x) et versions antérieures, consultez Versions antérieures de la documentation.

Types de retour

int

Valeur de retour

Quand elle est appelée dans un bloc CATCH, la fonction ERROR_NUMBER retourne le numéro de l’erreur qui a provoqué l’exécution du bloc CATCH.

ERROR_NUMBER retourne NULL quand l’appel a lieu en dehors de l’étendue d’un bloc CATCH.

Notes

ERROR_NUMBER prend en charge les appels à partir de n’importe quel emplacement dans l’étendue d’un bloc CATCH.

ERROR_NUMBER retourne un numéro d’erreur pertinent, quel que soit le nombre de fois où elle s’exécute, ou l’emplacement de son exécution dans l’étendue du bloc CATCH. Ce comportement contraste avec celui d’une fonction comme @@ERROR, qui retourne uniquement un numéro d’erreur dans l’instruction immédiatement après celle qui a provoqué une erreur.

Dans un bloc CATCH imbriqué, ERROR_NUMBER retourne le numéro d’erreur spécifique à l’étendue du bloc CATCH qui a référencé ce bloc CATCH. Par exemple, le bloc CATCH d’une construction TRY...CATCH externe peut comporter une construction TRY...CATCH interne. À l’intérieur de ce bloc CATCH interne, ERROR_NUMBER retourne le numéro de l’erreur qui a appelé le bloc CATCH interne. Si ERROR_NUMBER s’exécute dans le bloc CATCH externe, elle retourne le numéro de l’erreur qui a appelé ce bloc CATCH externe.

Exemples

R. Utilisation de ERROR_NUMBER dans un bloc CATCH

L’exemple suivant montre une instruction SELECT qui génère une erreur de division par zéro. Le bloc CATCH retourne le numéro de l’erreur.

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

Voici le jeu de résultats obtenu.

-----------

(0 row(s) affected)

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

(1 row(s) affected)

B. Utilisation de ERROR_NUMBER dans un bloc CATCH avec d'autres outils de traitement des erreurs

L’exemple suivant montre une instruction SELECT qui génère une erreur de division par zéro. Outre le numéro de l’erreur, le bloc CATCH retourne des informations relatives à cette erreur.

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