(0) exportieren Drucken
Alle erweitern
Erweitern Minimieren

sp_add_operator (Transact-SQL)

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


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

[ @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 physikalische E-Mail-Adresse oder einen Alias angeben. Beispiel:

'jdoe' oder 'jdoe@xyz.com'

[ @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 Microsoft SQL Server-Agent von Montag bis Freitag Pagerbenachrichtigungen an den angegebenen Operator sendet. weekday_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.

[ @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_time ist 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_time ist 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_time ist 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_days ist 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_days wird 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_address ist 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.

0 (Erfolg) oder 1 (Fehler)

Keine

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 lassen sich Aufträge auf einfache Weise mit einer grafischen Oberfläche verwalten. Dies ist die empfohlene Vorgehensweise zum Erstellen und Verwalten der Auftragsinfrastruktur.

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

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

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft