sp_notify_operator (T-SQL)

Artikel
12/22/2023

Berlaku untuk: SQL Server

Mengirim pesan email ke operator menggunakan Email Database.

Sintaks

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

Argumen

[ @profile_name = ] 'profilename' Nama profil Email Database yang akan digunakan untuk mengirim pesan. profilename adalah nvarchar(128). Jika nama profil tidak ditentukan, profil Email Database default akan digunakan.

[ @id = ] id Pengidentifikasi untuk operator untuk mengirim pesan. id adalah int, dengan default NULL. Salah satu id atau nama harus ditentukan.

[ @name = ] 'name' Nama operator yang akan dikirimi pesan. nama adalah nvarchar(128), dengan default NULL. Salah satu id atau nama harus ditentukan.

Catatan

Alamat email harus ditentukan untuk operator sebelum mereka dapat menerima pesan.

[ @subject = ] 'subject' Subjek untuk pesan email. subjek adalah nvarchar(256) tanpa default.

[ @body = ] 'message' Isi pesan email. message is nvarchar(max) tanpa default.

[ @file_attachments = ] 'attachment' Nama file yang akan dilampirkan ke pesan email. lampiran adalah nvarchar(512), tanpa default.

[ @mail_database = ] 'mail_host_database' Menentukan nama database host email. mail_host_database adalah nvarchar(128). Jika tidak ada mail_host_database yang ditentukan, database msdb digunakan secara default.

Mengembalikan Nilai Kode

0 (berhasil) atau 1 (kegagalan)

Keterangan

Mengirim pesan yang ditentukan ke alamat email operator yang ditentukan. Jika operator tidak memiliki alamat email yang dikonfigurasi, mengembalikan kesalahan.

Email Database dan database host email harus dikonfigurasi sebelum pemberitahuan dapat dikirim ke operator.

Izin

Secara default, anggota peran server tetap sysadmin dapat menjalankan prosedur tersimpan ini. Pengguna lain harus diberikan salah satu peran database tetap SQL Server Agent berikut dalam database msdb :

SQLAgentUserRole
SQLAgentReaderRole
SQLAgentOperatorRole

Untuk detail tentang izin peran ini, lihat Peran Database Tetap Agen SQL Server.

Contoh

Contoh berikut mengirimkan email pemberitahuan ke operator François Ajenstat menggunakan AdventureWorks Administrator profil Email Database. Subjek email adalah Test Notification. Pesan email berisi kalimat, "Ini adalah pengujian pemberitahuan melalui email."

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

Lihat juga

Prosedur Tersimpan Agen SQL Server (Transact-SQL)
sp_add_operator (T-SQL)
sp_help_operator (T-SQL)
sp_delete_operator (T-SQL)

Bagikan melalui