sysmail_add_profile_sp(Transact-SQL)
새 데이터베이스 메일 프로필을 만듭니다.
[!참고] 데이터베이스 메일은 MAPI(메시징 응용 프로그램 프로그래밍 인터페이스)를 사용하지 않으므로 데이터베이스 메일 프로필은 MAPI 메일 프로필이 아닙니다. 데이터베이스 메일은 SQL 메일 프로필을 사용하지 않습니다.
.gif "항목 링크 아이콘")
구문
sysmail_add_profile_sp [ @profile_name = ] 'profile_name'
[ , [ @description = ] 'description' ]
[ , [ @profile_id = ] new_profile_id OUTPUT ]
인수
- [ @profile_name = ] 'profile_name'
새 프로필의 이름입니다. profile_name은 sysname이며 기본값은 없습니다.
- [ @description = ] 'description'
새 프로필에 대한 설명입니다(옵션). description은 **nvarchar(256)**이며 기본값은 없습니다.
- [ @profile_id = ] new_profile_idOUTPUT
새 프로필의 ID를 반환합니다. new_profile_id는 int이며 기본값은 NULL입니다.
반환 코드 값
0(성공) 또는 1(실패)
주의
데이터베이스 메일 프로필에는 여러 개의 데이터베이스 메일 계정이 있습니다. 데이터베이스 메일 저장 프로시저는 해당 프로시저에서 생성된 프로필 이름이나 프로필 ID로 프로필을 참조할 수 있습니다. 프로필에 계정을 추가하는 방법은 sysmail_add_profileaccount_sp(Transact-SQL)를 참조하십시오.
프로필 이름과 설명은 프로필 ID가 해당 프로필의 수명 동안 그대로 남아 있는 경우 sysmail_update_profile_sp 저장 프로시저를 통해 변경될 수 있습니다.
프로필 이름은 Microsoft SQL Server 데이터베이스 엔진에 고유해야 합니다. 그렇지 않으면 저장 프로시저가 오류를 반환합니다.
sysmail_add_profile_sp 저장 프로시저는 msdb 데이터베이스에 있으며 dbo 스키마가 소유합니다. 현재 데이터베이스가 msdb가 아닐 경우 이 프로시저를 세 부분으로 구성된 이름으로 실행해야 합니다.
사용 권한
이 프로시저에 대한 실행 권한은 기본적으로 sysadmin 고정 서버 역할의 멤버로 설정됩니다.
예
1. 새 프로필 작성
다음 예에서는 AdventureWorks Administrator라는 새 데이터베이스 메일 프로필을 만듭니다.
EXECUTE msdb.dbo.sysmail_add_profile_sp
@profile_name = 'AdventureWorks Administrator',
@description = 'Profile used for administrative mail.' ;
2. 새 프로필 작성 및 변수에 프로필 저장
다음 예에서는 AdventureWorks Administrator라는 새 데이터베이스 메일 프로필을 만듭니다. 이 예에서는 프로필 ID를 @profileId 변수에 저장하고 새 프로필의 프로필 ID를 포함하는 결과 집합을 반환합니다.
DECLARE @profileId INT ;
EXECUTE msdb.dbo.sysmail_add_profile_sp
@profile_name = 'AdventureWorks Administrator',
@description = 'Profile used for administrative mail.',
@profile_id = @profileId OUTPUT ;
SELECT @profileId ;
참고 항목
참조
데이터베이스 메일 및 SQL 메일 저장 프로시저(Transact-SQL)
관련 자료
데이터베이스 메일
데이터베이스 메일 계정
데이터베이스 메일 프로필
구성 작업 선택(데이터베이스 메일)