다음을 통해 공유

  • 아티클

sysmail_add_profile_sp(Transact-SQL)

새 데이터베이스 메일 프로필을 만듭니다.

[!참고]

데이터베이스 메일은 MAPI(Messaging Application Programming Interface)를 사용하지 않으므로 데이터베이스 메일 프로필은 MAPI 메일 프로필이 아닙니다. 데이터베이스 메일은 SQL 메일 프로필을 사용하지 않습니다.

항목 링크 아이콘Transact-SQL 구문 표기 규칙

구문

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 ;