Créer une alerte avec un numéro d’erreur

S'applique à : SQL Server

Cette rubrique explique comment créer une alerte Microsoft SQL Server Agent survenant dans SQL Server qui sera déclenchée quand une erreur avec un numéro spécifique en utilisant SQL Server Management Studio ou Transact-SQL.

Avant de commencer

Limitations et restrictions

• SQL Server Management Studio est un outil simple, fonctionnant en mode graphique, qui permet de gérer tout le système d’alerte. Son utilisation est recommandée pour configurer une infrastructure d’alertes.

• Les événements créés à l’aide de xp_logevent surviennent dans la base de données master. Ainsi, la procédure xp_logevent ne déclenche pas d’alerte sauf si la valeur de @database_name pour l’alerte est 'master' ou NULL.

Sécurité

Autorisations

Par défaut, seuls les membres du rôle serveur fixe sysadmin peuvent exécuter la procédure sp_add_alert.

Utilisation de SQL Server Management Studio

Pour créer une alerte avec un numéro d'erreur

1. Dans l' Explorateur d'objets , cliquez sur le signe plus (+) pour développer le serveur sur lequel vous souhaitez créer une alerte avec un numéro d'erreur.

2. Cliquez sur le signe plus (+) pour développer Agent SQL Server.

3. Cliquez avec le bouton droit sur Alertes , puis sélectionnez Nouvelle alerte.

4. Dans la boîte de dialogue Nouvelle alerte , dans la zone Nom , entrez un nom pour cette alerte.

5. Sélectionnez la case à cocher Activer afin d'activer l'alerte à exécuter. Par défaut, l'option Activer est sélectionnée.

6. Dans la liste Type , sélectionnez Alerte d'événement SQL Server.

7. Sous Définition d'une alerte d'événement, dans la liste Nom de base de données , sélectionnez une base de données pour restreindre l'alerte à une base de données spécifique.

8. Sous Les alertes seront déclenchées selon, cliquez sur Numéro d'erreur, puis tapez un numéro d'erreur valide pour l'alerte. Vous pouvez également cliquer sur Gravité , puis sélectionner la gravité spécifique qui déclenchera l'alerte.

9. Activez la case à cocher correspondant à Déclencher une alerte quand le message contient afin de limiter l'alerte à une certaine séquence de caractères, puis entrez un mot clé ou une chaîne de caractères pour le Texte du message. Le nombre maximal de caractères autorisé est de 100.

10. Cliquez sur OK.

Utilisation de Transact-SQL

Pour créer une alerte avec un numéro d'erreur

1. Dans l' Explorateur d'objets, connectez-vous à une instance du Moteur de base de données.

2. Dans la barre d'outils standard, cliquez sur Nouvelle requête.

3. Copiez et collez l'exemple suivant dans la fenêtre de requête, puis cliquez sur Exécuter.

   -- adds an alert (Test Alert) that runs the Back up
   -- the AdventureWorks2022 Database job when fired   
   -- assumes that the message 55001 and the Back up
   -- the AdventureWorks2022 Database job already exist.  
   USE msdb ;  
   GO  
   
   EXEC dbo.sp_add_alert  
       @name = N'Test Alert',  
       @message_id = 55001,   
      @severity = 0,   
      @notification_message = N'Error 55001 has occurred. The DB will be backed up...',   
      @job_name = N'Back up the AdventureWorks2022 Database' ;  
   GO  
   

Pour plus d’informations, consultez sp_add_alert (Transact-SQL).