sp_help_operator (Transact-SQL)

Gibt Informationen zu den für den Server definierten Operatoren zurück.

Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

• [ @operator_name= ] 'operator_name'
  Der Name des Operators. operator_name ist vom Datentyp sysname. Falls operator_name nicht angegeben wird, werden Informationen zu allen Operatoren zurückgegeben.

• [ @operator_id= ] operator_id
  Die ID des Operators, für den Informationen angefordert werden. operator_idist vom Datentyp int. Der Standardwert ist NULL.

  Hinweis
  Es muss entweder operator_id oder operator_name angegeben werden, aber beide Angaben sind nicht möglich.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Resultsets

Spaltenname	Datentyp	Beschreibung
id	int	ID des Operators.
name	sysname	Name des Operators.
enabled	tinyint	Operator steht für den Empfang von Benachrichtigungen zur Verfügung: 1 = Ja 0 = Nein
email_address	nvarchar(100)	E-Mail-Adresse des Operators.
last_email_date	int	Datum, an dem der Operator zuletzt per E-Mail benachrichtigt wurde.
last_email_time	int	Uhrzeit, zu der der Operator zuletzt per E-Mail benachrichtigt wurde.
pager_address	nvarchar(100)	Pageradresse des Operators.
last_pager_date	int	Datum, an dem der Operator zuletzt per Pager benachrichtigt wurde.
last_pager_time	int	Uhrzeit, zu der der Operator zuletzt per Pager benachrichtigt wurde.
weekday_pager_start_time	int	Der Beginn des Zeitraums, während dessen der Operator an Arbeitstagen zur Verfügung steht, um Pagerbenachrichtigungen zu empfangen.
weekday_pager_end_time	int	Das Ende des Zeitraums, während dessen der Operator an Arbeitstagen zur Verfügung steht, um Pagerbenachrichtigungen zu empfangen.
saturday_pager_start_time	int	Der Beginn des Zeitraums, während dessen der Operator an Samstagen zur Verfügung steht, um Pagerbenachrichtigungen zu empfangen.
saturday_pager_end_time	int	Das Ende des Zeitraums, während dessen der Operator an Samstagen zur Verfügung steht, um Pagerbenachrichtigungen zu empfangen.
sunday_pager_start_time	int	Der Beginn des Zeitraums, während dessen der Operator an Sonntagen zur Verfügung steht, um Pagerbenachrichtigungen zu empfangen.
sunday_pager_end_time	int	Das Ende des Zeitraums, während dessen der Operator an Sonntagen zur Verfügung steht, um Pagerbenachrichtigungen zu empfangen.
pager_days	tinyint	Eine Bitmaske (1 = Sonntag, 64 = Samstag) der Arbeitstage, die anzeigt, wann der Operator zur Verfügung steht, um Pagerbenachrichtigungen zu empfangen.
netsend_address	nvarchar(100)	Operatoradresse für Benachrichtigungen per Netzwerk-Popupnachricht.
last_netsend_date	int	Datum, an dem der Operator zuletzt per Netzwerk-Popupnachricht benachrichtigt wurde.
last_netsend_time	int	Uhrzeit, zu der der Operator zuletzt per Netzwerk-Popupnachricht benachrichtigt wurde.
category_name	sysname	Name der Operatorkategorie, zu der dieser Operator gehört.

Hinweise

sp_help_operator muss in der msdb-Datenbank ausgeführt werden.

Berechtigungen

Standardmäßig können nur Mitglieder der festen Serverrolle sysadmin diese gespeicherte Prozedur ausführen. Anderen Benutzern muss eine der folgenden festen Datenbankrollen des SQL Server-Agents in der msdb-Datenbank zugewiesen werden:

• SQLAgentUserRole

• SQLAgentReaderRole

• SQLAgentOperatorRole

Weitere Informationen zu den Berechtigungen dieser Rollen finden Sie unter Feste Datenbankrollen des SQL Server-Agents.

Beispiele

Im folgenden Beispiel werden Informationen zum François Ajenstat-Operator ausgegeben.

USE msdb ;
GO

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

Siehe auch

Verweis

sp_add_operator (Transact-SQL)

sp_delete_operator (Transact-SQL)

sp_update_operator (Transact-SQL)

Gespeicherte Systemprozeduren (Transact-SQL)