Partage via


sp_add_operator (Transact-SQL)

S’applique à : SQL Server Azure 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

sp_add_operator
    [ @name = ] '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 = ] 'category' ]
[ ; ]

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

Heure après laquelle SQL Server Agent envoie une notification de pagineur à l’opérateur spécifié le jour de la semaine, 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

Heure après laquelle le service SQL Server Agent n’envoie plus de notification de pagineur à l’opérateur spécifié les jours de la semaine, du lundi au vendredi. weekday_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 formulaire HHmmss.

[ @saturday_pager_start_time = ] saturday_pager_start_time

Heure après laquelle le service SQL Server Agent envoie une notification de pagineur à l’opérateur spécifié le samedi. saturday_pager_start_time est int, avec une valeur par défaut , 090000qui indique 9:00 A.M. sur une horloge de 24 heures et doit être entrée à l’aide du formulaireHHmmss.

[ @saturday_pager_end_time = ] saturday_pager_end_time

Heure après laquelle le service SQL Server Agent n’envoie plus de notification de pagineur à l’opérateur spécifié le samedi. @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

Heure après laquelle le service SQL Server Agent envoie une notification de pagineur à l’opérateur spécifié le dimanche. @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

Heure après laquelle le service SQL Server Agent n’envoie plus de notification de pagineur à l’opérateur spécifié le dimanche. @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 une valeur par défaut 0 indiquant que l’opérateur n’est jamais disponible pour recevoir une page. Les valeurs valides sont de l’intermédiaire 0 127de . @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 = ] 'category'

Nom de la catégorie pour cet opérateur. @category_name est sysname, avec la valeur par défaut NULL.

Valeurs des codes de retour

0 (réussite) ou 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

Cette procédure stockée appartient au rôle db_owner . Vous pouvez accorder EXECUTE des autorisations pour n’importe quel utilisateur, 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

EXEC 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