sp_update_alert (Transact-SQL)
Met à jour les paramètres d'une alerte existante.
.gif "Icône Lien de rubrique")
Conventions de la syntaxe Transact-SQL
Syntaxe
sp_update_alert
[ @name =] 'name'
[ , [ @new_name =] 'new_name']
[ , [ @enabled =] enabled]
[ , [ @message_id =] message_id]
[ , [ @severity =] severity]
[ , [ @delay_between_responses =] delay_between_responses]
[ , [ @notification_message =] 'notification_message']
[ , [ @include_event_description_in =] include_event_description_in]
[ , [ @database_name =] 'database']
[ , [ @event_description_keyword =] 'event_description_keyword']
[ , [ @job_id =] job_id | [@job_name =] '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 =] 'performance_condition' ]
[ , [ @category_name =] 'category']
[ , [ @wmi_namespace = ] 'wmi_namespace' ]
[ , [ @wmi_query = ] 'wmi_query' ]
Arguments
[ @name =] 'name'
Nom de l'alerte devant être mise à jour. name est de type sysname et n'a pas de valeur par défaut.[ @new_name =] 'new_name'
Nouveau nom de l'alerte. Le nom doit être unique. new_name est de type sysname, avec NULL comme valeur par défaut.[ @enabled =] enabled
Indique si l'alerte est activée (1) ou désactivée (0). enabled est de type tinyint, avec NULL comme valeur par défaut. 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. Généralement, message_id correspond à un numéro d'erreur dans la table sysmessages. message_id est de type int, avec NULL comme valeur par défaut. L'ID du message ne peut être utilisé que si le paramètre de niveau de gravité de l'alerte indique 0.[ @severity =] severity
Nouveau niveau de gravité (de 1 à 25) pour la définition de l'alerte. Tout message Microsoft SQL Server envoyé au journal des applications Windows avec la gravité indiquée active l'alerte. severity est de type int, avec NULL comme valeur par défaut. Un niveau de gravité ne peut être utilisé que si le paramètre ID de message de l'alerte indique 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 de type int, avec NULL comme valeur par défaut.[ @notification_message =] 'notification_message'
Texte révisé d'un message supplémentaire envoyé à l'opérateur dans le cadre d'une notification par courrier électronique, net send ou radiomessagerie. notification_message est de type nvarchar(512), avec NULL comme valeur par défaut.[ @include_event_description_in =] include_event_description_in
Indique si la description de l'erreur SQL Server dans le journal des applications Windows doit être incluse dans le message de notification. include_event_description_in est de type tinyint avec une valeur par défaut NULL et l'une ou plusieurs de ces valeurs.Valeur
Description
0
Aucune
1
Courrier électronique
2
Récepteur de radiomessagerie
4
net send
7
Tous
[ @database_name =] 'database'
Nom de la base de données dans laquelle l'erreur doit survenir pour que l'alerte soit déclenchée. database est de type sysname. Les noms placés entre crochets ([ ]) ne sont pas autorisés. La valeur par défaut est NULL.[ @event_description_keyword =] 'event_description_keyword'
Chaîne de caractères devant figurer dans la description de l'erreur dans le journal des messages d'erreur. Les caractères correspondant au modèle d'expression Transact-SQL LIKE sont admis. event_description_keyword est de type nvarchar(100), avec NULL comme valeur par défaut. Ce paramètre est utile pour filtrer les noms d'objets (par exemple, %customer_table%).[ @job_id =] job_id
Numéro d'identification du travail. job_id est de type uniqueidentifier, avec NULL comme valeur par défaut. Si vous spécifiez l'argument job_id, vous devez omettre job_name.[ @job_name =] 'job_name'
Nom du travail exécuté en réponse à l'alerte. job_name est de type sysname, avec NULL comme valeur par défaut. Si vous spécifiez l'argument job_name, vous devez omettre job_id.[ @occurrence_count = ] occurrence_count
Réinitialise le nombre de fois que l'alerte s'est produite. occurrence_count est de type int avec une valeur par défaut NULL et ne peut accepter que la valeur 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 de type int, avec NULL comme valeur par défaut.[ @count_reset_time =] count_reset_time
Réinitialise l'heure de la dernière réinitialisation du nombre d'occurrences. count_reset_time est de type int, avec NULL comme valeur par défaut.[ @last_occurrence_date =] last_occurrence_date
Réinitialise la date de la dernière occurrence de l'alerte. last_occurrence_date est de type int avec une valeur par défaut NULL et ne peut accepter que la valeur 0.[ @last_occurrence_time =] last_occurrence_time
Réinitialise l'heure de la dernière occurrence de l'alerte. last_occurrence_time est de type int avec une valeur par défaut NULL et ne peut accepter que la valeur 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 de type int avec une valeur par défaut NULL et ne peut accepter que la valeur 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 de type int avec une valeur par défaut NULL et ne peut accepter que la valeur 0.[ @raise_snmp_trap =] raise_snmp_trap
Réservé.[ @performance_condition =] 'performance_condition'
Valeur exprimée dans le format 'itemcomparatorvalue'. performance_condition est de type nvarchar(512) avec NULL comme valeur par défaut, et est constitué des éléments suivants.Élément
Description
Item
Objet de performances, compteur de performances ou instance nommée du compteur.
Comparator
Un des opérateurs suivants : >, < et =
Value
Valeur numérique du compteur.
[ @category_name =] 'category'
Nom de la catégorie d'alerte. category est de type sysname, avec NULL comme valeur par défaut.[ @wmi_namespace= ] 'wmi_namespace'
Espace de noms WMI permettant de rechercher des événements via des requêtes. wmi_namespace est de type sysname, avec NULL comme valeur par défaut.[ @wmi_query= ] 'wmi_query'
Requête spécifiant l'événement WMI pour l'alerte. wmi_query est de type nvarchar(512), avec NULL comme valeur par défaut.
Valeurs des codes renvoyés
0 (succès) ou 1 (échec)
Notes
Seul sysmessages écrit dans le journal des applications Microsoft Windows peut déclencher une alerte.
La procédure sp_update_alert modifie uniquement les paramètres d'alerte possédant des valeurs. 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 de 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