sysmail_add_profileaccount_sp (T-SQL)

  • Artikel

Berlaku untuk:SQL Server

Menambahkan akun Email Database ke profil Email Database. Jalankan sysmail_add_profileaccount_sp setelah Akun Database dibuat dengan sysmail_add_account_sp (Transact-SQL), dan Profil Database dibuat dengan sysmail_add_profile_sp (Transact-SQL).

Konvensi sintaks transact-SQL

Sintaks

sysmail_add_profileaccount_sp { [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' } ,
    { [ @account_id = ] account_id | [ @account_name = ] 'account_name' }
    [ , [ @sequence_number = ] sequence_number ]
[ ; ]

Argumen

[ @profile_id = ] profile_id

ID profil untuk menambahkan akun. @profile_id int, dengan default NULL. Baik @profile_id atau @profile_name harus ditentukan.

[ @profile_name = ] 'profile_name'

Nama profil tempat menambahkan akun. @profile_name adalah sysname, dengan default NULL. Baik @profile_id atau @profile_name harus ditentukan.

[ @account_id = ] account_id

ID akun yang akan ditambahkan ke profil. @account_id int, dengan default NULL. Baik @account_id atau @account_name harus ditentukan.

[ @account_name = ] 'account_name'

Nama akun yang akan ditambahkan ke profil. @account_name adalah sysname, dengan default NULL. Baik @account_id atau @account_name harus ditentukan.

[ @sequence_number = ] sequence_number

Nomor urut akun dalam profil. @sequence_number int, tanpa default. Nomor urut menentukan urutan akun mana yang digunakan dalam profil.

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Keterangan

Profil dan akun harus sudah ada. Jika tidak, prosedur tersimpan mengembalikan kesalahan.

Perhatikan bahwa prosedur tersimpan ini tidak mengubah nomor urut akun yang sudah terkait dengan profil yang ditentukan. Untuk informasi selengkapnya tentang memperbarui nomor urut akun, lihat sysmail_update_profileaccount_sp (Transact-SQL).

Nomor urut menentukan urutan di mana Database Mail menggunakan akun di profil. Untuk pesan email baru, Email Database dimulai dengan akun yang memiliki nomor urut terendah. Jika akun tersebut gagal, Database Mail menggunakan akun dengan nomor urutan tertinggi berikutnya, dan sebagainya, hingga Email Database berhasil mengirim pesan, atau akun dengan nomor urutan tertinggi gagal. Jika akun dengan nomor urutan tertinggi gagal, Database Mail menjeda upaya untuk mengirim email untuk jumlah waktu yang dikonfigurasi dalam AccountRetryDelay parameter sysmail_configure_sp, maka memulai proses upaya untuk mengirim email lagi, dimulai dengan nomor urutan terendah. AccountRetryAttempts Gunakan parameter sysmail_configure_sp, untuk mengonfigurasi berapa kali proses email eksternal mencoba mengirim pesan email menggunakan setiap akun di profil yang ditentukan.

Jika ada lebih dari satu akun dengan nomor urut yang sama, Email Database hanya menggunakan salah satu akun tersebut untuk pesan email tertentu. Dalam hal ini, Database Mail tidak menjamin akun mana yang digunakan untuk nomor urut tersebut atau bahwa akun yang sama digunakan dari pesan ke pesan.

Prosedur sysmail_add_profileaccount_sp tersimpan msdb ada di database dan dimiliki oleh skema dbo . 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

Contoh berikut mengaitkan profil AdventureWorks Administrator dengan akun Audit Account. Akun audit memiliki nomor urut .1

EXEC msdb.dbo.sysmail_add_profileaccount_sp
    @profile_name = 'AdventureWorks Administrator',
    @account_name = 'Audit Account',
    @sequence_number = 1;

Konten terkait