sp_help_alert (Transact-SQL)
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)