Note
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier les répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de changer de répertoire.
S’applique à :
SQL ServerAzure SQL Managed Instance
Crée un opérateur (destinataire de la notification) à utiliser pour les alertes et les travaux.
Conventions de la syntaxe Transact-SQL
Syntaxe
dbo.sp_add_operator
[ @name = ] N'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 = ] name
Nom de l'opérateur (destinataire de la notification). Ce nom doit être unique et ne peut pas contenir le caractère pourcentage (%).
@name est sysname, sans valeur par défaut.
[ @enabled = ] activé
Indique l'état actuel de l'opérateur.
@enabled est tinyint, avec une valeur par défaut (1activée). Si 0, l’opérateur n’est pas activé et ne reçoit pas de notifications.
[ @email_address = ] N’email_address'
Adresse de courrier électronique de l'opérateur. Cette chaîne est transmise directement au système de messagerie électronique.
@email_address est nvarchar(100), avec la valeur par défaut NULL.
Vous pouvez spécifier une adresse de messagerie physique ou un alias pour @email_address. Par exemple :
fatmir.bregu ou fatmir.bregu@contoso.com
Remarque
Vous devez utiliser l'adresse de messagerie pour Messagerie de base de données.
[ @pager_address = ] N’pager_address'
Adresse du pagineur de l’opérateur. Cette chaîne est transmise directement au système de messagerie électronique.
@pager_address est nvarchar(100), avec la valeur par défaut NULL.
[ @weekday_pager_start_time = ] weekday_pager_start_time
L’heure de début du service SQL Server Agent envoie les notifications de pageur à l’opérateur, du lundi au vendredi.
@weekday_pager_start_time est int, avec une valeur par défaut 090000, qui indique 9:00 A.M. sur une horloge de 24 heures et doit être entrée à l’aide du formulaireHHmmss.
[ @weekday_pager_end_time = ] weekday_pager_end_time
L’heure de fin où le service SQL Server Agent n’envoie plus de notifications de pager à l’opérateur, du lundi au vendredi.
@weekday_pager_end_time est int, avec un défaut de 180000, ce qui indique 18h00 sur une horloge de 24 heures, et doit être saisi à l’aide du formulaire HHmmss.
[ @saturday_pager_start_time = ] saturday_pager_start_time
L’heure de début est le samedi lorsque le service SQL Server Agent envoie des notifications de pager à l’opérateur.
@saturday_pager_start_time est int, avec un défaut de 090000, qui indique 9h00 sur une horloge de 24 heures, et doit être saisi à l’aide du formulaire HHmmss.
[ @saturday_pager_end_time = ] saturday_pager_end_time
L’heure de fin est le samedi lorsque le service SQL Server Agent n’envoie plus les notifications de pager à l’opérateur.
@saturday_pager_end_time est int, avec une valeur par défaut 180000, qui indique 6:00 P.M. sur une horloge de 24 heures et doit être entrée à l’aide du formulaireHHmmss.
[ @sunday_pager_start_time = ] sunday_pager_start_time
L’heure de début est le dimanche lorsque le service SQL Server Agent envoie des notifications de pager à l’opérateur.
@sunday_pager_start_time est int, avec une valeur par défaut 090000, qui indique 9:00 A.M. sur une horloge de 24 heures et doit être entrée à l’aide du formulaireHHmmss.
[ @sunday_pager_end_time = ] sunday_pager_end_time
L’heure de fin est le dimanche, lorsque le service SQL Server Agent n’envoie plus les notifications de pager à l’opérateur.
@sunday_pager_end_time est int, avec une valeur par défaut 180000, qui indique 6:00 P.M. sur une horloge de 24 heures et doit être entré à l’aide du formulaireHHmmss.
[ @pager_days = ] pager_days
Nombre qui indique les jours pendant lesquels l’opérateur est disponible pour les pages (soumis aux heures de début/de fin spécifiées).
@pager_days est tinyint, avec pour défaut , 0indiquant que l’opérateur n’est jamais disponible pour recevoir une page. Les valeurs valides sont de l’intermédiaire 0127de .
@pager_days est calculé en ajoutant les valeurs individuelles pour les jours requis. Par exemple, du lundi au vendredi est 2 + 4 + 8 + 16 + 32 = 62.
Le tableau ci-après indique la valeur correspondant à chaque jour de la semaine.
| 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 cet opérateur.
@category_name est sysname, avec la valeur par défaut NULL.
Si cette valeur est NULL, l’opérateur est ajouté avec une catégorie par défaut de [Uncategorized]. Vous pouvez également choisir parmi une catégorie existante, en interrogeant la syscategories table dans la msdb base de données :
SELECT name
FROM msdb.dbo.syscategories;
Valeurs des codes de retour
0 (réussite) or 1 (échec).
Jeu de résultats
Aucune.
Notes
sp_add_operator doit être exécuté à partir de la msdb base de données.
Votre système de messagerie doit disposer d’une fonctionnalité de messagerie à page si vous souhaitez utiliser la pagination.
SQL Server Management Studio offre un moyen simple et graphique de gérer les tâches, et est recommandé pour la création et la gestion de l'infrastructure de travail.
autorisations
Vous pouvez accorder EXECUTE des autorisations sur cette procédure, mais ces autorisations peuvent être remplacées lors d’une mise à niveau de SQL Server.
Exemples
L'exemple suivant définit les informations relatives à l'opérateur danwi. L'opérateur est activé. SQL Server Agent envoie des notifications par pagineur du lundi au vendredi de 8 h à 17 h.
USE msdb;
GO
EXECUTE dbo.sp_add_operator
@name = N'Dan Wilson',
@enabled = 1,
@email_address = N'danwi',
@pager_address = N'5551290AW@pager.adventure-works.com',
@weekday_pager_start_time = 080000,
@weekday_pager_end_time = 170000,
@pager_days = 62;
GO