Sdílet prostřednictvím


sp_add_operator (Transact-SQL)

platí pro:SQL Serverazure SQL Managed Instance

Vytváří operátora (příjemce oznámení) pro použití s upozorněními a úkoly.

Transact-SQL konvence syntaxe

Syntaxe

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

Arguments

[ @name = ] N'jméno'

Jméno operátora (příjemce oznámení). Tento název musí být jedinečný a nesmí obsahovat procento znaku (%). @name je sysname, bez výchozího nastavení.

[ @enabled = ] povoleno

Ukazuje aktuální stav operátora. @enabled je tinyint, s výchozím nastavením 1 (povoleno). Pokud 0, operátor není povolen a nedostává notifikace.

[ @email_address = ] N'email_address'

E-mailová adresa operátora. Tento řetězec je předáván přímo e-mailovému systému. @email_address je nvarchar(100), s výchozím hodnotou NULL.

Můžete zadat buď fyzickou e-mailovou adresu, nebo alias pro @email_address. Například:

fatmir.bregu nebo fatmir.bregu@contoso.com

Poznámka:

Musíte použít e-mailovou adresu pro databázovou poštu.

[ @pager_address = ] N'pager_address'

Adresa pageru operátora. Tento řetězec je předáván přímo e-mailovému systému. @pager_address je nvarchar(100), s výchozím hodnotou NULL.

[ @weekday_pager_start_time = ] weekday_pager_start_time

Čas začátku, kdy služba SQL Server Agent posílá operátorovi upozornění na pagery, od pondělí do pátku. @weekday_pager_start_time je int, s výchozím , 090000což znamená 9:00 ráno na 24hodinovém hodinovém systému, a musí být zadán pomocí formuláře HHmmss.

[ @weekday_pager_end_time = ] weekday_pager_end_time

Konec služby, kdy služba SQL Server Agent již neposílá operátorovi oznámení o pageru, od pondělí do pátku. @weekday_pager_end_time je int, s výchozím 180000, což označuje 18:00 na 24hodinovém hodinovém systému, a musí být zadán pomocí formuláře HHmmss.

[ @saturday_pager_start_time = ] saturday_pager_start_time

Čas spuštění v sobotu, kdy služba SQL Server Agent posílá operátorovi upozornění na pagery. @saturday_pager_start_time je int, s výchozím , 090000což označuje 9:00 ráno na 24hodinovém hodinovém systému, a musí být zadán pomocí formuláře HHmmss.

[ @saturday_pager_end_time = ] saturday_pager_end_time

Konec soboty, kdy služba SQL Server Agent již neposílá operátorovi oznámení o pagerech. @saturday_pager_end_time je int, s výchozím , 180000což ukazuje 18:00 na 24hodinovém hodinovém časomíru, a musí být zadán pomocí formuláře HHmmss.

[ @sunday_pager_start_time = ] sunday_pager_start_time

Čas spuštění v neděli, kdy služba SQL Server Agent posílá operátorovi upozornění na pagery. @sunday_pager_start_time je int, s výchozím , 090000což označuje 9:00 ráno na 24hodinovém hodinovém systému, a musí být zadán pomocí formuláře HHmmss.

[ @sunday_pager_end_time = ] sunday_pager_end_time

Konec v neděli, kdy služba SQL Server Agent již neposílá operátorovi oznámení o pageru. @sunday_pager_end_time je int, s výchozím , 180000což označuje 18:00 na 24hodinovém hodinovém časomíru, a musí být zadán pomocí formuláře HHmmss.

[ @pager_days = ] pager_days

Číslo, které označuje dny, kdy je operátor k dispozici pro stránky (s ohledem na stanovené časy začátku/konce). @pager_days je tinyint, s výchozím nastavením 0, což znamená, že operátor nikdy není k dispozici pro přijetí stránky. Platné hodnoty jsou od 0 až po 127. @pager_days se počítá sečtením jednotlivých hodnot za požadované dny. Například od pondělí do pátku je .2 + 4 + 8 + 16 + 32 = 62

Následující tabulka uvádí hodnotu pro každý den v týdnu.

Hodnota Description
1 Neděle
2 Monday
4 Úterý
8 Wednesday
16 Čtvrtek
32 Pátek
64 Sobota

[ @netsend_address = ] N'netsend_address'

Síťová adresa operátora, kterému je síťová zpráva odeslána. @netsend_address je nvarchar(100), s výchozím hodnotou NULL.

[ @category_name = ] N'category_name'

Název kategorie tohoto operátora. @category_name je sysname, s výchozím nastavením NULL.

Pokud je tato hodnota , NULLoperátor se přičte s výchozí kategorií .[Uncategorized] Můžete si také vybrat z existující kategorie dotazováním syscategories tabulky v databázi msdb :

SELECT name
FROM msdb.dbo.syscategories;

Hodnoty návratového kódu

0 (úspěch) nebo 1 (selhání).

Sada výsledků

Žádné.

Poznámky

sp_add_operator musí být spuštěna z databáze msdb .

Váš e-mailový systém musí mít funkci e-mail-to-pager, pokud chcete používat stránkování.

SQL Server Management Studio poskytuje snadný, grafický způsob správy úloh a je doporučený způsob, jak vytvořit a spravovat infrastrukturu úloh.

Povolení

Na tomto postupu můžete udělit EXECUTE oprávnění, ale tato oprávnění mohou být během upgradu SQL Serveru přepsána.

Examples

Následující příklad nastavuje informace o operátoru pro danwi. Operátor je povolen. SQL Server Agent posílá oznámení pagerem od pondělí do pátku od 8:00 do 17:00.

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