Udostępnij za pomocą


sp_notify_operator (Transact-SQL)

Dotyczy:SQL Server

Wysyła wiadomość e-mail do operatora za pomocą Database Mail.

Transact-SQL konwencje składni

Składnia

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'

Nazwa profilu Database Mail, który ma się użyć do wysłania wiadomości. @profile_name to nazwa systemu, z domyślnym .NULL Jeśli @profile_name nie jest określone, używany jest domyślny profil Database Mail.

[ @id = ] id

Identyfikator, do którego operator ma wysłać wiadomość. @id jest int, z domyślnym obciążeniem NULL.

Należy określić jedno z @id lub @name .

[ @name = ] N'imię'

Nazwa operatora, do którego należy wysłać wiadomość. @name to nazwa systemu, z domyślnym .NULL

Należy określić jedno z @id lub @name .

Przed otrzymaniem wiadomości operator musi zdefiniować adres e-mail.

[ @subject = ] N'subject'

Temat wiadomości e-mailowej. @subject to nvarchar(256), z domyślnym obciążeniem NULL.

[ @body = ] N'body'

Treść wiadomości e-mail. @body to nvarchar(max), z domyślnym .NULL

[ @file_attachments = ] N'file_attachments'

Nazwa pliku do dołączenia do wiadomości e-mail. @file_attachments to nvarchar(512), z domyślnym obciążeniem NULL.

[ @mail_database = ] N'mail_database'

Określa nazwę bazy danych hostów poczty. @mail_database to nazwa systemu, z domyślnym .msdb Jeśli nie podano @mail_database , baza msdb danych jest używana domyślnie.

Zwracanie wartości kodu

0 (powodzenie) lub 1 (niepowodzenie).

Uwagi

Wysyła określoną wiadomość na adres e-mail operatora. Jeśli operator nie ma skonfigurowanego adresu sp_notify_operator e-mail, zwraca błąd.

Database Mail oraz baza danych hostów e-mail muszą być skonfigurowane, zanim powiadomienie będzie można wysłać operatorowi.

Permissions

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

Inni użytkownicy muszą otrzymać jedną z następujących stałych ról msdb bazy danych SQL Server Agent:

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

Szczegóły dotyczące uprawnień tych ról można znaleźć w sekcji SQL Server Agent Fixed Database Roles.

Przykłady

Poniższy przykład wysyła powiadomienie e-mail do operatora François Ajenstat za pomocą AdventureWorks Administrator profilu Database Mail. Tematem e-maila Test Notificationjest . Wiadomość e-mail zawiera zdanie 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