sysmail_delete_principalprofile_sp (T-SQL)

Berlaku untuk:SQL Server

Menghapus izin untuk pengguna atau peran database untuk menggunakan profil Email Database publik atau privat.

Konvensi sintaks transact-SQL

Sintaks

sysmail_delete_principalprofile_sp { [ @principal_id = ] principal_id | [ @principal_name = ] 'principal_name' } ,
    { [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' }
[ ; ]

Argumen

[ @principal_id = ] principal_id

ID pengguna atau peran database dalam msdb database agar asosiasi dihapus. @principal_id int, dengan default NULL. Untuk membuat profil publik ke profil privat, berikan ID 0 utama atau nama publicutama . Baik @principal_id atau @principal_name harus ditentukan.

[ @principal_name = ] 'principal_name'

Nama pengguna atau peran database dalam msdb database agar asosiasi dihapus. @principal_name adalah sysname, dengan default NULL. Untuk membuat profil publik ke profil privat, berikan ID 0 utama atau nama publicutama . Baik @principal_id atau @principal_name harus ditentukan.

[ @profile_id = ] profile_id

ID profil untuk asosiasi yang akan dihapus. @profile_id int, dengan default NULL. Baik @profile_id atau @profile_name harus ditentukan.

[ @profile_name = ] 'profile_name'

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

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Keterangan

Untuk membuat profil publik ke profil privat, berikan 'publik' untuk nama utama atau 0 untuk ID utama.

Berhati-hatilah saat menghapus izin untuk profil privat default untuk pengguna atau profil publik default. Ketika tidak ada profil default yang tersedia, sp_send_dbmail memerlukan nama profil sebagai argumen. Oleh karena itu, menghapus profil default menyebabkan panggilan sp_send_dbmail gagal. Untuk informasi selengkapnya, lihat sp_send_dbmail (Transact-SQL).

Prosedur sysmail_delete_principalprofile_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 menunjukkan penghapusan hubungan antara profil AdventureWorks Administrator dan login ApplicationUser dalam msdb database.

EXEC msdb.dbo.sysmail_delete_principalprofile_sp
    @principal_name = 'ApplicationUser',
    @profile_name = 'AdventureWorks Administrator';