sp_help_operator (Transact-SQL)

Gilt für: SQL Server

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

Transact-SQL-Syntaxkonventionen

Syntax

sp_help_operator
    [ [ @operator_name = ] N'operator_name' ]
    [ , [ @operator_id = ] operator_id ]
[ ; ]

Argumente

[ @operator_name = ] N'operator_name'

Der Operatorname. @operator_name ist "sysname" mit dem Standardwert "NULL. Wenn @operator_name nicht angegeben ist, werden Informationen zu allen Operatoren zurückgegeben.

Entweder @operator_id oder @operator_name müssen angegeben werden, beide können jedoch nicht angegeben werden.

[ @operator_id = ] operator_id

Die ID des Operators, für den Informationen angefordert werden. @operator_id ist int mit einem Standardwert von NULL.

Entweder @operator_id oder @operator_name müssen angegeben werden, beide können jedoch nicht angegeben werden.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Resultset

Spaltenname Datentyp BESCHREIBUNG
id int Identifikationsnummer des Operators.
name sysname Operatorname.
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) von Tagen der Woche, die angibt, wann der Operator für den Empfang von Pagerbenachrichtigungen verfügbar ist.
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 aus der msdb Datenbank ausgeführt werden.

Berechtigungen

Diese gespeicherte Prozedur gehört der db_owner Rolle. Sie können berechtigungen für jeden Benutzer erteilen EXECUTE , diese Berechtigungen können jedoch während eines SQL Server-Upgrades außer Kraft gesetzt werden.

Anderen Benutzern muss eine der folgenden SQL Server-Agent festen Datenbankrollen in der msdb Datenbank gewährt 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