sp_add_operator (Transact-SQL)

Erstellt einen Operator (Benachrichtigungsempfänger) für Warnungen und Aufträge.

Themenlink (Symbol)Transact-SQL-Syntaxkonventionen

Syntax

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' ] 

Argumente

  • [ @name= ] 'name'
    Der Name eines Operators (Benachrichtigungsempfänger). Dieser Name muss eindeutig sein und darf kein Prozentzeichen (%) enthalten. name ist vom Datentyp sysname und weist keinen Standardwert auf.

  • [ @enabled= ] enabled
    Gibt den aktuellen Status des Operators an. enabled ist ein Wert vom Datentyp tinyint und weist den Standardwert 1 (aktiviert) auf. Bei dem Wert 0 wird der Operator nicht aktiviert und empfängt keine Benachrichtigungen.

  • [ @email_address= ] 'email_address'
    Die E-Mail-Adresse des Operators. Diese Zeichenfolge wird direkt an das E-Mail-System übergeben. email_address ist ein Wert vom Datentyp nvarchar(100) und weist den Standardwert NULL auf.

    Für email_address können Sie entweder eine physische E-Mail-Adresse oder einen Alias angeben. Beispielsweise:

    'jdoe' oder 'jdoe@xyz.com'

    HinweisHinweis

    Ein E-Mail-Alias kann nur für SQL Mail verwendet werden. Die E-Mail-Adresse muss für Datenbank-E-Mail verwendet werden.

  • [ @pager_address= ] 'pager_address'
    Gibt die Pageradresse des Operators an. Diese Zeichenfolge wird direkt an das E-Mail-System übergeben. pager_address ist ein Wert vom Datentyp narchar(100) und weist den Standardwert NULL auf.

  • [ @weekday_pager_start_time= ] weekday_pager_start_time
    Die Angabe der Uhrzeit, nach der SQL Server-Agent von Montag bis Freitag Pagerbenachrichtigungen an den angegebenen Operator sendet. weekday_pager_start_timeist ein Wert vom Datentyp int und weist den Standardwert 090000 auf, womit 9:00 Uhr des 24-Stunden-Systems gemeint ist. Der Wert muss im Format HHMMSS eingegeben werden.

  • [ @weekday_pager_end_time= ] weekday_pager_end_time
    Die Angabe der Uhrzeit, nach der der SQLServerAgent-Dienst von Montag bis Freitag keine Pagerbenachrichtigungen mehr an den angegebenen Operator sendet. weekday_pager_end_timeist ein Wert vom Datentyp int und weist den Standardwert 180000 auf, womit 18:00 Uhr des 24-Stunden-Systems gemeint ist. Der Wert muss im Format HHMMSS eingegeben werden.

  • [ @saturday_pager_start_time =] saturday_pager_start_time
    Die Angabe der Uhrzeit, nach der der SQLServerAgent-Dienst an Samstagen Pagerbenachrichtigungen an den angegebenen Operator sendet. saturday_pager_start_time ist ein Wert vom Datentyp int und weist den Standardwert 090000 auf, womit 9:00 Uhr des 24-Stunden-Systems gemeint ist. Der Wert muss im Format HHMMSS eingegeben werden.

  • [ @saturday_pager_end_time= ] saturday_pager_end_time
    Die Angabe der Uhrzeit, nach der der SQLServerAgent-Dienst an Samstagen keine Pagerbenachrichtigungen mehr an den angegebenen Operator sendet. saturday_pager_end_timeist ein Wert vom Datentyp int und weist den Standardwert 180000 auf, womit 18:00 Uhr des 24-Stunden-Systems gemeint ist. Der Wert muss im Format HHMMSS eingegeben werden.

  • [ @sunday_pager_start_time= ] sunday_pager_start_time
    Die Angabe der Uhrzeit, nach der der SQLServerAgent-Dienst an Sonntagen Pagerbenachrichtigungen an den angegebenen Operator sendet. sunday_pager_start_time ist ein Wert vom Datentyp int und weist den Standardwert 090000 auf, womit 9:00 Uhr des 24-Stunden-Systems gemeint ist. Der Wert muss im Format HHMMSS eingegeben werden.

  • [ @sunday_pager_end_time =] sunday_pager_end_time
    Die Angabe der Uhrzeit, nach der der SQLServerAgent-Dienst an Sonntagen keine Pagerbenachrichtigungen mehr an den angegebenen Operator sendet. sunday_pager_end_timeist ein Wert vom Datentyp int und weist den Standardwert 180000 auf, womit 18:00 Uhr des 24-Stunden-Systems gemeint ist. Der Wert muss im Format HHMMSS eingegeben werden.

  • [ @pager_days= ] pager_days
    Mit dieser Zahl werden die Tage angegeben, an denen der Operator für den Empfang von Pagerbenachrichtigungen zur Verfügung steht (in Abhängigkeit vom angegebenen Start-/Beendigungszeitpunkt). pager_daysist ein Wert vom Datentyp tinyint und weist den Standardwert 0 auf, womit angegeben wird, dass der Operator nie für den Empfang von Pagerbenachrichtigungen verfügbar ist. Es sind Werte von 0 bis 127 zulässig. pager_dayswird berechnet, indem die einzelnen Werte für die erforderlichen Tage addiert werden. Beispiel: Die Angabe von Montag bis Freitag lautet 2+4+8+16+32 = 62. In der folgenden Tabelle werden die Werte für die einzelnen Wochentage aufgelistet.

    Wert

    Beschreibung

    1

    Sonntag

    2

    Montag

    4

    Dienstag

    8

    Mittwoch

    16

    Donnerstag

    32

    Freitag

    64

    Samstag

  • [ @netsend_address= ] 'netsend_address'
    Die Netzwerkadresse des Operators, an den die Netzwerknachricht gesendet wird. netsend_addressist ein Wert vom Datentyp nvarchar(100) und weist den Standardwert NULL auf.

  • [ @category_name= ] 'category'
    Der Name der Kategorie für diesen Operator. category ist ein Wert vom Datentyp sysname und weist den Standardwert NULL auf.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Resultsets

Keine

Hinweise

sp_add_operator muss von der msdb-Datenbank aus ausgeführt werden.

Pagerbenachrichtigungen werden mithilfe des E-Mail-Systems durchgeführt. Daher muss das zugrunde liegende E-Mail-System in der Lage sein, Nachrichten an Pager zu senden.

Mit SQL Server Management Studio können Aufträge problemlos mithilfe einer grafischen Oberfläche verwaltet werden. Dies ist die empfohlene Vorgehensweise für die Erstellung und Verwaltung der Auftragsinfrastruktur.

Berechtigungen

Nur Mitglieder der festen Serverrolle sysadmin können sp_add_operator ausführen.

Beispiele

Im folgenden Beispiel werden die Operatorinformationen für danwi eingerichtet. Der Operator ist aktiviert. SQL Server-Agent sendet Pagerbenachrichtigungen von Montag bis Freitag zwischen 8:00 und 17:00 Uhr.

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