sp_notify_operator (Transact-SQL)

Gäller för:SQL Server

Skickar ett e-postmeddelande till en operatör med hjälp av Database Mail.

Transact-SQL syntaxkonventioner

Syntax

sp_notify_operator
    [ [ @profile_name = ] N'profile_name' ]
    [ , [ @id = ] id ]
    [ , [ @name = ] N'name' ]
    [ , [ @subject = ] N'subject' ]
    [ , [ @body = ] N'body' ]
    [ , [ @file_attachments = ] N'file_attachments' ]
    [ , [ @mail_database = ] N'mail_database' ]
[ ; ]

Arguments

[ @profile_name = ] N'profile_name'

Namnet på Database Mail-profilen som ska användas för att skicka meddelandet. @profile_name är sysname, med standardvärdet .NULL Om @profile_name inte anges används standardprofilen Database Mail.

[ @id = ] id

Identifieraren som operatören ska skicka meddelandet till. @id är int, med standardvärdet .NULL

En av @id eller @name måste specificeras.

[ @name = ] N'namn'

Namnet på operatören som ska skicka meddelandet till. @name är sysname, med standardvärdet .NULL

En av @id eller @name måste specificeras.

En e-postadress måste definieras för operatören innan de kan ta emot meddelanden.

[ @subject = ] N'subject'

Ämnet för e-postmeddelandet. @subject är nvarchar(256), med en standard på NULL.

[ @body = ] N'body'

Brödtexten i e-postmeddelandet. @body är nvarchar(max), med standardvärdet .NULL

[ @file_attachments = ] N'file_attachments'

Namnet på en fil att bifoga e-postmeddelandet. @file_attachments är nvarchar(512), med en standard på NULL.

[ @mail_database = ] N'mail_database'

Specificerar namnet på e-postvärdens databas. @mail_database är sysname, med standardvärdet .msdb Om ingen @mail_database anges används databasen msdb som standard.

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Anmärkningar

Skickar det angivna meddelandet till den angivna operatörens e-postadress. Om operatören inte har någon konfigurerad e-postadress, sp_notify_operator returneras ett felmeddelande.

Databas-e-post och en e-postvärdsdatabas måste konfigureras innan en notifikation kan skickas till en operatör.

Permissions

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

Andra användare måste tilldelas en av följande SQL Server Agent-fasta databasroller i databasen msdb :

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

För detaljer om behörigheterna för dessa roller, se SQL Server Agent Fixed Database Roles.

Examples

Följande exempel skickar ett notifikationsmejl till operatören François Ajenstat via AdventureWorks Administrator Database Mail-profilen. Ämnet för e-postmeddelandet är Test Notification. E-postmeddelandet innehåller meningen, This is a test of notification via e-mail.

USE msdb;
GO

EXECUTE dbo.sp_notify_operator
    @profile_name = N'AdventureWorks Administrator',
    @name = N'François Ajenstat',
    @subject = N'Test Notification',
    @body = N'This is a test of notification via e-mail';
GO