sp_help_operator (Transact-SQL)

Fournit des informations sur les opérateurs définis pour le serveur.

Icône Lien de rubriqueConventions de la syntaxe de Transact-SQL

Syntaxe

sp_help_operator
     { [ @operator_name = ] 'operator_name' 
     | [ @operator_id = ] operator_id }

Arguments

  • [ @operator_name= ] 'operator_name'
    Nom de l'opérateur. operator_name est de type sysname. Si operator_name n’est pas spécifié, des informations sur tous les opérateurs sont renvoyées.

  • [ @operator_id= ] operator_id
    Numéro d'identification de l'opérateur dont il faut obtenir des informations. operator_idest de type int, avec NULL comme valeur par défaut.

    [!REMARQUE]

    Vous devez définir la valeur de operator_id ou de operator_name, mais pas les deux valeurs à la fois.

Valeurs des codes renvoyés

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

Jeux de résultats

Nom de colonne

Type de données

Description

id

int

Numéro d'identification de l'opérateur.

name

sysname

Nom de l'opérateur.

enabled

tinyint

L'opérateur est disponible pour recevoir des notifications :

1 = Oui

0 = Non

email_address

nvarchar(100)

Adresse de messagerie de l'opérateur.

last_email_date

int

Date de la dernière notification envoyée par courrier électronique à l'opérateur.

last_email_time

int

Heure de la dernière notification envoyée par courrier électronique à l'opérateur.

pager_address

nvarchar(100)

Adresse de radiomessagerie de l'opérateur.

last_pager_date

int

Date de la dernière notification envoyée par radiomessagerie à l'opérateur.

last_pager_time

int

Heure de la dernière notification envoyée par radiomessagerie à l'opérateur.

weekday_pager_start_time

int

Début de la période pendant laquelle l'opérateur peut recevoir des notifications par radiomessagerie pendant la semaine.

weekday_pager_end_time

int

Fin de la période pendant laquelle l'opérateur peut recevoir des notifications par radiomessagerie pendant la semaine.

saturday_pager_start_time

int

Début de la période pendant laquelle l'opérateur peut recevoir des notifications par radiomessagerie le samedi.

saturday_pager_end_time

int

Fin de la période pendant laquelle l'opérateur peut recevoir des notifications par radiomessagerie le samedi.

sunday_pager_start_time

int

Début de la période pendant laquelle l'opérateur peut recevoir des notifications par radiomessagerie le dimanche.

sunday_pager_end_time

int

Fin de la période pendant laquelle l'opérateur peut recevoir des notifications par radiomessagerie le dimanche.

pager_days

tinyint

Masque de bits (1 = dimanche, 64 = samedi) indiquant les jours de la semaine où l'opérateur peut recevoir des notifications par radiomessagerie.

netsend_address

nvarchar(100)

Adresse de l'opérateur pour les notifications envoyées par le réseau

last_netsend_date

int

Date de la dernière notification envoyée à l'opérateur via le réseau.

last_netsend_time

int

Heure de la dernière notification envoyée à l'opérateur via le réseau.

category_name

sysname

Nom de la catégorie à laquelle appartient cet opérateur.

Notes

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

Autorisations

Seuls les membres du rôle de serveur fixe sysadmin peuvent exécuter cette procédure stockée. Les autres utilisateurs doivent disposer de l'un des rôles de base de données fixes SQL Server Agent suivants dans la base de données msdb.

  • SQLAgentUserRole

  • SQLAgentReaderRole

  • SQLAgentOperatorRole

Pour en savoir plus sur les autorisations de ces rôles, consultez Rôles de base de données fixes de l'Agent SQL Server.

Exemple

Cet exemple vous renseigne sur l'opérateur François Ajenstat.

USE msdb ;
GO

EXEC dbo.sp_help_operator
    @operator_name = N'François Ajenstat' ;
GO