sp_add_operator (Transact-SQL)

  • Artikel

Gilt für:SQL ServerAzure SQL Managed Instance

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

Transact-SQL-Syntaxkonventionen

Syntax

sp_add_operator
    [ @name = ] 'name'
    [ , [ @enabled = ] enabled ]
    [ , [ @email_address = ] N'email_address' ]
    [ , [ @pager_address = ] N'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 = ] N'netsend_address' ]
    [ , [ @category_name = ] 'category' ]
[ ; ]

Argumente

[ @name = ] 'name'

Der Name eines Operators (Benachrichtigungsempfänger). Dieser Name muss eindeutig sein und darf das Prozentzeichen (%) nicht enthalten. @name ist "sysname" ohne Standard.

[ @enabled = ] aktiviert

Gibt den aktuellen Status des Operators an. @enabled ist winzig, mit einem Standardwert von 1 (aktiviert). Wenn 0der Operator nicht aktiviert ist und keine Benachrichtigungen empfängt.

[ @email_address = ] N'email_address'

Die E-Mail-Adresse des Operators. Diese Zeichenfolge wird direkt an das E-Mail-System übergeben. @email_address ist nvarchar(100), wobei die Standardeinstellung istNULL.

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

fatmir.bregu oder fatmir.bregu@contoso.com

Hinweis

Für Datenbank-E-Mail muss die E-Mail-Adresse verwendet werden.

[ @pager_address = ] N'pager_address'

Gibt die Pageradresse des Operators an. Diese Zeichenfolge wird direkt an das E-Mail-System übergeben. @pager_address ist nvarchar(100), wobei die Standardeinstellung istNULL.

[ @weekday_pager_start_time = ] weekday_pager_start_time

Die Zeit, nach der SQL Server-Agent die Pager-Benachrichtigung an den angegebenen Operator an den Wochentag sendet, von Montag bis Freitag. @weekday_pager_start_time ist int, mit einem Standardwert von 090000, der 9:00 Uhr auf einer 24-Stunden-Uhr angibt und mit dem Formular HHmmsseingegeben werden muss.

[ @weekday_pager_end_time = ] weekday_pager_end_time

Die Zeit, nach der SQL Server-Agent Dienst keine Pager-Benachrichtigung mehr an den angegebenen Operator an den Wochentag sendet, von Montag bis Freitag. weekday_pager_end_time ist int, mit einem Standardwert von 180000, der 16:00 Uhr auf einer 24-Stunden-Uhr angibt und mit dem Formular HHmmsseingegeben werden muss.

[ @saturday_pager_start_time = ] saturday_pager_start_time

Die Zeit, nach der SQL Server-Agent Dienst pager-Benachrichtigungen an den angegebenen Operator an Samstagen sendet. saturday_pager_start_time ist int, mit einem Standardwert von 090000, der 9:00 Uhr auf einer 24-Stunden-Uhr angibt und mit dem Formular HHmmsseingegeben werden muss.

[ @saturday_pager_end_time = ] saturday_pager_end_time

Die Zeit, nach der SQL Server-Agent Dienst keine Pager-Benachrichtigung mehr an den angegebenen Operator an Samstage sendet. @saturday_pager_end_time ist int, mit einem Standardwert von 180000, der 16:00 Uhr auf einer 24-Stunden-Uhr angibt und mit dem Formular HHmmsseingegeben werden muss.

[ @sunday_pager_start_time = ] sunday_pager_start_time

Die Zeit, nach der SQL Server-Agent Dienst die Pager-Benachrichtigung an den angegebenen Operator an Sonntage sendet. @sunday_pager_start_time ist int, mit einem Standardwert von 090000, der 9:00 Uhr auf einer 24-Stunden-Uhr angibt und mit dem Formular HHmmsseingegeben werden muss.

[ @sunday_pager_end_time = ] sunday_pager_end_time

Die Zeit, nach der SQL Server-Agent Dienst keine Pager-Benachrichtigung mehr an den angegebenen Operator an Sonntage sendet. @sunday_pager_end_time ist int, mit einem Standardwert von 180000, der 16:00 Uhr auf einer 24-Stunden-Uhr angibt und mit dem Formular HHmmsseingegeben werden muss.

[ @pager_days = ] pager_days

Eine Zahl, die die Tage angibt, an denen der Operator für Seiten verfügbar ist (vorbehaltlich der angegebenen Start-/Endzeiten). @pager_days ist tinyint, wobei standardmäßig 0 angegeben wird, dass der Operator nie verfügbar ist, um eine Seite zu empfangen. Gültige Werte sind von 0 bis 127. @pager_days wird berechnet, indem die einzelnen Werte für die erforderlichen Tage hinzugefügt werden. Beispiel: Von Montag bis Freitag ist 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 = ] N'netsend_address'

Die Netzwerkadresse des Operators, an die die Netzwerknachricht gesendet wird. @netsend_address ist "nvarchar(100)" mit der Standardeinstellung "NULL.

[ @category_name = ] 'category'

Der Name der Kategorie für diesen Operator. @category_name ist "sysname" mit der Standardeinstellung "NULL.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler).

Resultset

Keine.

Hinweise

sp_add_operator muss aus der msdb Datenbank ausgeführt werden.

Ihr E-Mail-System muss über eine E-Mail-zu-Pager-Funktion verfügen, wenn Sie Paging verwenden möchten.

SQL Server Management Studio bietet eine einfache grafische Möglichkeit zum Verwalten von Aufträgen. Es handelt sich hierbei um die empfohlene Art und Weise zum Erstellen und Verwalten der Auftragsinfrastruktur.

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.

Beispiele

Im folgenden Beispiel werden die Operatorinformationen für danwi eingerichtet. Der Operator ist aktiviert. SQL Server-Agent sendet Benachrichtigungen von Pager von Montag bis Freitag von 8:00 bis 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

Zugehöriger Inhalt