sysmail_help_principalprofile_sp (T-SQL)

  • Artikel

Berlaku untuk:SQL Server

Mencantumkan informasi tentang asosiasi antara profil Email Database dan prinsipal database.

Konvensi sintaks transact-SQL

Sintaks

sysmail_help_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 untuk dicantumkan asosiasi. @principal_id int, dengan default NULL. Baik @principal_id atau @principal_name harus ditentukan.

[ @principal_name = ] 'principal_name'

Nama pengguna atau peran database dalam msdb database untuk asosiasi yang akan dicantumkan. @principal_name adalah sysname, dengan default NULL. Baik @principal_id atau @principal_name harus ditentukan.

[ @profile_id = ] profile_id

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

[ @profile_name = ] 'profile_name'

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

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Tataan hasil

Mengembalikan tataan hasil yang berisi kolom yang tercantum dalam tabel berikut.

Nama kolom Jenis data Deskripsi
principal_id int ID pengguna database.
principal_name nama sysname Nama pengguna database.
profile_id int Nomor ID profil Email Database.
profile_name nama sysname Nama profil Email Database.
is_default bit Bendera yang menyatakan apakah profil adalah profil default untuk pengguna.

Keterangan

Jika sysmail_help_principalprofile_sp dipanggil tanpa parameter, kumpulan hasil yang dikembalikan mencantumkan semua asosiasi dalam instans SQL Server. Jika tidak, kumpulan hasil berisi informasi untuk asosiasi yang cocok dengan parameter yang disediakan. Misalnya, prosedur mencantumkan semua asosiasi untuk profil saat nama profil disediakan.

sysmail_help_principalprofile_sp berada dalam msdb 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

J. Mencantumkan informasi untuk asosiasi tertentu

Contoh berikut menunjukkan daftar informasi untuk semua asosiasi antara AdventureWorks Administrator profil dan ApplicationLogin prinsipal dalam msdb database.

EXEC msdb.dbo.sysmail_help_principalprofile_sp
    @principal_name = 'danw',
    @profile_name = 'AdventureWorks Administrator';

Berikut adalah contoh tataan hasil, diformat ulang untuk panjang garis.

principal_id principal_name     profile_id  profile_name                   is_default
------------ ------------------ ----------- ------------------------------ ----------
5            danw               9           AdventureWorks Administrator   1

B. Mencantumkan informasi untuk semua asosiasi

Contoh berikut menunjukkan daftar informasi untuk semua asosiasi dalam instans.

EXEC msdb.dbo.sysmail_help_principalprofile_sp;

Berikut adalah contoh tataan hasil, diformat ulang untuk panjang garis.

principal_id principal_name     profile_id  profile_name                   is_default
------------ ------------------ ----------- ------------------------------ ----------
6            terrid             3           Product Update Profile         1
5            danw               9           AdventureWorks Administrator   1

Konten terkait