sysmail_update_profileaccount_sp (T-SQL)

  • Artikel

Berlaku untuk:SQL Server

Memperbarui nomor urut akun dalam profil Email Database.

Konvensi sintaks transact-SQL

Sintaks

sysmail_update_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 profil yang akan diperbarui. @profile_id int, dengan default NULL. Baik @profile_id atau @profile_name harus ditentukan.

[ @profile_name = ] 'profile_name'

Nama profil profil yang akan diperbarui. @profile_name adalah sysname, dengan default NULL. Baik @profile_id atau @profile_name harus ditentukan.

[ @account_id = ] account_id

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

[ @account_name = ] 'account_name'

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

[ @sequence_number = ] sequence_number

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

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Tataan hasil

Tidak ada.

Keterangan

Mengembalikan kesalahan jika akun yang ditentukan tidak terkait dengan profil yang ditentukan.

Nomor urut menentukan urutan di mana Database Mail menggunakan akun di profil. Untuk pesan email baru, Email Database dimulai dengan akun yang merupakan 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, pesan email gagal.

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_update_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 mengubah nomor urut akun Admin-BackupServer dalam profil AdventureWorks Administrator dalam msdb database. Setelah menjalankan kode ini, nomor urut untuk akun adalah 3, menunjukkan bahwa kode tersebut akan dicoba jika dua akun pertama gagal.

EXEC msdb.dbo.sysmail_update_profileaccount_sp
    @profile_name = 'AdventureWorks Administrator',
    @account_name = 'Admin-BackupServer',
    @sequence_number = 3;

Konten terkait