Bagikan melalui

sysmail_add_profile_sp (T-SQL)

  • Artikel

Berlaku untuk:SQL ServerAzure SQL Managed Instance

Membuat profil Email Database baru.

Konvensi sintaks transact-SQL

Sintaks

sysmail_add_profile_sp [ @profile_name = ] 'profile_name'
    [ , [ @description = ] N'description' ]
    [ , [ @profile_id = ] new_profile_id OUTPUT ]
[ ; ]

Argumen

[ @profile_name = ] 'profile_name'

Nama untuk profil baru. @profile_name adalah sysname, tanpa default.

Untuk mengirim email menggunakan pekerjaan SQL Server Agent di Azure SQL Managed Instance, SQL Server Agent hanya dapat menggunakan satu profil Email Database, dan harus dipanggil AzureManagedInstance_dbmail_profile. Untuk informasi selengkapnya dan contoh skrip, lihat Pemberitahuan pekerjaan Azure SQL Managed Instance SQL Agent.

[ @description = ] N'description'

Deskripsi opsional untuk profil baru. @description adalah nvarchar(256), tanpa default.

[ @profile_id = ] new_profile_id OUTPUT

Mengembalikan ID untuk profil baru. @profile_id int, dengan default NULL.

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Keterangan

Profil Email Database menyimpan sejumlah akun Email Database. Prosedur tersimpan Email Database dapat merujuk ke profil dengan nama profil atau ID profil yang dihasilkan oleh prosedur ini. Untuk informasi selengkapnya tentang menambahkan akun ke profil, lihat sysmail_add_profileaccount_sp (Transact-SQL).

Nama profil dan deskripsi dapat diubah dengan prosedur sysmail_update_profile_sptersimpan , sementara ID profil tetap konstan selama masa pakai profil.

Nama profil harus unik dalam instans Mesin Database SQL Server atau prosedur tersimpan mengembalikan kesalahan.

Prosedur sysmail_add_profile_sp tersimpan ada di msdb database dan dimiliki oleh dbo skema. Prosedur harus dijalankan dengan nama tiga bagian jika database saat ini bukan msdb.

Izin

Prosedur tersimpan ini dimiliki oleh peran db_owner . Anda dapat memberikan EXECUTE izin untuk pengguna mana pun, tetapi izin ini dapat ditimpa selama peningkatan SQL Server.

Contoh

J. Membuat profil baru

Contoh berikut membuat profil Email Database baru bernama AdventureWorks Administrator.

EXEC msdb.dbo.sysmail_add_profile_sp
       @profile_name = 'AdventureWorks Administrator',
       @description = 'Profile used for administrative mail.';

B. Membuat profil baru, menyimpan ID profil dalam variabel

Contoh berikut membuat profil Email Database baru bernama AdventureWorks Administrator. Contoh menyimpan nomor ID profil dalam variabel @profileId dan mengembalikan kumpulan hasil yang berisi nomor ID profil untuk profil baru.

DECLARE @profileId INT;

EXECUTE msdb.dbo.sysmail_add_profile_sp
       @profile_name = 'AdventureWorks Administrator',
       @description = 'Profile used for administrative mail.',
       @profile_id = @profileId OUTPUT;

SELECT @profileId;

Konten terkait