sp_help_alert (Transact-SQL)

Article
12/15/2008

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

Syntaxe

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

Arguments

[ @alert_name =] 'alert_name'
Nom de l'alerte. alert_name est de type nvarchar(128). Si alert_name n’est pas spécifié, des informations sur toutes les alertes sont renvoyées.

[ @order_by =] 'order_by'
Correspond à l'ordre de tri à appliquer pour obtenir les résultats. order_byest de type sysname, et sa valeur par défaut est N 'name'.

[ @alert_id =] alert_id
Numéro d'identification de l'alerte sur laquelle on veut obtenir des informations. alert_idest de type int et sa valeur par défaut est NULL.

[ @category_name =] 'category'
Catégorie de l'alerte. L'argument category est de type sysname, avec NULL comme valeur par défaut.

[ @legacy_format=] legacy_format
Indique si un jeu de résultats hérité est créé. legacy_format est de type bit, avec 0 comme valeur par défaut. Si legacy_format a la valeur 1, sp_help_alert renvoie le jeu de résultats retourné par sp_help_alert dans Microsoft SQL Server 2000.

Jeux de résultats

Si @legacy_format a la valeur 0, sp_help_category crée le jeu de résultats suivant :

Nom de 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. Ce sera toujours MSSQLServer avec Microsoft SQL Server 7.0
event_category_id	int	Indiqué à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie.
event_id	int	Indiqué à 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 (il correspond normalement à un numéro d'erreur dans la table sysmessages). En cas d'utilisation de la gravité pour définir l'alerte, la valeur de message_id est 0 ou NULL.
severity	int	Niveau de gravité (de 9 à 25, 110, 120, 130 ou 140) qui définit l'alerte.
enabled	tinyint	Ce paramètre indique si l'alerte est activée (1) ou non (0). Une alerte non activée ne peut pas être 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 à laquelle le service SQLServerAgent a répondu pour la dernière fois à l'alerte.
last_response_time	int	Heure à laquelle le service SQLServerAgent a répondu pour la dernière fois à l'alerte.
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 où que se soit produite l'erreur.
event_description_keyword	nvarchar(100)	Description de l'erreur SQL Server dans le journal des applications Windows qui doit être identique à la séquence de caractères fournie.
occurrence_count	int	Nombre de déclenchements de l'alerte.
count_reset_date	int	Date de la dernière réinitialisation du compteur occurrence_count.
count_reset_time	int	Heure de la dernière réinitialisation du compteur occurrence_count.
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. Le paramètre peut avoir les valeurs suivantes (liées par OR) : 1= notification de la messagerie 2= notification de la radiomessagerie 4= notification net send.
flags	int	Indiqué à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie.
performance_condition	nvarchar(512)	Si type a la valeur 2, cette colonne comporte la définition des performances ; dans le cas contraire, la colonne a la valeur NULL.
category_name	sysname	Réservé. Toujours « [Uncategorized] » avec SQL Server 7.0.
wmi_namespace	sysname	Si type a la valeur 3, cette colonne indique l'espace de noms pour l'événement WMI.
wmi_query	nvarchar(512)	Si type a la valeur 3, cette colonne indique 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 performance SQL Server 3 = alerte d'événement WMI

Si @legacy_format a la valeur 1, sp_help_category crée le jeu de résultats suivant :

Nom de 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. Ce sera toujours MSSQLServer avec SQL Server 7.0
event_category_id	int	Indiqué à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie.
event_id	int	Indiqué à 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 (il correspond normalement à un numéro d'erreur dans la table sysmessages). En cas d'utilisation de la gravité pour définir l'alerte, la valeur de message_id est 0 ou NULL.
gravité	int	Niveau de gravité (de 9 à 25, 110, 120, 130 ou 140) qui définit l'alerte.
enabled	tinyint	Ce paramètre indique si l'alerte est activée (1) ou non (0). Une alerte non activée ne peut pas être 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 à laquelle le service SQLServerAgent a répondu pour la dernière fois à l'alerte.
last_response_time	int	Heure à laquelle le service SQLServerAgent a répondu pour la dernière fois à l'alerte.
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 où que se soit produite l'erreur.
event_description_keyword	nvarchar(100)	Description de l'erreur SQL Server dans le journal des applications Windows qui doit être identique à la séquence de caractères fournie.
occurrence_count	int	Nombre de déclenchements de l'alerte.
count_reset_date	int	Date de la dernière réinitialisation du compteur occurrence_count.
count_reset_time	int	Heure de la dernière réinitialisation du compteur occurrence_count.
job_id	uniqueidentifier	Numéro d'identification du travail.
job_name	sysname	Nom d'un travail à la demande exécuté 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. Le paramètre peut avoir une ou plusieurs des valeurs suivantes (combinées avec OR) : 1= notification de la messagerie 2= notification de la radiomessagerie 4= notification net send
flags	int	Indiqué à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie.
performance_condition	nvarchar(512)	Si type a la valeur 2, cette colonne indique la définition de la condition de performance. Si type a la valeur 3, cette colonne indique la requête pour l'événement WMI. Dans les autres cas, cette colonne est NULL.
category_name	sysname	Indiqué à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie. Toujours « [Uncategorized] » avec Microsoft SQL Server 7.0.
type	int	Type d'alerte : 1 = alerte d'événement SQL Server 2 = alerte de performance SQL Server 3 = alerte d'événement WMI

Notes

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

Autorisations

Seuls les membres du rôle de serveur fixe sysadmin peuvent exécuter cette procédure stockée. D'autres utilisateurs doivent disposer du rôle de base de données fixe SQLAgentOperatorRole dans la base de données msdb.

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

Valeurs des codes renvoyés

0 (succès) ou 1 (échec)

Exemple

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

Voir aussi

Référence

sp_add_alert (Transact-SQL)
sp_update_alert (Transact-SQL)
Procédures stockées système (Transact-SQL)

Aide et Informations

Assistance sur SQL Server 2005

Share via