sp_stop_job(Transact-SQL)
SQL Server 에이전트가 작업 실행을 중지하도록 지시합니다.
.gif "항목 링크 아이콘")
구문
sp_stop_job
[@job_name =] 'job_name'
| [@job_id =] job_id
| [@originating_server =] 'master_server'
| [@server_name =] 'target_server'
인수
[ @job_name =] 'job_name'
중지할 작업의 이름입니다. job_name은 sysname이며 기본값은 NULL입니다.[ @job_id =] job_id
중지할 작업의 ID입니다. job_id는 uniqueidentifier이며 기본값은 NULL입니다.[ @originating_server =] 'master_server'
마스터 서버의 이름입니다. 지정된 경우 모든 다중 서버 작업이 중지됩니다. master_server는 nvarchar(128)이며 기본값은 NULL입니다. 대상 서버에서 sp_stop_job을 호출할 때만 이 매개 변수를 지정합니다.[!참고]
처음 세 매개 변수 중 하나만 지정할 수 있습니다.
[ @server_name =] 'target_server'
다중 서버 작업을 중지할 특정 대상 서버의 이름입니다. target_server는 nvarchar(128)이며 기본값은 NULL입니다. 마스터 서버에서 다중 서버 작업에 대해 sp_stop_job을 호출할 때만 이 매개 변수를 지정합니다.
반환 코드 값
0(성공) 또는 1(실패)
결과 집합
없음
주의
SQL Server 에이전트는 중지 알림을 받으면 현재 실행 중인 작업 단계가 완료될 때까지 기다렸다가 취소 요청을 처리합니다. BACK, RESTORE 및 일부 DBCC 명령과 같은 일부 장기 실행 Transact-SQL 문은 완료되려면 시간이 오래 걸릴 수 있습니다. 이러한 문이 실행 중일 때는 작업이 취소될 때까지 시간이 오래 걸릴 수 있습니다. 작업을 중지하면 작업 기록에 "취소된 작업" 항목이 기록됩니다.
현재 작업이 CmdExec 또는 PowerShell 유형의 단계를 실행하고 있는 경우에는 실행 중인 프로세스(예: MyProgram.exe)가 중간에 종료됩니다. 예기치 않은 종료로 인해 프로세스가 보유하고 있던 파일이 열리는 등 예기치 않은 상황이 발생할 수 있습니다. 따라서 sp_stop_job은 작업에 CmdExec 또는 PowerShell 유형의 단계가 포함되어 있는 경우처럼 극단적인 상황에서만 사용해야 합니다.
사용 권한
기본적으로 sysadmin 고정 서버 역할의 멤버는 이 저장 프로시저를 실행할 수 있습니다. 다른 사용자는 msdb 데이터베이스의 다음 SQL Server 에이전트 고정 데이터베이스 역할 중 하나를 부여 받아야 합니다.
SQLAgentUserRole
SQLAgentReaderRole
SQLAgentOperatorRole
이러한 역할의 사용 권한에 대한 자세한 내용은 SQL Server 에이전트 고정 데이터베이스 역할을 참조하십시오.
SQLAgentUserRole 및 SQLAgentReaderRole의 멤버는 각자 소유한 작업만 중지할 수 있습니다. SQLAgentOperatorRole의 멤버는 다른 사용자가 소유한 작업을 비롯하여 모든 로컬 작업을 중지할 수 있습니다. sysadmin의 멤버는 모든 로컬 및 다중 서버 작업을 중지할 수 있습니다.
예
다음 예에서는 Weekly Sales Data Backup이라는 작업을 중지합니다.
USE msdb ;
GO
EXEC dbo.sp_stop_job
N'Weekly Sales Data Backup' ;
GO