sysmail_add_profile_sp(Transact-SQL)

  • 아티클

적용 대상:SQL ServerAzure SQL Managed Instance

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

Transact-SQL 구문 표기 규칙

구문

sysmail_add_profile_sp [ @profile_name = ] 'profile_name'
    [ , [ @description = ] N'description' ]
    [ , [ @profile_id = ] new_profile_id OUTPUT ]
[ ; ]

인수

[ @profile_name = ] 'profile_name'

새 프로필 이름입니다. @profile_name 기본값이 없는 sysname입니다.

Azure SQL Managed Instance에서 SQL Server 에이전트 작업을 사용하여 전자 메일을 보내려면 SQL Server 에이전트 하나의 데이터베이스 메일 프로필만 사용할 수 있으며 호출AzureManagedInstance_dbmail_profile해야 합니다. 자세한 내용 및 샘플 스크립트는 Azure SQL Managed Instance SQL 에이전트 작업 알림을 참조 하세요.

[ @description = ] N'description'

새 프로필에 대한 선택적 설명입니다. @description 기본값이 없는 nvarchar(256)입니다.

[ @profile_id = ] new_profile_id OUTPUT

새 프로필의 ID를 반환합니다. @profile_id 기본값NULL인 int입니다.

반환 코드 값

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

설명

데이터베이스 메일 프로필에는 여러 데이터베이스 메일 계정이 있습니다. 데이터베이스 메일 저장 프로시저는 프로필 이름 또는 이 프로시저에서 생성된 프로필 ID로 프로필을 참조할 수 있습니다. 프로필에 계정을 추가하는 방법에 대한 자세한 내용은 sysmail_add_profileaccount_sp(Transact-SQL)를 참조하세요.

프로필 이름과 설명은 저장 프로시저sysmail_update_profile_sp를 사용하여 변경할 수 있으며 프로필 ID는 프로필 수명 동안 상수로 기본.

프로필 이름은 SQL Server 데이터베이스 엔진 인스턴스에서 고유해야 합니다. 그렇지 않은 경우 저장 프로시저에서 오류가 반환됩니다.

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

사용 권한

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

예제

A. 새 프로필 만들기

다음 예에서는 AdventureWorks Administrator라는 새 데이터베이스 메일 프로필을 만듭니다.

EXEC msdb.dbo.sysmail_add_profile_sp
       @profile_name = 'AdventureWorks Administrator',
       @description = 'Profile used for administrative mail.';

B. 새 프로필을 만들어 프로필 ID를 변수에 저장

다음 예에서는 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;

관련 콘텐츠