Dela via

sp_add_operator (Transact-SQL)

gäller för:SQL ServerAzure SQL Managed Instance

Skapar en operatör (mottagare av notiser) för användning med aviseringar och jobb.

Transact-SQL syntaxkonventioner

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

Arguments

[ @name = ] N'namn'

Namnet på en operatör (mottagare av notifikationen). Detta namn måste vara unikt och får inte innehålla procentuellt tecken (%). @name är sysname, utan standard.

[ @enabled = ] aktiverat

Indikerar operatörens nuvarande status. @enabled är Tinyint, med standardinställningen ( 1 aktiverad). Om 0, är operatören inte aktiverad och får inga notiser.

[ @email_address = ] N'email_address'

Operatörens e-postadress. Denna sträng skickas direkt till e-postsystemet. @email_address är nvarchar(100), med en standard på NULL.

Du kan ange antingen en fysisk e-postadress eller ett alias för @email_address. Till exempel:

fatmir.bregu eller fatmir.bregu@contoso.com

Anmärkning

Du måste använda e-postadressen för databaspost.

[ @pager_address = ] N'pager_address'

Personsökarens adress. Denna sträng skickas direkt till e-postsystemet. @pager_address är nvarchar(100), med standardvärdet .NULL

[ @weekday_pager_start_time = ] weekday_pager_start_time

Starttiden när SQL Server Agent-tjänsten skickar personsökarnotiser till operatören, från måndag till fredag. @weekday_pager_start_time är int, med standardvärdet , 090000vilket indikerar 09:00 på en 24-timmarsklocka, och måste anges med formuläret HHmmss.

[ @weekday_pager_end_time = ] weekday_pager_end_time

Sluttiden när SQL Server Agent-tjänsten inte längre skickar personsökarnotiser till operatören, från måndag till fredag. @weekday_pager_end_time är int, med standardvärdet , 180000vilket indikerar klockan 18:00 på en 24-timmarsklocka, och måste anges med formuläret HHmmss.

[ @saturday_pager_start_time = ] saturday_pager_start_time

Starttiden är på lördagar när SQL Server Agent-tjänsten skickar personsökarnotiser till operatören. @saturday_pager_start_time är int, med standardvärdet , 090000vilket indikerar 09:00 på en 24-timmarsklocka, och måste anges med formuläret HHmmss.

[ @saturday_pager_end_time = ] saturday_pager_end_time

Sluttiden på lördagar när SQL Server Agent-tjänsten inte längre skickar personsökarnotiser till operatören. @saturday_pager_end_time är int, med standardvärdet , 180000vilket indikerar klockan 18:00 på en 24-timmarsklocka, och måste anges med formuläret HHmmss.

[ @sunday_pager_start_time = ] sunday_pager_start_time

Starttiden är på söndagar när SQL Server Agent-tjänsten skickar personsökarnotiser till operatören. @sunday_pager_start_time är int, med standardvärdet , 090000vilket indikerar 09:00 på en 24-timmarsklocka, och måste anges med formuläret HHmmss.

[ @sunday_pager_end_time = ] sunday_pager_end_time

Sluttiden på söndagar när SQL Server Agent-tjänsten inte längre skickar personsökarnotiser till operatören. @sunday_pager_end_time är int, med standardvärdet , 180000vilket indikerar klockan 18:00 på en 24-timmarsklocka, och måste anges med formuläret HHmmss.

[ @pager_days = ] pager_days

Ett nummer som anger vilka dagar operatören är tillgänglig för sidor (med förbehåll för angivna start-/sluttider). @pager_days är tinyint, med standardvärdet , 0vilket indikerar att operatören aldrig är tillgänglig för att ta emot en sida. Giltiga värden är från 0 genom 127. @pager_days beräknas genom att addera individuella värden för de nödvändiga dagarna. Till exempel, från måndag till fredag är det 2 + 4 + 8 + 16 + 32 = 62.

Följande tabell listar värdet för varje veckodag.

Värde Description
1 söndag
2 Monday
4 Tisdag
8 Wednesday
16 Torsdag
32 Fredag
64 lördag

[ @netsend_address = ] N'netsend_address'

Nätverksadressen till operatören som nätverksmeddelandet skickas till. @netsend_address är nvarchar(100), med en standard på NULL.

[ @category_name = ] N'category_name'

Namnet på kategorin för denna operator. @category_name är sysname, med standardvärdet .NULL

Om detta värde är NULL, läggs operatorn till med en standardkategori av [Uncategorized]. Du kan också välja från en befintlig kategori genom att söka tabellen syscategories i databasen msdb :

SELECT name
FROM msdb.dbo.syscategories;

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Resultatuppsättning

Ingen.

Anmärkningar

sp_add_operator måste köras från databasen msdb .

Ditt e-postsystem måste ha en e-post-till-personsökar-funktion om du vill använda sidsökning.

SQL Server Management Studio är ett enkelt, grafiskt sätt att hantera jobb och är det rekommenderade sättet att skapa och hantera jobbinfrastrukturen.

Permissions

Du kan ge EXECUTE behörigheter för denna procedur, men dessa behörigheter kan åsidosättas vid en SQL Server-uppgradering.

Examples

Följande exempel sätter upp operatorinformationen för danwi. Operatören är aktiverad. SQL Server Agent skickar notiser med personsökare måndag till fredag från kl. 8 till 17.

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

Relaterat innehåll

  • Last updated on