아티클
09/27/2010

sysmail_add_profileaccount_sp(Transact-SQL)

데이터베이스 메일 프로필에 데이터베이스 메일 계정을 추가합니다. 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는 int이며 기본값은 NULL입니다. profile_id 또는 profile_name을 지정해야 합니다.
[ @profile_name = ] 'profile_name'
계정을 추가할 프로필 이름입니다. profile_name은 sysname이며 기본값은 NULL입니다. profile_id 또는 profile_name을 지정해야 합니다.
[ @account_id = ] account_id
프로필에 추가할 계정 ID입니다. account_id는 int이며 기본값은 NULL입니다. 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 매개 변수에서 구성한 기간 동안 메일을 보내려는 시도를 일시 중지하고 가장 낮은 시퀀스 번호에서 시작하여 다시 메일을 보내는 프로세스 시도를 시작합니다. sysmail_configure_sp의 AccountRetryAttempts 매개 변수를 사용하여 외부 메일 프로세스가 지정한 프로필의 각 계정을 사용하여 전자 메일 메시지 보내기를 시도하는 시간을 구성합니다.

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

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

사용 권한

이 프로시저에 대한 실행 권한은 기본적으로 sysadmin 고정 서버 역할의 멤버로 설정됩니다.

예

다음 예에서는 AdventureWorks Administrator 프로필의 Audit Account 계정에 연결합니다. 감사 계정의 시퀀스 번호는 1입니다.

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