sysmail_add_profileaccount_sp(Transact-SQL)
적용 대상: SQL Server
데이터베이스 메일 프로필에 데이터베이스 메일 계정을 추가합니다. sysmail_add_account_sp 사용하여 데이터베이스 계정을 만들고 sysmail_add_profile_sp 사용하여 데이터베이스 프로필을 만든 후에 실행sysmail_add_profileaccount_sp
합니다.
구문
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 참조하세요.
시퀀스 번호는 데이터베이스 메일 프로필에서 계정을 사용하는 순서를 결정합니다. 새 전자 메일 메시지의 경우 데이터베이스 메일 시퀀스 번호가 가장 낮은 계정으로 시작합니다. 해당 계정이 실패하면 데이터베이스 메일 데이터베이스 메일 메시지를 성공적으로 보내거나 시퀀스 번호가 가장 높은 계정이 실패할 때까지 다음으로 높은 시퀀스 번호가 있는 계정을 사용합니다. 시퀀스 번호가 가장 높은 계정이 실패하면 데이터베이스 메일 매개 변수sysmail_configure_sp
에 AccountRetryDelay
구성된 시간 동안 메일을 보내려고 일시 중지한 다음, 가장 낮은 시퀀스 번호부터 시작하여 메일을 다시 보내려고 시도하는 프로세스를 시작합니다. 매개 변수를 AccountRetryAttempts
sysmail_configure_sp
사용하여 외부 메일 프로세스가 지정된 프로필의 각 계정을 사용하여 전자 메일 메시지를 보내려고 시도하는 횟수를 구성합니다.
시퀀스 번호가 같은 계정이 두 개 이상 있는 경우 데이터베이스 메일은 지정된 전자 메일 메시지에 해당 계정 중 하나만 사용합니다. 이 경우 데이터베이스 메일에서 항상 특정 시퀀스 번호에 대해 해당 계정이 사용되거나 메시지 간 동일한 계정이 사용되는 것은 아닙니다.
저장 프로시저 sysmail_add_profileaccount_sp
는 데이터베이스에 msdb
있으며 dbo 스키마가 소유합니다. 현재 데이터베이스가 아닌 msdb
경우 프로시저를 세 부분으로 된 이름으로 실행해야 합니다.
사용 권한
이 절차에 대한 사용 권한을 부여 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;