sp_update_operator (Transact-SQL)
S'applique à : SQL Server
Met à jour des informations sur un opérateur (destinataire de la notification) à utiliser pour les alertes et les travaux.
Conventions de la syntaxe Transact-SQL
Syntaxe
sp_update_operator
[ @name = ] N'name'
[ , [ @new_name = ] N'new_name' ]
[ , [ @enabled = ] enabled ]
[ , [ @email_address = ] N'email_address' ]
[ , [ @pager_address = ] N'pager_address' ]
[ , [ @weekday_pager_start_time = ] weekday_pager_start_time ]
[ , [ @weekday_pager_end_time = ] weekday_pager_end_time ]
[ , [ @saturday_pager_start_time = ] saturday_pager_start_time ]
[ , [ @saturday_pager_end_time = ] saturday_pager_end_time ]
[ , [ @sunday_pager_start_time = ] sunday_pager_start_time ]
[ , [ @sunday_pager_end_time = ] sunday_pager_end_time ]
[ , [ @pager_days = ] pager_days ]
[ , [ @netsend_address = ] N'netsend_address' ]
[ , [ @category_name = ] N'category_name' ]
[ ; ]
Arguments
[ @name = ] N’name'
Nom de l'opérateur à modifier. @name est sysname, sans valeur par défaut.
[ @new_name = ] N’new_name'
Nouveau nom de l'opérateur. Ce nom doit être unique. @new_name est sysname, avec la valeur par défaut NULL
.
[ @enabled = ] activé
Nombre indiquant l’état actuel de l’opérateur (1
le cas échéant, 0
si ce n’est pas le cas). @enabled est tinyint, avec une valeur par défaut de NULL
. S’il n’est pas activé, un opérateur ne reçoit pas de notifications d’alerte.
[ @email_address = ] N’email_address'
Adresse de courrier électronique de l'opérateur. @email_address est nvarchar(100), avec la valeur par défaut NULL
. Cette chaîne est transmise directement au système de messagerie électronique.
[ @pager_address = ] N’pager_address'
Adresse du pagineur de l’opérateur. @pager_address est nvarchar(100), avec la valeur par défaut NULL
. Cette chaîne est transmise directement au système de messagerie électronique.
[ @weekday_pager_start_time = ] weekday_pager_start_time
Indique l'heure à partir de laquelle une notification peut être envoyée à cet opérateur sur son récepteur de radiomessagerie, du lundi au vendredi. @weekday_pager_start_time est int, avec une valeur par défaut NULL
, et doit être entré dans le formulaire HHmmss
à utiliser avec une horloge de 24 heures.
[ @weekday_pager_end_time = ] weekday_pager_end_time
Spécifie l’heure après laquelle une notification de pagineur ne peut pas être envoyée à l’opérateur spécifié, du lundi au vendredi. @weekday_pager_end_time est int, avec une valeur par défaut NULL
, et doit être entré dans le formulaire HHmmss
à utiliser avec une horloge de 24 heures.
[ @saturday_pager_start_time = ] saturday_pager_start_time
Indique l'heure à partir de laquelle une notification peut être envoyée le samedi à l'opérateur spécifié sur son récepteur de radiomessagerie. @saturday_pager_start_time est int, avec une valeur par défaut NULL
, et doit être entré dans le formulaire HHmmss
à utiliser avec une horloge de 24 heures.
[ @saturday_pager_end_time = ] saturday_pager_end_time
Spécifie l’heure après laquelle une notification de pagineur ne peut pas être envoyée à l’opérateur spécifié le samedi. @saturday_pager_end_time est int, avec une valeur par défaut NULL
, et doit être entré dans le formulaire HHmmss
à utiliser avec une horloge de 24 heures.
[ @sunday_pager_start_time = ] sunday_pager_start_time
Indique l'heure à partir de laquelle une notification peut être envoyée le dimanche à l'opérateur spécifié sur son récepteur de radiomessagerie. @sunday_pager_start_time est int, avec une valeur par défaut NULL
, et doit être entré dans le formulaire HHmmss
à utiliser avec une horloge de 24 heures.
[ @sunday_pager_end_time = ] sunday_pager_end_time
Spécifie l’heure après laquelle une notification de pagineur ne peut pas être envoyée à l’opérateur spécifié le dimanche. @sunday_pager_end_time est int, avec une valeur par défaut NULL
, et doit être entré dans le formulaire HHmmss
à utiliser avec une horloge de 24 heures.
[ @pager_days = ] pager_days
Indique les jours où l'opérateur est en mesure de recevoir des notifications par radiomessagerie (en fonction des heures de début/fin précisées). @pager_days est tinyint, avec une valeur par défaut NULL
, et doit être une valeur à partir de 0
.127
@pager_days est calculé en ajoutant les valeurs individuelles pour les jours requis. Par exemple, du lundi au vendredi est 2
64
= 32
+ + + 16
+ 4
8
.
Valeur | Description |
---|---|
1 |
Dimanche |
2 |
Lundi |
4 |
Mardi |
8 |
Mercredi |
16 |
Jeudi |
32 |
Vendredi |
64 |
Samedi |
[ @netsend_address = ] N’netsend_address'
Adresse réseau de l'opérateur à qui est envoyé le message réseau. @netsend_address est nvarchar(100), avec la valeur par défaut NULL
.
[ @category_name = ] N’category_name'
Nom de la catégorie pour cette alerte. @category_name est sysname, avec la valeur par défaut NULL
.
Valeurs des codes de retour
0
(réussite) ou 1
(échec).
Notes
sp_update_operator
doit être exécuté à partir de la msdb
base de données.
autorisations
Les autorisations d'exécution de cette procédure sont accordées par défaut aux membres du rôle de serveur fixe sysadmin .
Exemples
L’exemple suivant met à jour l’état de l’opérateur, le paramètre @enabled
true
sur et définit les jours (du lundi au vendredi, de 8 h à 17 h) lorsque l’opérateur peut être paginé.
USE msdb;
GO
EXEC dbo.sp_update_operator
@name = N'François Ajenstat',
@enabled = 1,
@email_address = N'françoisa',
@pager_address = N'5551290AW@pager.Adventure-Works.com',
@weekday_pager_start_time = 080000,
@weekday_pager_end_time = 170000,
@pager_days = 64;
GO