sp_add_operator (Transact-SQL)

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

Conventions de la syntaxe de 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 (%). name est de type sysname et n'a pas de valeur par défaut.

• [ @enabled= ] enabled
  Indique l'état actuel de l'opérateur. enabled est de type tinyint, avec 1 (activé) comme valeur par défaut. 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. email_address est de type nvarchar(100), avec NULL comme valeur par défaut.

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

  'jdoe' ou 'jdoe@xyz.com'

  [!REMARQUE]

  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. pager_address est de type narchar(100), avec NULL comme valeur par défaut.

• [ @weekday_pager_start_time= ] weekday_pager_start_time
  Heure après laquelle l'Agent SQL Server envoie la notification de radiomessagerie à l'opérateur spécifié. Cette opération a lieu durant les jours de la semaine, du lundi au vendredi. weekday_pager_start_time* *est de type int, avec 090000 comme valeur par défaut qui indique 9h00 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. weekday_pager_end_timeest de type int, avec 180000 comme valeur par défaut qui indique 18h00 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. saturday_pager_start_time est de type int, avec 090000 comme valeur par défaut qui indique 9h00 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. saturday_pager_end_timeest de type int, avec 180000 comme valeur par défaut qui indique 18h00 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. sunday_pager_start_timeest de type int, avec 090000 comme valeur par défaut qui indique 9h00 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. sunday_pager_end_timeest de type int, avec 180000 comme valeur par défaut qui indique 18h00 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). 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 réseau. 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. 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 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

Voir aussi

Référence

sp_delete_operator (Transact-SQL)

sp_help_operator (Transact-SQL)

sp_update_operator (Transact-SQL)

Procédures stockées système (Transact-SQL)