sysmail_add_principalprofile_sp (Transact-SQL)

Udzielenie roli lub użytkownikowi bazy danych uprawnienia do korzystania z profilu poczty bazy danych.

Topic link iconKonwencje składni języka Transact-SQL

sysmail_add_principalprofile_sp  { [ @principal_id = ] principal_id | [ @principal_name = ] 'principal_name' } ,
    { [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' }
    [ , [ @is_default ] = 'is_default' ]

Argumenty

  • [ @principal_id = ] principal_id
    The ID of the database user or role in the msdb database for the association.principal_id is int, with a default of NULL.Albo principal_id lub principal_name musi być określona. A principal_id z 0 sprawia, że to profile profil publiczny, udzielanie dostępu do wszystkich głównych obiektów w bazie danych.

  • [ @ principal_name = ] "principal_name'
    The name of the database user or role in the msdb database for the association.principal_name is sysname, with a default of NULL.Albo principal_id lub principal_name musi być określona. A principal_name z 'public' sprawia, że to profile profil publiczny, udzielanie dostępu do wszystkich głównych obiektów w bazie danych.

  • [ @ profile_id = ] profile_id
    The id of the profile for the association.profile_id is int, with a default of NULL.Albo profile_id lub profile_name musi być określona.

  • [ @ nazwa_profilu = ] "profile_name'
    The name of the profile for the association.profile_name is sysname, with no default.Albo profile_id lub profile_name musi być określona.

  • [ @ is_default = ] is_default
    Za pomocą prostą procedurę z parametrami symboli wieloznacznychA principal must have exactly one default profile.is_default is bit, with no default.

Wartości kodów powrotnych

0 (sukces) lub 1 (brak)

Remarks

Aby utworzyć profil publiczny, należy określić @ principal_id of 0 or a @ principal_name of publiczne.Profil publiczny jest dostępny dla wszystkich użytkowników w msdb bazy danych, chociaż użytkownicy muszą również należeć do DatabaseMailUserRole wykonaćsp_send_dbmail.

Tylko kilka kombinacji zostały przedstawione poniżej:Kiedy @ is_default is '1"i użytkownik jest już skojarzona z jednego lub więcej profilów, określony profil staje się domyślny profil dla użytkownika.Poniższa procedura przechowywana zwraca dwa zestawy wyników.

Kiedy @ is_default is '0"i istnieje żadne inne skojarzenia, zwraca błąd, procedura przechowywana.

Procedura przechowywana sysmail_add_principalprofile_sp is in the msdb bazy danych, a właścicielem dbo schematu.Procedura musi być wykonane o nazwie trzy części, jeśli bieżąca baza danych nie jest msdb.

Uprawnienia

Uprawnienia dla tej wartości domyślnej procedury do członków do wykonywania sysadmin ustalić roli serwera.

Przykłady

A.Creating an association, setting the default profile

Następujący przykład tworzy skojarzenie między profilem o nazwie AdventureWorks Administrator Profile i użytkownika bazy danych msdbApplicationUser.Ten profil jest profilem domyślnym użytkownika.

EXECUTE msdb.dbo.sysmail_add_principalprofile_sp
    @principal_name = 'ApplicationUser',
    @profile_name = 'AdventureWorks Administrator Profile',
    @is_default = 1 ;

B.Making a profile the default public profile

Następujący przykład ustawia profil AdventureWorks Public Profile jako domyślny profil publiczny użytkowników w bazie danych msdb.

EXECUTE msdb.dbo.sysmail_add_principalprofile_sp
    @principal_name = 'public',
    @profile_name = 'AdventureWorks Public Profile',
    @is_default = 1 ;