Partager via


sp_help_alert (Transact-SQL)

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

Icône Lien de rubriqueConventions de la syntaxe de Transact-SQL

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.

Valeurs des codes renvoyés

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

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. Sera toujours MSSQLServer pour MicrosoftSQL 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 (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

Identifié à 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

Identifié à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie. Sera toujours '[Uncategorized]' pour 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. Sera toujours MSSQLServer 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 (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

Identifié à 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

Identifié à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie. Sera toujours '[Uncategorized]' pour 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.

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