다음을 통해 공유


sysmail_update_profile_sp(Transact-SQL)

데이터베이스 메일 프로필의 설명이나 이름을 변경합니다.

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

구문

sysmail_update_profile_sp [ [ @profile_id = ] profile_id , ] [ [ @profile_name = ] 'profile_name' , ]
    [ [ @description = ] 'description' ]

인수

  • [ @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 중 하나 이상을 지정해야 합니다. 둘 다 지정하면 프로시저에서 프로필의 이름을 변경합니다.

  • [ @description = ] 'description'
    프로필에 대한 새 설명입니다. description은 nvarchar(256)이며 기본값은 NULL입니다.

반환 코드 값

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

주의

프로필 ID와 프로필 이름을 둘 다 지정하면 프로시저가 프로필 이름을 제공된 이름으로 변경하고 프로필에 대한 설명을 업데이트합니다. 이 인수 중 하나만 제공할 경우 프로시저는 프로필에 대한 설명을 업데이트합니다.

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

사용 권한

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

1. 프로필 설명 변경

다음 예에서는 msdb 데이터베이스에서 AdventureWorks Administrator라는 프로필에 대한 설명을 변경합니다.

EXECUTE msdb.dbo.sysmail_update_profile_sp
    @profile_name = 'AdventureWorks Administrator'
    ,@description = 'Administrative mail profile.';

2. 프로필의 이름과 설명 변경

다음 예에서는 프로필 ID가 750인 프로필의 이름과 설명을 변경합니다.

EXECUTE msdb.dbo.sysmail_update_profile_sp
    @profile_id = 750
    ,@profile_name = 'Operator'
    ,@description = 'Profile to send alert e-mail to operators.';