Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Van toepassing op:
SQL ServerAzure SQL Managed Instance
Maakt een operator (ontvanger van meldingen) aan voor gebruik bij meldingen en taken.
Transact-SQL syntaxis-conventies
Syntaxis
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 = ] Naamloos
De naam van een operator (ontvanger van de melding). Deze naam moet uniek zijn en mag het percentage (%) karakter niet bevatten.
@name is een systeemnaam, zonder standaard.
[ @enabled = ] ingeschakeld
Geeft de huidige status van de operator aan.
@enabled is Tinyint, met standaard ( 1 ingeschakeld). Als 0, is de operator niet ingeschakeld en ontvangt geen meldingen.
[ @email_address = ] N'email_address'
Het e-mailadres van de operator. Deze reeks wordt direct doorgegeven aan het e-mailsysteem.
@email_address is nvarchar(100), met een standaard van NULL.
Je kunt een fysiek e-mailadres of een alias voor @email_address opgeven. Voorbeeld:
fatmir.bregu of fatmir.bregu@contoso.com
Opmerking
Je moet het e-mailadres van Database Mail gebruiken.
[ @pager_address = ] N'pager_address'
Het pieperadres van de operator. Deze reeks wordt direct doorgegeven aan het e-mailsysteem.
@pager_address is nvarchar(100), met als standaard .NULL
[ @weekday_pager_start_time = ] weekday_pager_start_time
De starttijd wanneer de SQL Server Agent-service pagermeldingen naar de operator stuurt, is van maandag tot en met vrijdag.
@weekday_pager_start_time is int, met een standaard van 090000, wat 9:00 uur aangeeft op een 24-uurs klok, en moet worden ingevoerd via het formulier HHmmss.
[ @weekday_pager_end_time = ] weekday_pager_end_time
De eindtijd wanneer de SQL Server Agent-service geen pagermeldingen meer naar de operator stuurt, van maandag tot en met vrijdag.
@weekday_pager_end_time is int, met een standaard van 180000, wat 18:00 uur aangeeft op een 24-uurs klok, en moet worden ingevoerd via het formulier HHmmss.
[ @saturday_pager_start_time = ] saturday_pager_start_time
De starttijd op zaterdagen wanneer de SQL Server Agent-service pagermeldingen naar de operator stuurt.
@saturday_pager_start_time is int, met een standaard van 090000, wat 9:00 uur op een 24-uurs klok aangeeft, en moet worden ingevoerd via het formulier HHmmss.
[ @saturday_pager_end_time = ] saturday_pager_end_time
De eindtijd op zaterdagen wanneer de SQL Server Agent-service geen pagermeldingen meer naar de operator stuurt.
@saturday_pager_end_time is int, met een standaard van 180000, wat 18:00 uur aangeeft op een 24-uursklok, en moet worden ingevoerd via het formulier HHmmss.
[ @sunday_pager_start_time = ] sunday_pager_start_time
De starttijd op zondagen wanneer de SQL Server Agent-service pagermeldingen naar de operator stuurt.
@sunday_pager_start_time is int, met als standaard 090000, wat 9:00 uur op een 24-uursklok aangeeft, en moet worden ingevoerd met het formulier HHmmss.
[ @sunday_pager_end_time = ] sunday_pager_end_time
De eindtijd op zondagen wanneer de SQL Server Agent-service geen pagermeldingen meer naar de operator stuurt.
@sunday_pager_end_time is int, met een standaard van 180000, wat 18:00 uur aangeeft op een 24-uurs klok, en moet worden ingevoerd via het formulier HHmmss.
[ @pager_days = ] pager_days
Een nummer dat aangeeft op welke dagen de operator beschikbaar is voor pagina's (onder voorbehoud van de opgegeven begin-/eindtijden).
@pager_days is tinyint, met een standaard van 0, wat aangeeft dat de operator nooit beschikbaar is om een pagina te ontvangen. Geldige waarden komen van 0 via 127.
@pager_days wordt berekend door de individuele waarden voor de vereiste dagen op te tellen. Bijvoorbeeld, van maandag tot en met vrijdag is .2 + 4 + 8 + 16 + 32 = 62
De volgende tabel geeft de waarde weer voor elke dag van de week.
| Waarde | Description |
|---|---|
1 |
Zondag |
2 |
Monday |
4 |
Dinsdag |
8 |
Wednesday |
16 |
Donderdag |
32 |
Vrijdag |
64 |
Zaterdag |
[ @netsend_address = ] N'netsend_address'
Het netwerkadres van de operator naar wie het netwerkbericht wordt gestuurd.
@netsend_address is nvarchar(100), met als standaard .NULL
[ @category_name = ] N'category_name'
De naam van de categorie voor deze operator.
@category_name is sysname, met als standaard NULL.
Als deze waarde is NULL, wordt de operator toegevoegd met een standaardcategorie van [Uncategorized]. Je kunt ook kiezen uit een bestaande categorie door de syscategories tabel in de msdb database te zoeken:
SELECT name
FROM msdb.dbo.syscategories;
Codewaarden retourneren
0 (geslaagd) of 1 (mislukt).
Resultaatset
Geen.
Opmerkingen
sp_add_operator Moet vanuit de msdb database worden uitgevoerd.
Je e-mailsysteem moet een e-mail-naar-pager functie hebben als je paging wilt gebruiken.
SQL Server Management Studio biedt een eenvoudige, grafische manier om taken te beheren en is de aanbevolen manier om de taakinfrastructuur te maken en te beheren.
Permissions
Je kunt rechten verlenen EXECUTE op deze procedure, maar deze rechten kunnen worden overschreven tijdens een SQL Server-upgrade.
Voorbeelden
Het volgende voorbeeld stelt de operatorinformatie voor danwiop. De operator is ingeschakeld. SQL Server Agent stuurt meldingen per pager van maandag tot en met vrijdag van 8.00 tot 17.00 uur.
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