sp_update_job(Transact-SQL)

아티클
02/18/2014

작업의 특성을 변경합니다.

구문

sp_update_job [ @job_id =] job_id | [@job_name =] 'job_name'
     [, [@new_name =] 'new_name' ] 
     [, [@enabled =] enabled ]
     [, [@description =] 'description' ] 
     [, [@start_step_id =] step_id ]
     [, [@category_name =] 'category' ] 
     [, [@owner_login_name =] 'login' ]
     [, [@notify_level_eventlog =] eventlog_level ]
     [, [@notify_level_email =] email_level ]
     [, [@notify_level_netsend =] netsend_level ]
     [, [@notify_level_page =] page_level ]
     [, [@notify_email_operator_name =] 'operator_name' ]
     [, [@notify_netsend_operator_name =] 'netsend_operator' ]
     [, [@notify_page_operator_name =] 'page_operator' ]
     [, [@delete_level =] delete_level ] 
     [, [@automatic_post =] automatic_post ]

인수

[ @job_id =] job_id
업데이트할 작업의 ID입니다. job_id는 uniqueidentifier입니다.
[ @job_name =] 'job_name'
작업의 이름입니다. job_name은 nvarchar(128)입니다.

[!참고]

job_id 또는 job_name 중 하나를 지정해야 하며 둘 다를 지정할 수는 없습니다.
[ @new_name =] 'new_name'
작업의 새 이름입니다. new_name은 nvarchar(128)입니다.
[ @enabled =] enabled
작업을 설정할지(1) 또는 설정하지 않을지(0) 여부를 지정합니다. enabled는 tinyint입니다.
[ @description =] 'description'
작업에 대한 설명입니다. description은 nvarchar(512)입니다.
[ @start_step_id =] step_id
작업을 실행하기 위한 첫 단계의 ID입니다. step_id는 int입니다.
[ @category_name =] 'category'
작업 범주입니다. category는 nvarchar(128)입니다.
[ @owner_login_name =] 'login'
작업을 소유하는 로그인의 이름입니다. login은 nvarchar(128)입니다. sysadmin 고정 서버 역할의 멤버만 작업 소유권을 변경할 수 있습니다.
[ @notify_level_eventlog =] eventlog_level
Microsoft Windows 응용 프로그램 로그에 이 작업에 대한 항목을 저장하는 시기를 지정합니다. eventlog_level은 int이며 다음 값 중 하나일 수 있습니다.

값

설명(동작)

0

안 함

1

성공한 경우

2

실패한 경우

3

항상
[ @notify_level_email =] email_level
해당 작업이 완료될 때 전자 메일을 보낼 시기를 지정합니다. email_level은 int입니다. email_level은 eventlog_level과 같은 값을 사용합니다.
[ @notify_level_netsend =] netsend_level
해당 작업이 완료되었을 때 네트워크 메시지를 보낼 시기를 지정합니다. netsend_level은 int입니다. netsend_level은 eventlog_level과 같은 값을 사용합니다.
[ @notify_level_page =] page_level
해당 작업이 완료될 때 페이지를 보낼 시기를 지정합니다. page_level은 int입니다. page_level은 eventlog_level과 같은 값을 사용합니다.
[ @notify_email_operator_name =] 'email_name'
email_level에 도달했을 때 전자 메일을 받을 운영자의 이름입니다. email_name은 nvarchar(128)입니다.
[ @notify_netsend_operator_name =] 'netsend_operator'
네트워크 메시지를 받을 운영자의 이름입니다. netsend_operator는 nvarchar(128)입니다.
[ @notify_page_operator_name =] 'page_operator'
페이지를 받을 운영자의 이름입니다. page_operator는 nvarchar(128)입니다.
[ @delete_level =] delete_level
작업 삭제 시기를 지정합니다. delete_value는 int입니다. delete_level은 eventlog_level과 같은 값을 사용합니다.
[ @automatic_post =] automatic_post
예약되어 있습니다.

값	설명(동작)
0	안 함
1	성공한 경우
2	실패한 경우
3	항상

반환 코드 값

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

주의

sp_update_job은 반드시 msdb 데이터베이스에서 실행해야 합니다.

sp_update_job은 매개 변수 값이 제공되는 설정만 변경합니다. 매개 변수가 생략되면 현재 설정이 보존됩니다.

사용 권한

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

SQLAgentUserRole
SQLAgentReaderRole
SQLAgentOperatorRole

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

sysadmin의 멤버만 이 저장 프로시저를 사용하여 다른 사용자가 소유한 작업 특성을 편집할 수 있습니다.

예

다음 예에서는 NightlyBackups 작업의 이름, 설명 및 활성화 상태를 변경합니다.

USE msdb ;
GO

EXEC dbo.sp_update_job
    @job_name = N'NightlyBackups',
    @new_name = N'NightlyBackups -- Disabled',
    @description = N'Nightly backups disabled during server migration.',
    @enabled = 0 ;
GO