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 nvarchar(128). 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'

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

[ @legacy_format = ] legacy_format

Indique 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

Lorsque @legacy_format est 0, sp_help_alert produit le jeu de résultats suivant.

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, Démonstration : journal complet msdb ).
event_source nvarchar(100) Source de l'événement. Elle sera MSSQLServer toujours destinée à Microsoft SQL Server version 7.0
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 925, , 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=has pager notification
4= a net send une notification.
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 « [Non catégorisé] » pour 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

Lorsque @legacy_format est 1, sp_help_alert produit le jeu de résultats suivant.

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, Démonstration : journal complet msdb ).
event_source nvarchar(100) Source de l'événement. Il sera MSSQLServer toujours pour SQL Server version 7.0
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 925, , 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 SQL Server du journal des applications Windows doit être incluse 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.
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=a une notification par e-mail
2=has pager notification
4=a net send une notification.
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. Si type c’est 3le cas, cette colonne affiche la requête pour l’événement WMI. 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.
type int Type d'alerte :

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

Par défaut, les membres du rôle 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 msdb base de données.

Pour plus d’informations sur SQLAgentOperatorRole, consultez rôles de base de données fixes sql Server Agent.

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