sysmail_help_principalprofile_sp(Transact-SQL)

아티클
12/15/2008

업데이트: 2006년 12월 12일

데이터베이스 메일 프로필과 msdb 데이터베이스 보안 주체 간 연결에 대한 정보를 나열합니다.

구문

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

인수

[ @principal_id= ] principal_id
msdb 데이터베이스 사용자의 ID 또는 public 역할의 0입니다. principal_id는 int이며 기본값은 NULL입니다. principal_id 또는 principal_name을 지정할 수 있습니다.

[ @principal_name= ] 'principal_name'
msdb 데이터베이스 사용자의 이름 또는 public 역할의 **'public'**입니다. principal_name은 sysname이며 기본값은 NULL입니다. principal_id 또는 principal_name을 지정할 수 있습니다.

[ @profile_id= ] profile_id
연결을 표시할 프로필의 ID입니다. profile_id는 int이며 기본값은 NULL입니다. profile_id 또는 profile_name을 지정할 수 있습니다.

[ @profile_name= ] 'profile_name'
연결을 표시할 프로필의 이름입니다. profile_name은 sysname이며 기본값은 NULL입니다. profile_id 또는 profile_name을 지정할 수 있습니다.

반환 코드 값

0(성공) 또는 1(실패)

결과 집합

다음 표에 나열된 열이 포함된 결과 집합을 반환합니다.

열 이름	데이터 형식	설명
principal_id	int	데이터베이스 사용자의 ID입니다.
principal_name	sysname	데이터베이스 사용자의 이름입니다.
profile_id	int	데이터베이스 메일 프로필의 ID입니다.
profile_name	sysname	데이터베이스 메일 프로필의 이름입니다.
is_default	bit	프로필이 해당 사용자의 기본 프로필인지 여부를 나타내는 플래그입니다.

주의

매개 변수 없이 sysmail_help_principalprofile_sp를 호출하면 반환된 결과 집합은 SQL Server 인스턴스에 있는 모든 연결을 나열합니다. 그렇지 않으면 결과 집합은 제공된 매개 변수와 일치하는 연결에 대한 정보를 포함합니다. 예를 들어 프로필 이름이 제공된 경우 프로시저가 해당 프로필에 대한 모든 연결을 나열합니다.

sysmail_help_principalprofile_sp는 msdb 데이터베이스에 있으며 dbo 스키마가 소유합니다. 현재 데이터베이스가 msdb가 아닐 경우 이 프로시저를 세 부분으로 구성된 이름으로 실행해야 합니다.

사용 권한

sysadmin 고정 서버 역할의 멤버 자격이 필요합니다.

예

1. 특정 연결에 대한 정보 나열

다음 예에서는 msdb 데이터베이스에 있는 AdventureWorks Administrator 프로필과 ApplicationLogin 보안 주체 간의 모든 연결에 대한 정보 목록을 보여 줍니다.

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

다음은 줄 길이에 맞추어 재구성된 결과 집합 예입니다.

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

2. 모든 연결에 대한 정보 나열

다음 예에서는 인스턴스의 모든 연결에 대한 정보 목록을 보여 줍니다.

EXECUTE msdb.dbo.sysmail_help_principalprofile_sp ;

다음은 줄 길이에 맞추어 재구성된 결과 집합 예입니다.

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

참고 항목

참조

데이터베이스 메일 및 SQL 메일 저장 프로시저(Transact-SQL)

도움말 및 정보

SQL Server 2005 지원 받기

변경 내역

릴리스	내역
2006년 12월 12일	변경된 내용 사용자를 msdb 사용자로 지정했고 해당 역할은 public 역할로 제한됩니다.
2006년 4월 14일	변경된 내용 존재하지 않는 @database_id 및 @database_name 매개 변수를 제거했습니다.