sp_add_operator (Transact-SQL)

Crée un opérateur (destinataire de la notification) à utiliser pour les alertes et les travaux.

Icône Lien de rubriqueConventions de syntaxe Transact-SQL

Syntaxe

sp_add_operator [ @name = ] 'name' 
     [ , [ @enabled = ] enabled ] 
     [ , [ @email_address = ] 'email_address' ] 
     [ , [ @pager_address = ] '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 = ] 'netsend_address' ] 
     [ , [ @category_name = ] 'category' ] 

Arguments

  • [ @name= ] 'name'
    Nom de l'opérateur (destinataire de la notification). Ce nom doit être unique et ne doit pas contenir le caractère de pourcentage (%). L'argument name est de type sysname et n'a pas de valeur par défaut.

  • [ @enabled= ] enabled
    Indique l'état actuel de la planification. L'argument enabled est de type tinyint, avec la valeur 1 par défaut (activé). Si la valeur 0 est affectée à l'argument, l'opérateur n'est pas activé et ne reçoit pas de notifications.

  • [ @email_address= ] 'email_address'
    Adresse de courrier électronique de l'opérateur. Cette chaîne est transmise directement au système de messagerie électronique. L'argument email_address est de type nvarchar(100), avec la valeur par défaut NULL.

    Vous pouvez spécifier une adresse électronique physique ou un alias pour email_address. Par exemple :

    'jdoe' ou 'jdoe@xyz.com'

    Notes

    Vous pouvez utiliser un alias de messagerie uniquement pour SQL Mail. Vous devez utiliser l'adresse de messagerie pour Messagerie de base de données.

  • [ @pager_address= ] 'pager_address'
    Adresse de radiomessagerie de l'opérateur. Cette chaîne est transmise directement au système de messagerie électronique. L'argument pager_address est de type narchar(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 par radiomessagerie à l'opérateur spécifié. Cette opération a lieu durant les jours de la semaine, du lundi au vendredi. L'argument weekday_pager_start_time est de type int, avec la valeur 090000 par défaut. Cette valeur indique 9 heures du matin sur une horloge de 24 heures. Elle doit être au format HHMMSS.

  • [ @weekday_pager_end_time= ] weekday_pager_end_time
    Heure après laquelle le service SQLServerAgent n'envoie plus de notification par radiomessagerie à l'opérateur spécifié. Cette opération a lieu durant les jours de la semaine, du lundi au vendredi. L'argument weekday_pager_end_time est de type int, avec la valeur 180000 par défaut. Cette valeur indique 18 heures sur une horloge de 24 heures. Elle doit être au format HHMMSS.

  • [ @saturday_pager_start_time =] saturday_pager_start_time
    Heure après laquelle le service SQLServerAgent envoie une notification par radiomessagerie à l'opérateur spécifié. Cette opération a lieu le samedi. L'argument saturday_pager_start_time est de type int, avec la valeur 090000 par défaut. Cette valeur indique 9 heures du matin sur une horloge de 24 heures. Elle doit être au format HHMMSS.

  • [ @saturday_pager_end_time= ] saturday_pager_end_time
    Heure après laquelle le service SQLServerAgent n'envoie plus de notification par radiomessagerie à l'opérateur spécifié. Cette opération a lieu le samedi. L'argument saturday_pager_end_timeest de type int, avec la valeur 180000 par défaut. Cette valeur indique 18 heures sur une horloge de 24 heures. Elle doit être au format HHMMSS.

  • [ @sunday_pager_start_time= ] sunday_pager_start_time
    Heure après laquelle le service SQLServerAgent envoie une notification par radiomessagerie à l'opérateur spécifié. Cette opération a lieu le dimanche. L'argument sunday_pager_start_timeest de type int, avec la valeur 090000 par défaut. Cette valeur indique 9 heures du matin sur une horloge de 24 heures. Elle doit être au format HHMMSS.

  • [ @sunday_pager_end_time =] sunday_pager_end_time
    Heure après laquelle le service SQLServerAgent n'envoie plus de notification par radiomessagerie à l'opérateur spécifié. Cette opération a lieu le dimanche. L'argument sunday_pager_end_timeest de type int, avec la valeur 180000 par défaut. Cette valeur indique 18 heures sur une horloge de 24 heures. Elle doit être au format HHMMSS.

  • [ @pager_days= ] pager_days
    Nombre qui indique les jours pendant lesquels l'opérateur peut recevoir des notifications par radiomessagerie (argument utilisé avec un argument définissant les heures de début et de fin). L'argument pager_daysest de type tinyint, avec 0 comme valeur par défaut. Cette valeur indique que l'opérateur n'est jamais disponible pour recevoir un message. Les valeurs valides sont comprises entre 0 et 127. La valeur de l'argument pager_daysest calculée en ajoutant les valeurs représentant les jours voulus. Par exemple, la valeur définissant un envoi du lundi au vendredi est calculée de la façon suivante : 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= ] 'netsend_address'
    Adresse réseau de l'opérateur à qui est envoyé le message. L'argument netsend_addressest de type nvarchar(100), avec NULL comme valeur par défaut.

  • [ @category_name= ] 'category'
    Nom de la catégorie pour cet opérateur. L'argument category est de type sysname, avec NULL comme valeur par défaut.

Valeurs des codes de retour

0 (succès) ou 1 (échec)

Jeux de résultats

Aucun

Notes

La procédure sp_add_operator doit être exécutée à partir de la base de données msdb.

Les appels de radiomessagerie reposent sur le système de courrier électronique qui doit pouvoir passer du courrier électronique au récepteur de radiomessagerie si vous désirez utiliser ce dernier.

SQL Server Management Studio est un outil dont l'interface graphique permet de gérer facilement les travaux. Son utilisation est recommandée pour créer et gérer l'infrastructure des travaux.

Autorisations

Seuls les membres du rôle de serveur fixe sysadmin peuvent exécuter la procédure sp_add_operator.

Exemples

L'exemple suivant définit les informations relatives à l'opérateur danwi. L'opérateur est activé. SQL Server Agent envoie des informations par radiomessagerie du lundi au vendredi de 8 heures à 17 heures.

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