sp_notify_operator (Transact-SQL)

Gilt für:SQL Server

Sendet mithilfe der Datenbank-E-Mail eine E-Mail-Nachricht an den Operator.

Transact-SQL-Syntaxkonventionen

Syntax

  
sp_notify_operator  
    [ @profile_name = ] 'profilename' ,  
    [ @id = ] id ,  
    [ @name = ] 'name' ,  
    [ @subject = ] 'subject' ,  
    [ @body = ] 'message' ,  
    [ @file_attachments = ] 'attachment'  
    [ @mail_database = ] 'mail_host_database'  

Argumente

[ @profile_name = ] 'profilename'Der Name des Datenbank-E-Mail Profils, das zum Senden der Nachricht verwendet werden soll. profilname is nvarchar(128). Wenn kein Profilname angegeben ist, wird das Standardprofil Datenbank-E-Mail verwendet.

[ @id = ] id Der Bezeichner für den Operator, an den die Nachricht gesendet werden soll. id ist int, mit einem Standardwert von NULL. Eine id oder ein Name muss angegeben werden.

[ @name = ] 'name' Der Name des Operators, an den die Nachricht gesendet werden soll. name is nvarchar(128), with a default of NULL. Eine id oder ein Name muss angegeben werden.

[ @subject = ] 'subject' Der Betreff für die E-Mail-Nachricht. subject is nvarchar(256) with no default.

[ @body = ] 'message' Der Textkörper der E-Mail-Nachricht. message is nvarchar(max) with no default.

[ @file_attachments = ] 'attachment' Der Name einer Datei, die an die E-Mail-Nachricht angefügt werden soll. attachment is nvarchar(512), with no default.

[ @mail_database = ] 'mail_host_database' Gibt den Namen der E-Mail-Hostdatenbank an. mail_host_database ist nvarchar(128). Wenn keine mail_host_database angegeben ist, wird die msdb-Datenbank standardmäßig verwendet.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

Sendet die Nachricht an die angegebene E-Mail-Adresse des angegebenen Operators. Falls für den Operator keine E-Mail-Adresse konfiguriert ist, wird ein Fehler zurückgegeben.

Die Datenbank-E-Mail und eine Mailhostdatenbank müssen konfiguriert werden, bevor eine Benachrichtigung an einen Operator gesendet werden kann.

Berechtigungen

Standardmäßig können nur Mitglieder der festen Serverrolle sysadmin diese gespeicherte Prozedur ausführen. Andere Benutzer müssen Mitglieder der festen SQL Server -Agent-Datenbankrollen in der msdb -Datenbank sein:

• SQLAgentUserRole

• SQLAgentReaderRole

• SQLAgentOperatorRole

Weitere Informationen zu den Berechtigungen dieser Rollen finden Sie unter Feste Datenbankrollen des SQL Server-Agents.

Beispiele

Im folgenden Beispiel wird eine Benachrichtigungs-E-Mail an den Operator François Ajenstat mit dem Datenbank-E-Mail-Profil AdventureWorks Administrator gesendet. Der Betreff der E-Mail lautet Test Notification. Die E-Mail-Nachricht enthält den Satz "This is a test of notification via e-mail".

USE msdb ;  
GO  
  
EXEC 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  

Siehe auch

SQL Server-Agent Gespeicherte Prozeduren (Transact-SQL)
sp_add_operator (Transact-SQL)
sp_help_operator (Transact-SQL)
sp_delete_operator (Transact-SQL)