sp_notify_operator(Transact-SQL)

업데이트: 2006년 7월 17일

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

구문

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입니다. idint이며 기본값은 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?is 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?is Ajenstat',
   @subject = N'Test Notification',
   @body = N'This is a test of notification via e-mail.' ;
GO

참고 항목

참조

sp_add_operator(Transact-SQL)
sp_help_operator(Transact-SQL)
sp_delete_operator(Transact-SQL)

도움말 및 정보

SQL Server 2005 지원 받기

변경 내역

릴리스 내역

2006년 7월 17일

변경된 내용
  • 예에서 인수 이름 @profilename@profile_name으로 업데이트했습니다.

2006년 4월 14일

변경된 내용
  • 인수 이름 @profilename@profile_name으로 업데이트했으며 데이터 형식을 sysname에서 nvarchar(128)로 변경했습니다.
  • @name의 데이터 형식을 sysname에서 nvarchar(128)로 변경했습니다.