sp_update_alert (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. L'argument name est de type sysname, sans valeur par défaut.

• [ @new_name =] 'new_name'
  Nouveau nom de l'alerte. Ce nom doit être unique. L'argument 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). L'argument 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. En principe, message_id correspond à un numéro d'erreur dans la table sysmessages. L'argument 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 MicrosoftSQL Server envoyé au journal des applications de Windows avec la gravité indiquée active l'alerte. L'argument 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. L'argument 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 par radiomessagerie. L'argument 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 de Windows doit être incluse dans le message de notification. L'argument 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 (envoi réseau)
  7	Complète

• [ @database_name =] 'database'
  Nom de la base de données dans laquelle doit se produire l'erreur déclenchant l'alerte. database est sysname. Les noms entourés de 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. L'argument 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. L'argument 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. L'argument 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. L'argument occurrence_count est de type int, avec NULL comme valeur par défaut, 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. L'argument 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. L'argument 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. L'argument 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. L'argument 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. L'argument last_response_date est de type int, avec NULL comme valeur par défaut, 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. L'argument last_response_time est de type int, avec NULL comme valeur par défaut, 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'. L'argument 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. L'argument 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. L'argument 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 de 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

Voir aussi

Référence