sp_update_job(Transact-SQL)

아티클
12/22/2023

적용 대상:SQL Server Azure SQL Managed Instance

SQL Server 에이전트 서비스에서 만든 기존 작업의 특성을 업데이트.

구문

sp_update_job
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @new_name = ] N'new_name' ]
    [ , [ @enabled = ] enabled ]
    [ , [ @description = ] N'description' ]
    [ , [ @start_step_id = ] start_step_id ]
    [ , [ @category_name = ] N'category_name' ]
    [ , [ @owner_login_name = ] N'owner_login_name' ]
    [ , [ @notify_level_eventlog = ] notify_level_eventlog ]
    [ , [ @notify_level_email = ] notify_level_email ]
    [ , [ @notify_level_netsend = ] notify_level_netsend ]
    [ , [ @notify_level_page = ] notify_level_page ]
    [ , [ @notify_email_operator_name = ] N'notify_email_operator_name' ]
    [ , [ @notify_netsend_operator_name = ] N'notify_netsend_operator_name' ]
    [ , [ @notify_page_operator_name = ] N'notify_page_operator_name' ]
    [ , [ @delete_level = ] delete_level ]
    [ , [ @automatic_post = ] automatic_post ]
[ ; ]

인수

[ @job_id = ] 'job_id'

업데이트할 작업의 ID입니다. @job_id 기본값NULL인 uniqueidentifier입니다.

@job_id 또는 @job_name 지정해야 하지만 둘 다 지정할 수는 없습니다.

[ @job_name = ] N'job_name'

작업의 이름입니다. @job_name sysname이며 기본값은 .입니다NULL.

@job_id 또는 @job_name 지정해야 하지만 둘 다 지정할 수는 없습니다.

[ @new_name = ] N'new_name'

작업의 새 이름입니다. @new_name sysname이며 기본값은 .입니다NULL.

[ @enabled = ] 사용

작업을 사용할 수 있는지(1) 또는 활성화되지 않았는지(0)를 지정합니다. @enabled 기본값NULL인 tinyint입니다.

[ @description = ] N'description'

작업에 대한 설명입니다. @description 기본값NULL인 nvarchar(512)입니다.

[ @start_step_id = ] start_step_id

작업에 대해 실행할 첫 번째 단계의 ID 번호입니다. @start_step_id 기본값NULL인 int입니다.

[ @category_name = ] N'category_name'

작업 범주입니다. @category_name sysname이며 기본값은 .입니다NULL.

[ @owner_login_name = ] N'owner_login_name'

작업을 소유하는 로그인의 이름입니다. @owner_login_name sysname이며 기본값은 .입니다NULL. sysadmin 고정 서버 역할의 멤버만 작업 소유권을 변경할 수 있습니다.

[ @notify_level_eventlog = ] notify_level_eventlog

이 작업에 대한 Microsoft Windows 애플리케이션 로그에 항목을 배치할 시기를 지정합니다. @notify_level_eventlog int이며 이러한 값 중 하나일 수 있습니다.

값	설명(동작)
`0`	안 함
`1`	성공
`2`	실패 시
`3`	항상

[ @notify_level_email = ] notify_level_email

이 작업이 완료되면 전자 메일을 보낼 시기를 지정합니다. @notify_level_email 기본값NULL인 int입니다. @notify_level_email @notify_level_eventlog 동일한 값을 사용합니다.

[ @notify_level_netsend = ] notify_level_netsend

이 작업이 완료되면 네트워크 메시지를 보낼 시기를 지정합니다. @notify_level_netsend 기본값NULL인 int입니다. @notify_level_netsend @notify_level_eventlog 동일한 값을 사용합니다.

[ @notify_level_page = ] notify_level_page

이 작업이 완료되면 페이지를 보낼 시기를 지정합니다. @notify_level_page 기본값NULL인 int입니다. @notify_level_page @notify_level_eventlog 동일한 값을 사용합니다.

[ @notify_email_operator_name = ] N'notify_email_operator_name'

email_level 연결할 때 전자 메일을 보낼 운영자의 이름입니다. @notify_email_operator_name sysname이며 기본값은 .입니다NULL.

[ @notify_netsend_operator_name = ] N'notify_netsend_operator_name'

네트워크 메시지를 보낼 운영자의 이름입니다. @notify_netsend_operator_name sysname이며 기본값은 .입니다NULL.

[ @notify_page_operator_name = ] N'notify_page_operator_name'

페이지를 받을 운영자의 이름입니다. @notify_page_operator_name sysname이며 기본값은 .입니다NULL.

[ @delete_level = ] delete_level

작업을 삭제할 시기를 지정합니다. @delete_level 기본값NULL인 int입니다. @delete_level @notify_level_eventlog 동일한 값을 사용합니다.

[ @automatic_post = ] automatic_post

정보를 제공하기 위해서만 확인됩니다. 지원 안 됨 향후 호환성은 보장되지 않습니다.

반환 코드 값

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

설명

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

sp_update_job 는 매개 변수 값이 제공되는 설정만 변경합니다. 매개 변수를 생략하면 현재 설정이 유지됩니다.

이 저장 프로시저는 Azure SQL Database용 Azure Elastic Jobs 서비스에 대한 유사한 개체와 이름을 sp_update_job 공유합니다. 탄력적 작업 버전에 대한 자세한 내용은 jobs.sp_update_job(Azure 탄력적 작업)(Transact-SQL)을 참조하세요.

사용 권한

이 저장 프로시저는 db_owner 역할이 소유합니다. 모든 사용자에 대한 사용 권한을 부여 EXECUTE 할 수 있지만 SQL Server 업그레이드 중에 이러한 권한이 재정의될 수 있습니다.

다른 사용자에게는 데이터베이스에서 다음 SQL Server 에이전트 고정 데이터베이스 역할 msdb 중 하나가 부여되어야 합니다.

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

sp_update_job(Transact-SQL)

구문

인수

[ @job_id = ] 'job_id'

[ @job_name = ] N'job_name'

[ @new_name = ] N'new_name'

[ @enabled = ] 사용

[ @description = ] N'description'

[ @start_step_id = ] start_step_id

[ @category_name = ] N'category_name'

[ @owner_login_name = ] N'owner_login_name'

[ @notify_level_eventlog = ] notify_level_eventlog

[ @notify_level_email = ] notify_level_email

[ @notify_level_netsend = ] notify_level_netsend

[ @notify_level_page = ] notify_level_page

[ @notify_email_operator_name = ] N'notify_email_operator_name'

[ @notify_netsend_operator_name = ] N'notify_netsend_operator_name'

[ @notify_page_operator_name = ] N'notify_page_operator_name'

[ @delete_level = ] delete_level

[ @automatic_post = ] automatic_post

반환 코드 값

설명

사용 권한

예제

피드백

피드백

추가 리소스

sp_update_job(Transact-SQL)

구문

인수

[ @job_id = ] 'job_id'

[ @job_name = ] N'job_name'

[ @new_name = ] N'new_name'

[ @enabled = ] 사용

[ @description = ] N'description'

[ @start_step_id = ] start_step_id

[ @category_name = ] N'category_name'

[ @owner_login_name = ] N'owner_login_name'

[ @notify_level_eventlog = ] notify_level_eventlog

[ @notify_level_email = ] notify_level_email

[ @notify_level_netsend = ] notify_level_netsend

[ @notify_level_page = ] notify_level_page

[ @notify_email_operator_name = ] N'notify_email_operator_name'

[ @notify_netsend_operator_name = ] N'notify_netsend_operator_name'

[ @notify_page_operator_name = ] N'notify_page_operator_name'

[ @delete_level = ] delete_level

[ @automatic_post = ] automatic_post

반환 코드 값

설명

사용 권한

예제

관련 콘텐츠

피드백

피드백

추가 리소스