sp_update_alert (Transact-SQL)

  • Article

S’applique à :SQL Server

Met à jour les paramètres d'une alerte existante.

Conventions de la syntaxe Transact-SQL

Syntaxe

sp_update_alert
    [ @name = ] N'name'
    [ , [ @new_name = ] N'new_name' ]
    [ , [ @enabled = ] enabled ]
    [ , [ @message_id = ] message_id ]
    [ , [ @severity = ] severity ]
    [ , [ @delay_between_responses = ] delay_between_responses ]
    [ , [ @notification_message = ] N'notification_message' ]
    [ , [ @include_event_description_in = ] include_event_description_in ]
    [ , [ @database_name = ] N'database_name' ]
    [ , [ @event_description_keyword = ] N'event_description_keyword' ]
    [ , [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @occurrence_count = ] occurrence_count ]
    [ , [ @count_reset_date = ] count_reset_date ]
    [ , [ @count_reset_time = ] count_reset_time ]
    [ , [ @last_occurrence_date = ] last_occurrence_date ]
    [ , [ @last_occurrence_time = ] last_occurrence_time ]
    [ , [ @last_response_date = ] last_response_date ]
    [ , [ @last_response_time = ] last_response_time ]
    [ , [ @raise_snmp_trap = ] raise_snmp_trap ]
    [ , [ @performance_condition = ] N'performance_condition' ]
    [ , [ @category_name = ] N'category_name' ]
    [ , [ @wmi_namespace = ] N'wmi_namespace' ]
    [ , [ @wmi_query = ] N'wmi_query' ]
[ ; ]

Arguments

[ @name = ] N’name'

Nom de l'alerte devant être mise à jour. @name est sysname, sans valeur par défaut.

[ @new_name = ] N’new_name'

Nouveau nom de l'alerte. Le nom doit être unique. @new_name est sysname, avec la valeur par défaut NULL.

[ @enabled = ] activé

Spécifie si l’alerte est activée (1) ou non (0). @enabled est tinyint, avec une valeur par défaut de NULL. Pour pouvoir se déclencher, une alerte doit être activée.

[ @message_id = ] message_id

Nouveau message ou numéro d'erreur pour la définition de l'alerte. En règle générale, message_id correspond à un numéro d’erreur dans la table sysmessages . @message_id est int, avec la valeur par défaut NULL. Un ID de message ne peut être utilisé que si le paramètre de niveau de gravité de l’alerte est 0.

[ @severity = ] gravité

Nouveau niveau de gravité (de à 25partir de 1 ) pour la définition d’alerte. Tout message SQL Server envoyé au journal des applications Windows avec la gravité spécifiée active l’alerte. @severity est int, avec la valeur par défaut NULL. Un niveau de gravité ne peut être utilisé que si le paramètre d’ID de message de l’alerte est 0.

[ @delay_between_responses = ] delay_between_responses

Nouveau délai d'attente, en secondes, entre les réponses faisant suite au déclenchement de l'alerte. @delay_between_responses est int, avec la valeur par défaut NULL.

[ @notification_message = ] N’notification_message'

Texte révisé d’un message supplémentaire envoyé à l’opérateur dans le cadre de la notification de messagerie, d’envoi net ou de pagineur. @notification_message est nvarchar(512), avec la valeur par défaut NULL.

[ @include_event_description_in = ] include_event_description_in

Spécifie si la description de l’erreur SQL Server du journal des applications Windows doit être incluse dans le message de notification. @include_event_description_in est tinyint et peut être une ou plusieurs de ces valeurs.

Valeur Description
0 None
1 E-mail
2 Pager
4 net send
7 Tous

[ @database_name = ] N’database_name'

Nom de la base de données dans laquelle l'erreur doit survenir pour que l'alerte soit déclenchée. @database_name est sysname, avec la valeur par défaut NULL. Les noms placés entre crochets ([]) ne sont pas autorisés.

[ @event_description_keyword = ] N’event_description_mot clé'

Séquence de caractères qui doivent être trouvés dans la description de l’erreur SQL Server dans le journal des messages d’erreur. @event_description_mot clé est nvarchar(100), avec la valeur par défaut NULL. Ce paramètre est utile pour filtrer les noms d’objets (par exemple, customer_table).

Remarque

Les caractères de correspondance de modèle d’expression Transact-SQL LIKE ne peuvent pas être utilisés.

[ @job_id = ] 'job_id'

@job_id est uniqueidentifier, avec la valeur par défaut NULL.

[ @job_name = ] N’job_name'

Numéro d’identification du travail. @job_name est sysname, avec la valeur par défaut NULL. Si job_id est spécifié, job_name doit être omis.

[ @occurrence_count = ] occurrence_count

Réinitialise le nombre de fois que l'alerte s'est produite. @occurrence_count est int, avec une valeur par défaut NULL, et ne peut être défini que sur 0.

[ @count_reset_date = ] count_reset_date

Réinitialise la date de la dernière réinitialisation du nombre d'occurrences. @count_reset_date est int, avec la valeur par défaut NULL.

[ @count_reset_time = ] count_reset_time

Réinitialise l'heure de la dernière réinitialisation du nombre d'occurrences. @count_reset_time est int, avec la valeur par défaut NULL.

[ @last_occurrence_date = ] last_occurrence_date

Réinitialise la date de la dernière occurrence de l'alerte. @last_occurrence_date est int, avec une valeur par défaut NULL, et ne peut être défini que sur 0.

[ @last_occurrence_time = ] last_occurrence_time

Réinitialise l'heure de la dernière occurrence de l'alerte. @last_occurrence_time est int, avec une valeur par défaut et NULLne peut être définie que sur 0.

[ @last_response_date = ] last_response_date

Réinitialise la date à laquelle l'alerte a reçu la dernière réponse du service de l'Agent SQL Server. @last_response_date est int, avec une valeur par défaut NULL, et ne peut être défini que sur 0.

[ @last_response_time = ] last_response_time

Réinitialise l'heure à laquelle l'alerte a reçu la dernière réponse du service de l'Agent SQL Server. @last_response_time est int, avec une valeur par défaut NULL, et ne peut être défini que sur 0.

[ @raise_snmp_trap = ] raise_snmp_trap

Identifié à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie.

[ @performance_condition = ] N’performance_condition'

Valeur exprimée au format <itemcomparatorvalue>. @performance_condition est nvarchar(512) et se compose des éléments suivants.

Élément de format Description
Article Objet de performances, compteur de performances ou instance nommée du compteur.
Comparateur Un de ces opérateurs : >, <, =
Valeur Valeur numérique du compteur.

[ @category_name = ] N’category_name'

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

[ @wmi_namespace = ] N’wmi_namespace'

Espace de noms WMI permettant de rechercher des événements via des requêtes. @wmi_namespace est sysname, avec la valeur par défaut NULL.

[ @wmi_query = ] N’wmi_query'

Requête spécifiant l'événement WMI pour l'alerte. @wmi_query est nvarchar(512), avec la valeur par défaut NULL.

Valeurs des codes de retour

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

Notes

Seul sysmessages l’écriture dans le journal des applications Windows peut déclencher une alerte.

sp_update_alert modifie uniquement les paramètres d’alerte pour lesquels les valeurs des paramètres sont fournies. Si un paramètre est manquant, la valeur actuelle est retenue.

Autorisations

Pour exécuter cette procédure stockée, les utilisateurs doivent être membres du rôle serveur fixe sysadmin .

Exemples

L'exemple suivant modifie le paramètre activé depuis Test Alert à 0.

USE msdb;
GO

EXEC dbo.sp_update_alert
    @name = N'Test Alert',
    @enabled = 0;
GO

Contenu connexe