Partager via

sp_help_alert (Transact-SQL)

  • Article

S'applique à : SQL Server

Fournit des informations sur les alertes définies pour le serveur.

Conventions de la syntaxe Transact-SQL

Syntaxe

sp_help_alert
    [ [ @alert_name = ] N'alert_name' ]
    [ , [ @order_by = ] N'order_by' ]
    [ , [ @alert_id = ] alert_id ]
    [ , [ @category_name = ] N'category_name' ]
    [ , [ @legacy_format = ] legacy_format ]
[ ; ]

Arguments

[ @alert_name = ] N’alert_name'

Nom de l’alerte. @alert_name est sysname, avec la valeur par défaut NULL. Si @alert_name n’est pas spécifié, des informations sur toutes les alertes sont retournées.

[ @order_by = ] N’order_by'

Ordre de tri à appliquer pour obtenir les résultats. @order_by est sysname, avec une valeur par défaut de la @alert_name.

[ @alert_id = ] alert_id

Numéro d'identification de l'alerte sur laquelle on veut obtenir des informations. @alert_id est int, avec la valeur par défaut NULL.

[ @category_name = ] N’category_name'

Catégorie de l'alerte. @category_name est sysname, avec la valeur par défaut NULL.

[ @legacy_format = ] legacy_format

Spécifie s’il faut produire un jeu de résultats hérité. @legacy_format est bit, avec la valeur par défaut 0. Lorsque @legacy_format est 1, sp_help_alert retourne le jeu de résultats retourné par sp_help_alert SQL Server 2000 (8.x).

Valeurs des codes de retour

0 (réussite) ou 1 (échec).

Jeu de résultats

Ce tableau affiche uniquement la sortie lorsque @legacy_format est 0, pour SQL Server 2005 (9.x) et versions ultérieures.

Nom de la colonne Type de données Description
id int Identificateur entier unique attribué par le système.
name sysname Nom de l’alerte (par exemple, Demo: Full msdb log).
event_source nvarchar(100) Source de l'événement.
event_category_id int Identifié à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie.
event_id int Identifié à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie.
message_id int Numéro du message d'erreur définissant l'alerte (Correspond généralement à un numéro d’erreur dans la sysmessages table). Si la gravité est utilisée pour définir l’alerte, message_id est 0 ou NULL.
severity int Niveau de gravité (à partir de 9 25, , 110, 120ou 140130) qui définit l’alerte.
enabled tinyint État indiquant si l’alerte est actuellement activée (1) ou non (0). Une alerte non modifiable n’est pas envoyée.
delay_between_responses int Délai d'attente, en secondes, entre les réponses à l'alerte.
last_occurrence_date int Date de la dernière apparition de l'alerte.
last_occurrence_time int Heure de la dernière apparition de l'alerte.
last_response_date int Date de la dernière réponse de l’alerte par le service SQL Server Agent.
last_response_time int Heure de la dernière réponse de l’alerte par le service SQL Server Agent.
notification_message nvarchar(512) Message supplémentaire facultatif qui sera envoyé à l'opérateur avec la notification par courrier électronique ou radiomessagerie.
include_event_description tinyint Indique si la description de l'erreur de SQL Server contenue dans le journal des applications Windows doit apparaître dans le message de notification.
database_name sysname Base de données dans laquelle l'erreur doit apparaître pour que l'alerte soit déclenchée. Si le nom de la base de données est NULL, l’alerte se déclenche quel que soit l’endroit où l’erreur s’est produite.
event_description_keyword nvarchar(100) Description de l’erreur SQL Server dans le journal des applications Windows qui doit être semblable à la séquence de caractères fournie.
occurrence_count int Nombre de déclenchements de l'alerte.
count_reset_date int Date de la occurrence_count dernière réinitialisation.
count_reset_time int Heure de la occurrence_count dernière réinitialisation.
job_id uniqueidentifier Numéro d'identification du travail à exécuter en réponse à une alerte.
job_name sysname Nom du travail à exécuter en réponse à une alerte.
has_notification int Différent de zéro si un ou plusieurs opérateurs sont notifiés pour cette alerte. La valeur est une ou plusieurs des valeurs suivantes (ORregroupées) :

1 = a une notification par e-mail
2 = a une notification de pagineur
4= a une notification d’envoi net.
flags int Identifié à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie.
performance_condition nvarchar(512) Si type c’est 2le cas, cette colonne affiche la définition de la condition de performances ; sinon, la colonne est NULL.
category_name sysname Identifié à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie. Sera toujours [Uncategorized] destiné à SQL Server 7.0.
wmi_namespace sysname Si type c’est 3le cas, cette colonne affiche l’espace de noms de l’événement WMI.
wmi_query nvarchar(512) Si type c’est 3le cas, cette colonne affiche la requête pour l’événement WMI.
type int Type de l'événement :

1 = Alerte d’événement SQL Server
2 = alerte de performances SQL Server
3 = Alerte d’événement WMI

Notes

sp_help_alert doit être exécuté à partir de la msdb base de données.

autorisations

Cette procédure stockée appartient au rôle db_owner . Vous pouvez accorder EXECUTE des autorisations pour n’importe quel utilisateur, mais ces autorisations peuvent être remplacées lors d’une mise à niveau de SQL Server.

D’autres utilisateurs doivent disposer de l’un des rôles de base de données fixes SQL Server Agent suivants dans la msdb base de données :

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

Pour en savoir plus sur les autorisations de ces rôles, consultez Rôles de base de données fixes de l'Agent SQL Server.

Exemples

L'exemple suivant retourne des informations sur l'alerte Demo: Sev. 25 Errors.

USE msdb;
GO

EXEC sp_help_alert @alert_name = 'Demo: Sev. 25 Errors';
GO

Contenu connexe