sysmail_add_profileaccount_sp(Transact-SQL)

적용 대상:SQL Server

데이터베이스 메일 프로필에 데이터베이스 메일 계정을 추가합니다. sysmail_add_account_sp(Transact-SQL)를 사용하여 데이터베이스 계정을 만들고 sysmail_add_profile_sp(Transact-SQL)를 사용하여 데이터베이스 프로필을 만든 후에 실행 sysmail_add_profileaccount_sp 합니다.

Transact-SQL 구문 표기 규칙

구문

sysmail_add_profileaccount_sp { [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' } ,
    { [ @account_id = ] account_id | [ @account_name = ] 'account_name' }
    [ , [ @sequence_number = ] sequence_number ]
[ ; ]

인수

[ @profile_id = ] profile_id

계정을 추가할 프로필 ID입니다. @profile_id 기본값NULL인 int입니다. @profile_id 또는 @profile_name 지정해야 합니다.

[ @profile_name = ] 'profile_name'

계정을 추가할 프로필 이름입니다. @profile_name sysname이며 기본값은 .입니다NULL. @profile_id 또는 @profile_name 지정해야 합니다.

[ @account_id = ] account_id

프로필에 추가할 계정 ID입니다. @account_id 기본값NULL인 int입니다. @account_id 또는 @account_name 지정해야 합니다.

[ @account_name = ] 'account_name'

프로필에 추가할 계정의 이름입니다. @account_name sysname이며 기본값은 .입니다NULL. @account_id 또는 @account_name 지정해야 합니다.

[ @sequence_number = ] sequence_number

프로필 내 계정의 시퀀스 번호입니다. @sequence_number 기본값이 없는 int입니다. 시퀀스 번호는 프로필에서 계정이 사용되는 순서를 결정합니다.

반환 코드 값

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

설명

프로필과 계정이 모두 이미 있어야 합니다. 그렇지 않으면 저장 프로시저에서 오류를 반환합니다.

이 저장 프로시저는 지정된 프로필과 이미 연결된 계정의 시퀀스 번호를 변경하지 않습니다. 계정의 시퀀스 번호를 업데이트하는 방법에 대한 자세한 내용은 sysmail_update_profileaccount_sp(Transact-SQL)를 참조하세요.

시퀀스 번호는 데이터베이스 메일 프로필에서 계정을 사용하는 순서를 결정합니다. 새 전자 메일 메시지의 경우 데이터베이스 메일 시퀀스 번호가 가장 낮은 계정으로 시작합니다. 해당 계정이 실패하면 데이터베이스 메일 데이터베이스 메일 메시지를 성공적으로 보내거나 시퀀스 번호가 가장 높은 계정이 실패할 때까지 다음으로 높은 시퀀스 번호가 있는 계정을 사용합니다. 시퀀스 번호가 가장 높은 계정이 실패하면 데이터베이스 메일 매개 변수sysmail_configure_sp에 AccountRetryDelay 구성된 시간 동안 메일을 보내려고 일시 중지한 다음, 가장 낮은 시퀀스 번호부터 시작하여 메일을 다시 보내려고 시도하는 프로세스를 시작합니다. 매개 변수를 AccountRetryAttemptssysmail_configure_sp사용하여 외부 메일 프로세스가 지정된 프로필의 각 계정을 사용하여 전자 메일 메시지를 보내려고 시도하는 횟수를 구성합니다.

시퀀스 번호가 같은 계정이 두 개 이상 있는 경우 데이터베이스 메일 지정된 전자 메일 메시지에 해당 계정 중 하나만 사용합니다. 이 경우 데이터베이스 메일에서 항상 특정 시퀀스 번호에 대해 해당 계정이 사용되거나 메시지 간 동일한 계정이 사용되는 것은 아닙니다.

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

사용 권한

이 저장 프로시저는 db_owner 역할이 소유합니다. 모든 사용자에 대한 사용 권한을 부여 EXECUTE 할 수 있지만 SQL Server 업그레이드 중에 이러한 권한이 재정의될 수 있습니다.

예제

다음 예제에서는 프로필을 AdventureWorks Administrator 계정 Audit Account과 연결합니다. 감사 계정에는 시퀀스 번호가 있습니다 1.

EXEC msdb.dbo.sysmail_add_profileaccount_sp
    @profile_name = 'AdventureWorks Administrator',
    @account_name = 'Audit Account',
    @sequence_number = 1;

관련 콘텐츠

• 데이터베이스 메일
• 데이터베이스 메일 계정 만들기
• 데이터베이스 메일 구성 개체
• 저장 프로시저 데이터베이스 메일(Transact-SQL)