Teilen über


sp_add_operator (Transact-SQL)

Gilt für:SQL ServerAzure SQL Managed Instance

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

Transact-SQL-Syntaxkonventionen

Syntax

dbo.sp_add_operator
    [ @name = ] N'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 = ] N'category_name' ]
[ ; ]

Argumente

[ @name = ] N'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. Zum 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 Startzeit, wenn der SQL Server Agent-Dienst Pager-Benachrichtigungen an den Bediener 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 Endzeit, wenn der SQL Server Agent-Dienst keine Pager-Benachrichtigungen mehr an den Bediener sendet, von Montag bis Freitag. @weekday_pager_end_time ist int, mit einem Standardwert , 180000was 18:00 Uhr auf einer 24-Stunden-Uhr anzeigt, und muss über das Formular HHmmsseingegeben werden.

[ @saturday_pager_start_time = ] saturday_pager_start_time

Die Startzeit ist samstags, wenn der SQL Server Agent-Dienst Pager-Benachrichtigungen an den Bediener sendet. @saturday_pager_start_time ist int, mit einem Standardwert von 090000, was 9:00 Uhr auf einer 24-Stunden-Uhr anzeigt, und muss über das Formular HHmmsseingegeben werden.

[ @saturday_pager_end_time = ] saturday_pager_end_time

Die Endzeit an Samstagen, wenn der SQL Server Agent-Dienst keine Pager-Benachrichtigungen mehr an den Bediener 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 Startzeit an Sonntagen, wenn der SQL Server Agent-Dienst Pager-Benachrichtigungen an den Bediener 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 Endzeit an Sonntagen, wenn der SQL Server Agent-Dienst keine Pager-Benachrichtigungen mehr an den Bediener 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, mit einer Standardeinstellung von 0, die anzeigt, 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 Tuesday
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 = ] N'category_name'

Der Name der Kategorie für diesen Operator. NULL

Ist dieser Wert NULL, wird der Operator mit einer Standardkategorie von [Uncategorized]hinzugefügt. Sie können auch aus einer bestehenden Kategorie wählen, indem Sie die syscategories Tabelle in der msdb Datenbank abfragen:

SELECT name
FROM msdb.dbo.syscategories;

Rückgabecodewerte

0 (erfolgreich) 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

Sie können Berechtigungen für dieses Verfahren erteilen EXECUTE , aber diese Berechtigungen können 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

EXECUTE 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