sp_notify_operator (Transact-SQL)sp_notify_operator (Transact-SQL)

CETTE RUBRIQUE S’APPLIQUE À :ouiSQL Server (à partir de la version 2008)nonAzure SQL DatabasenonAzure SQL Data Warehouse nonParallel Data Warehouse THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Envoie un message électronique à un opérateur utilisant la messagerie de base de données.Sends an e-mail message to an operator using Database Mail.

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax


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

ArgumentsArguments

[ @profile_name= ] 'profilename'[ @profile_name= ] 'profilename'
Nom du profil de la messagerie de base de données à utiliser pour envoyer le message.The name of the Database Mail profile to use to send the message. ProfileName est nvarchar (128).profilename is nvarchar(128). Si profilename n’est pas spécifié, le profil de messagerie de base de données par défaut est utilisé.If profilename is not specified, the default Database Mail profile is used.

[ @id= ] id[ @id= ] id
Identificateur de l'opérateur destinataire du message.The identifier for the operator to send the message to. ID est int, avec NULL comme valeur par défaut.id is int, with a default of NULL. Un des id ou nom doit être spécifié.One of id or name must be specified.

[ @name= ] 'nom'[ @name= ] 'name'
Nom de l'opérateur destinataire du message.The name of the operator to send the message to. nom est nvarchar (128), avec NULL comme valeur par défaut.name is nvarchar(128), with a default of NULL. Un des id ou nom doit être spécifié.One of id or name must be specified.

Remarque : une adresse de messagerie doit être définie pour l’opérateur qu’il puisse recevoir des messages.NOTE: An e-mail address must be defined for the operator before they can receive messages.

[ @subject= ] 'subject'[ @subject= ] 'subject'
L’objet du message électronique.The subject for the e-mail message. objet est nvarchar (256) sans valeur par défaut.subject is nvarchar(256) with no default.

[ @body= ] 'message'[ @body= ] 'message'
Corps du message électronique.The body of the e-mail message. message est nvarchar (max) sans valeur par défaut.message is nvarchar(max) with no default.

[ @file_attachments= ] 'pièce jointe'[ @file_attachments= ] 'attachment'
Nom d'un fichier à joindre au message électronique.The name of a file to attach to the e-mail message. pièce jointe est nvarchar (512), sans valeur par défaut.attachment is nvarchar(512), with no default.

[ @mail_database= ] 'mail_host_database'[ @mail_database= ] 'mail_host_database'
Spécifie le nom de la base de données hôte de courrier.Specifies the name of the mail host database. mail_host_database est nvarchar (128).mail_host_database is nvarchar(128). Si aucun mail_host_database est spécifié, le msdb base de données est utilisée par défaut.If no mail_host_database is specified, the msdb database is used by default.

Valeurs des codes de retourReturn Code Values

0 (réussite) ou 1 (échec)0 (success) or 1 (failure)

NotesRemarks

Envoie le message spécifié à l'adresse de messagerie de l'opérateur choisi.Sends the message specified to the e-mail address of the operator specified. Si l'opérateur ne dispose pas d'une adresse de messagerie, une erreur est renvoyée.If the operator has no e-mail address configured, returns an error.

La messagerie de base de données et une base de données hôte de courrier doivent être configurées avant qu'une notification puisse être envoyée à un opérateur.Database Mail and a mail host database must be configured before a notification can be sent to an operator.

AutorisationsPermissions

Par défaut, les membres du rôle serveur fixe sysadmin peuvent exécuter cette procédure stockée.By default, members of the sysadmin fixed server role can execute this stored procedure. Les autres utilisateurs doivent disposer de l'un des rôles de base de données fixes suivants de SQL ServerSQL Server Agent dans la base de données msdb :Other users must be granted one of the following SQL ServerSQL Server Agent fixed database roles in the msdb database:

ExemplesExamples

L'exemple suivant envoie une notification par courrier électronique à l'opérateur François Ajenstat à l'aide du profil de messagerie de la base de données AdventureWorks Administrator.The following example sends a notification e-mail to the operator François Ajenstat using the AdventureWorks Administrator Database Mail profile. Le message électronique a pour objet Test Notification.The subject of the e-mail is Test Notification. Le message électronique contient la phrase « This is a test of notification via e-mail. ».The e-mail message contains the sentence, "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  

Voir aussiSee also

L’Agent SQL Server stockées procédures ( Transact-SQL ) SQL Server Agent Stored Procedures (Transact-SQL)
sp_add_operator (Transact-SQL) sp_add_operator (Transact-SQL)
sp_help_operator (Transact-SQL) sp_help_operator (Transact-SQL)
sp_delete_operator (Transact-SQL)sp_delete_operator (Transact-SQL)