sp_add_operator(Transact-SQL)

경고 및 작업과 함께 사용할 운영자(알림 수신자)를 만듭니다.

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

구문

sp_add_operator [ @name = ] 'name' 
     [ , [ @enabled = ] enabled ] 
     [ , [ @email_address = ] 'email_address' ] 
     [ , [ @pager_address = ] 'pager_address' ] 
     [ , [ @weekday_pager_start_time = ] weekday_pager_start_time ] 
     [ , [ @weekday_pager_end_time = ] weekday_pager_end_time ] 
     [ , [ @saturday_pager_start_time = ] saturday_pager_start_time ] 
     [ , [ @saturday_pager_end_time = ] saturday_pager_end_time ] 
     [ , [ @sunday_pager_start_time = ] sunday_pager_start_time ] 
     [ , [ @sunday_pager_end_time = ] sunday_pager_end_time ] 
     [ , [ @pager_days = ] pager_days ] 
     [ , [ @netsend_address = ] 'netsend_address' ] 
     [ , [ @category_name = ] 'category' ] 

인수

  • [ @name= ] 'name'
    운영자(알림 수신자)의 이름입니다. 이 이름은 고유해야 하며 % 문자를 포함할 수 없습니다. name은 sysname이며 기본값은 없습니다.

  • [ @enabled= ] enabled
    운영자의 현재 상태를 나타냅니다. enabled는 tinyint이며 기본값은 1(사용)입니다. 0인 경우에는 운영자를 사용할 수 없으며 알림을 수신하지 않습니다.

  • [ @email_address= ] 'email_address'
    운영자의 전자 메일 주소입니다. 이 문자열은 전자 메일 시스템으로 직접 전달됩니다. email_address는 nvarchar(100)이며 기본값은 NULL입니다.

    email_address에 실제 전자 메일 주소나 별칭을 지정할 수 있습니다. 예를 들면 다음과 같습니다.

    'jdoe' 또는 'jdoe@xyz.com'

    [!참고]

    데이터베이스 메일에서는 전자 메일 주소를 사용해야 합니다.

  • [ @pager_address= ] 'pager_address'
    운영자의 호출기 주소입니다. 이 문자열은 전자 메일 시스템으로 직접 전달됩니다. pager_address는 narchar(100)이며 기본값은 NULL입니다.

  • [ @weekday_pager_start_time= ] weekday_pager_start_time
    SQL Server 에이전트가 월요일부터 금요일까지의 평일에 지정된 운영자에게 호출기 알림을 보내는 시간입니다. weekday_pager_start_time은 int이며 기본값은 24시간제로 오전 9시를 나타내는 090000입니다. 이때 시간은 HHMMSS 형식으로 입력해야 합니다.

  • [ @weekday_pager_end_time= ] weekday_pager_end_time
    SQLServerAgent 서비스가 월요일부터 금요일까지의 평일에 지정된 운영자에게 호출기 알림을 더 이상 보내지 않는 시간입니다. weekday_pager_end_time은 int이며 기본값은 24시간제로 오후 6시를 나타내는 180000입니다. 이때 시간은 HHMMSS 형식으로 입력해야 합니다.

  • [ @saturday_pager_start_time =] saturday_pager_start_time
    SQLServerAgent 서비스가 토요일에 지정된 운영자에게 호출기 알림을 보내는 시간입니다. saturday_pager_start_time은 int이며 기본값은 24시간제로 오전 9시를 나타내는 090000입니다. 이때 시간은 HHMMSS 형식으로 입력해야 합니다.

  • [ @saturday_pager_end_time= ] saturday_pager_end_time
    SQLServerAgent 서비스가 토요일에 지정된 운영자에게 호출기 알림을 더 이상 보내는 않는 시간입니다. saturday_pager_end_time은 int이며 기본값은 24시간제로 오후 6시를 나타내는 180000입니다. 이때 시간은 HHMMSS 형식으로 입력해야 합니다.

  • [ @sunday_pager_start_time= ] sunday_pager_start_time
    SQLServerAgent 서비스가 일요일에 지정된 운영자에게 호출기 알림을 보내는 시간입니다. sunday_pager_start_time은 int이며 기본값은 24시간제로 오전 9시를 나타내는 090000입니다. 이때 시간은 HHMMSS 형식으로 입력해야 합니다.

  • [ @sunday_pager_end_time =] sunday_pager_end_time
    SQLServerAgent 서비스가 일요일에 지정된 운영자에게 호출기 알림을 더 이상 보내는 않는 시간입니다. sunday_pager_end_time은 int이며 기본값은 24시간제로 오후 6시를 나타내는 180000입니다. 이때 시간은 HHMMSS 형식으로 입력해야 합니다.

  • [ @pager_days= ] pager_days
    운영자가 지정된 시작/종료 시간에 따라 호출할 수 있는 요일을 나타내는 숫자입니다. pager_days는 tinyint이며 기본값은 운영자가 호출을 받을 수 없음을 나타내는0입니다. 유효한 값은 0부터 127까지입니다. pager_days는 필요한 요일에 대한 개별 값을 더하여 계산합니다. 예를 들어 월요일부터 금요일까지는 2+4+8+16+32 = 62입니다. 다음 표에서는 각 요일에 대한 값을 나열합니다.

    설명

    1

    일요일

    2

    월요일

    4

    화요일

    8

    수요일

    16

    목요일

    32

    금요일

    64

    토요일

  • [ @netsend_address= ] 'netsend_address'
    네트워크 메시지가 전송되는 운영자의 네트워크 주소입니다. netsend_address는 nvarchar(100)이며 기본값은 NULL입니다.

  • [ @category_name= ] 'category'
    이 운영자에 대한 범주 이름입니다. category는 sysname이며 기본값은 NULL입니다.

반환 코드 값

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

결과 집합

없음

주의

sp_add_operatormsdb 데이터베이스에서 실행되어야 합니다.

호출은 전자 메일 시스템에 의해 지원되므로 호출 기능을 사용하려면 전자 메일에서 호출기로 전달되는 시스템이 있어야 합니다.

SQL Server Management Studio는 작업 구조를 만들고 관리할 수 있는 바람직한 방법을 제공하는데 이는 그래픽을 사용하여 쉽게 작업을 관리할 수 있는 방법입니다.

사용 권한

sysadmin 고정 서버 역할의 멤버만 sp_add_operator를 실행할 수 있습니다.

다음 예에서는 danwi에 대한 운영자 정보를 설정합니다. 운영자가 설정되어 있습니다. SQL Server 에이전트는 월요일부터 금요일, 오전 8시부터 오후 5시까지 호출기 알림을 보냅니다.

USE msdb ;
GO

EXEC dbo.sp_add_operator
    @name = N'Dan Wilson',
    @enabled = 1,
    @email_address = N'danwi',
    @pager_address = N'5551290AW@pager.Adventure-Works.com',
    @weekday_pager_start_time = 080000,
    @weekday_pager_end_time = 170000,
    @pager_days = 62 ;
GO

참고 항목

참조

sp_delete_operator(Transact-SQL)

sp_help_operator(Transact-SQL)

sp_update_operator(Transact-SQL)

시스템 저장 프로시저(Transact-SQL)