Udostępnij za pomocą

sp_add_operator (Transact-SQL)

Dotyczy:SQL ServerAzure SQL Managed Instance

Tworzy operatora (odbiorcę powiadomień) do użycia z alertami i zadaniami.

Transact-SQL konwencje składni

Składnia

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'imię'

Nazwa operatora (odbiorcy powiadomienia). Ta nazwa musi być unikalna i nie może zawierać znaku procent (%). @name to nazwa sysname, bez domyślnego ustawienia.

[ @enabled = ] włączone

Wskazuje aktualny status operatora. @enabled jest tinyint, z domyślnym ( 1 włączonym). Jeśli 0, operator nie jest włączony i nie otrzymuje powiadomień.

[ @email_address = ] N'email_address'

Adres e-mail operatora. Ten ciąg jest przekazywany bezpośrednio do systemu pocztowego. @email_address to nvarchar(100), z domyślnym obciążeniem NULL.

Możesz podać fizyczny adres e-mail lub alias @email_address. Przykład:

fatmir.bregu lub fatmir.bregu@contoso.com

Uwaga / Notatka

Musisz użyć adresu e-mail do Database Mail.

[ @pager_address = ] N'pager_address'

Adres pagera operatora. Ten ciąg jest przekazywany bezpośrednio do systemu pocztowego. @pager_address to nvarchar(100), z domyślnym obciążeniem NULL.

[ @weekday_pager_start_time = ] weekday_pager_start_time

Czas rozpoczęcia, gdy usługa SQL Server Agent wysyła powiadomienia z pagerów do operatora, od poniedziałku do piątku. @weekday_pager_start_time jest int, z domyślnym , 090000co oznacza 9:00 rano na zegarze 24-godzinnym, i musi być wpisany za pomocą formularza HHmmss.

[ @weekday_pager_end_time = ] weekday_pager_end_time

Czas, gdy usługa SQL Server Agent przestała wysyłać powiadomienia z pagerów do operatora, od poniedziałku do piątku. @weekday_pager_end_time jest int, z domyślną wartością 180000, co oznacza godzinę 18:00 na zegarze 24-godzinnym, i musi zostać wprowadzone za pomocą formularza HHmmss.

[ @saturday_pager_start_time = ] saturday_pager_start_time

Czas startu w soboty, kiedy usługa SQL Server Agent wysyła powiadomienia pagerów do operatora. @saturday_pager_start_time jest int, z domyślnym , 090000co oznacza godzinę 9:00 rano na zegarze 24-godzinnym, i musi zostać wprowadzone za pomocą formularza HHmmss.

[ @saturday_pager_end_time = ] saturday_pager_end_time

Koniec w soboty, gdy usługa SQL Server Agent przestała wysyłać powiadomienia pagerów do operatora. @saturday_pager_end_time jest int, z domyślną wartością 180000, co oznacza godzinę 18:00 na zegarze 24-godzinnym, i musi być wpisane za pomocą formularza HHmmss.

[ @sunday_pager_start_time = ] sunday_pager_start_time

Godzina rozpoczęcia w niedziele, kiedy usługa SQL Server Agent wysyła powiadomienia pagerowe do operatora. @sunday_pager_start_time jest int, z domyślnym , 090000co oznacza 9:00 rano na zegarze 24-godzinnym, i musi zostać wprowadzone za pomocą formularza HHmmss.

[ @sunday_pager_end_time = ] sunday_pager_end_time

Koniec w niedziele, kiedy usługa SQL Server Agent przestała wysyłać powiadomienia z pagerów do operatora. @sunday_pager_end_time jest int, z domyślnym , 180000co oznacza godzinę 18:00 na zegarze 24-godzinnym, i musi zostać wprowadzone za pomocą formularza HHmmss.

[ @pager_days = ] pager_days

Liczba wskazująca dni, w których operator jest dostępny dla stron (z zastrzeżeniem określonych godzin rozpoczęcia/końca). @pager_days jest tinyint, z domyślnym , 0co oznacza, że operator nigdy nie jest dostępny do odebrania strony. Poprawne wartości to od 0 do 127. @pager_days oblicza się przez dodanie indywidualnych wartości dla wymaganych dni. Na przykład od poniedziałku do piątku jest .2 + 4 + 8 + 16 + 32 = 62

Poniższa tabela przedstawia wartość dla każdego dnia tygodnia.

Wartość Description
1 Niedziela
2 Monday
4 Wtorek
8 Wednesday
16 Czwartek
32 Piątek
64 Sobota

[ @netsend_address = ] N'netsend_address'

Adres sieciowy operatora, do którego wysyłana jest wiadomość sieciowa. @netsend_address to nvarchar(100), z domyślnym obciążeniem NULL.

[ @category_name = ] N'category_name'

Nazwa kategorii tego operatora. @category_name jest nazwą systemu z domyślnym .NULL

Jeśli ta wartość to NULL, operator dodaje się domyślną kategorię [Uncategorized]. Możesz także wybrać jedną z istniejących kategorii, zapytując tabelę syscategories w bazie msdb danych:

SELECT name
FROM msdb.dbo.syscategories;

Zwracanie wartości kodu

0 (powodzenie) lub 1 (niepowodzenie).

Zestaw wyników

Żaden.

Uwagi

sp_add_operator musi być uruchamiany z bazy msdb danych.

Twój system poczty elektronicznej musi mieć funkcję e-mail-to-pager, jeśli chcesz korzystać z pagowania.

Program SQL Server Management Studio zapewnia łatwy, graficzny sposób zarządzania zadaniami i jest zalecanym sposobem tworzenia infrastruktury zadań i zarządzania nią.

Permissions

Możesz przyznać EXECUTE uprawnienia tej procedurze, ale mogą one zostać nadpisane podczas aktualizacji SQL Server.

Przykłady

Poniższy przykład ustawia informację operatora dla danwi. Operator jest włączony. SQL Server Agent wysyła powiadomienia pagerem od poniedziałku do piątku w godzinach 8:00–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

Treści powiązane

  • Last updated on