sp_delete_job(Transact-SQL)
작업을 삭제합니다.
구문
sp_delete_job { [ @job_id = ] job_id | [ @job_name = ] 'job_name' } ,
[ , [ @originating_server = ] 'server' ]
[ , [ @delete_history = ] delete_history ]
[ , [ @delete_unused_schedule = ] delete_unused_schedule ]
인수
- [ @job_id= ] job_id
삭제할 작업의 ID입니다. job_id는 uniqueidentifier이며 기본값은 NULL입니다.
[ @job_name= ] 'job_name'
삭제할 작업의 이름입니다. job_name은 sysname이며 기본값은 NULL입니다.[!참고] job_id 또는 job_name 중 하나를 지정해야 하며 둘 다를 지정할 수는 없습니다.
- [ @originating_server= ] 'server'
내부적으로만 사용할 수 있습니다.
[ @delete_history= ] delete_history
작업 기록 삭제 여부를 지정합니다. delete_history는 bit이며 기본값은 1입니다. delete_history가 1이면 작업 기록이 삭제됩니다. delete_history가 0이면 작업 기록이 삭제되지 않습니다.작업이 삭제되고 기록은 삭제되지 않은 경우, 작업에 대한 기록 정보는 SQL Server 에이전트 그래픽 사용자 인터페이스 작업 기록에 표시되지 않지만 msdb 데이터베이스의 sysjobhistory 테이블에는 그대로 남아 있습니다.
- [ @delete_unused_schedule= ] delete_unused_schedule
이 작업에 연결된 일정이 다른 작업에 영향을 주지 않을 경우 해당 일정의 삭제 여부를 지정합니다. delete_unused_schedule은 bit이며 기본값은 1입니다. delete_unused_schedule이 1이면 다른 작업이 이 작업에 연결된 일정을 참조하지 않을 경우 해당 일정이 삭제됩니다. delete_unused_schedule이 0이면 일정이 삭제되지 않습니다.
반환 코드 값
0(성공) 또는 1(실패)
결과 집합
없음
주의
@originating_server 인수는 내부 사용을 위해 예약되어 있습니다.
@delete_unused_schedule 인수는 작업에 연결되어 있지 않은 일정을 자동으로 제거하여 SQL Server 이전 버전과의 호환성을 제공합니다. 이 매개 변수는 이전 버전과의 호환성 동작이 기본적으로 설정되어 있습니다. 작업에 연결되어 있지 않은 일정을 유지하려면 0 값을 @delete_unused_schedule 인수로 제공해야 합니다.
SQL Server Management Studio는 작업 구조를 만들고 관리할 수 있는 바람직한 방법을 제공하는데, 이는 그래픽을 사용하여 쉽게 작업을 관리할 수 있는 방법입니다.
이 저장 프로시저는 유지 관리 계획을 삭제할 수 없으며 유지 관리 계획의 일부인 작업도 삭제할 수 없습니다. 유지 관리 계획을 삭제하려면 대신 SQL Server Management Studio를 사용하십시오.
사용 권한
기본적으로 sysadmin 고정 서버 역할의 멤버는 이 저장 프로시저를 실행할 수 있습니다. 다른 사용자는 msdb 데이터베이스의 다음 SQL Server 에이전트 고정 데이터베이스 역할 중 하나를 부여 받아야 합니다.
- SQLAgentUserRole
- SQLAgentReaderRole
- SQLAgentOperatorRole
이러한 역할의 사용 권한에 대한 자세한 내용은 SQL Server 에이전트 고정 데이터베이스 역할을 참조하십시오.
sysadmin 고정 서버 역할의 멤버만 sp_delete_job을 실행하여 모든 작업을 삭제할 수 있습니다. sysadmin 고정 서버 역할의 멤버가 아닌 사용자는 해당 사용자가 소유한 작업만 삭제할 수 있습니다.
예
다음 예에서는 NightlyBackups
작업을 삭제합니다.
USE msdb ;
GO
EXEC sp_delete_job
@job_name = N'NightlyBackups' ;
GO
참고 항목
참조
sp_add_job(Transact-SQL)
sp_help_job(Transact-SQL)
sp_update_job(Transact-SQL)
시스템 저장 프로시저(Transact-SQL)