sp_notify_operator(Transact-SQL)

아티클
06/18/2013

데이터베이스 메일을 사용하여 운영자에게 전자 메일 메시지를 보냅니다.

구문

sp_notify_operator
    [ @profile_name = ] 'profilename' ,
    [ @id = ] id ,
    [ @name = ] 'name' ,
    [ @subject = ] 'subject' ,
    [ @body = ] 'message' ,
    [ @file_attachments = ] 'attachment' 
    [ @mail_database = ] 'mail_host_database'

인수

[ @profile_name= ] 'profilename'
메시지를 보내는 데 사용할 데이터베이스 메일 프로필의 이름입니다. profilename은 nvarchar(128)입니다. profilename을 지정하지 않은 경우 기본 데이터베이스 메일 프로필이 사용됩니다.
[ @id= ] id
메시지를 받을 운영자의 식별자입니다. id는 int이며 기본값은 NULL입니다. id 또는 name 중 하나를 지정해야 합니다.
[ @name= ] 'name'
메시지를 받을 운영자의 이름입니다. name은 nvarchar(128)이며 기본값은 NULL입니다. id 또는 name 중 하나를 지정해야 합니다.

[!참고]

메시지를 보내기 전에 운영자의 전자 메일 주소가 정의되어야 합니다.
[ @subject= ] 'subject'
전자 메일 메시지의 제목입니다. subject는 nvarchar(256)이며 기본값은 없습니다.
[ @body= ] 'message'
전자 메일 메시지의 본문입니다. message는 nvarchar(max)이며 기본값은 없습니다.
[ @file_attachments= ] 'attachment'
전자 메일 메시지에 첨부할 파일의 이름입니다. attachment는 nvarchar(512)이며 기본값은 없습니다.
[ @mail_database= ] 'mail_host_database'
메일 호스트 데이터베이스의 이름을 지정합니다. mail_host_database는 nvarchar(128)입니다. mail_host_database를 지정하지 않은 경우 msdb 데이터베이스가 기본값으로 사용됩니다.

반환 코드 값

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

주의

지정한 메시지를 지정된 운영자의 전자 메일 주소로 보냅니다. 운영자의 전자 메일 주소가 설정되지 않은 경우 오류를 반환합니다.

데이터베이스 메일과 메일 호스트 데이터베이스는 운영자에게 알림을 보내기 전에 구성해야 합니다.

사용 권한

기본적으로 sysadmin 고정 서버 역할의 멤버는 이 저장 프로시저를 실행할 수 있습니다. 다른 사용자는 msdb 데이터베이스의 다음 SQL Server 에이전트 고정 데이터베이스 역할 중 하나를 부여 받아야 합니다.

SQLAgentUserRole
SQLAgentReaderRole
SQLAgentOperatorRole

이러한 역할의 사용 권한에 대한 자세한 내용은 SQL Server 에이전트 고정 데이터베이스 역할을 참조하십시오.

예

다음 예에서는 AdventureWorks Administrator 데이터베이스 메일 프로필을 사용하여 운영자 François Ajenstat에게 알림 전자 메일을 보냅니다. 전자 메일의 제목은 Test Notification입니다. 전자 메일 메시지에는 "This is a test of notification via e-mail."이라는 문장이 포함되어 있습니다.

USE msdb ;
GO

EXEC dbo.sp_notify_operator
   @profile_name = N'AdventureWorks Administrator',
   @name = N'François Ajenstat',
   @subject = N'Test Notification',
   @body = N'This is a test of notification via e-mail.' ;
GO