sp_start_job(Transact-SQL)
SQL Server 에이전트가 즉시 작업을 실행하도록 지시합니다.
.gif "항목 링크 아이콘")
구문
sp_start_job
{ [@job_name =] 'job_name'
| [@job_id =] job_id }
[ , [@error_flag =] error_flag]
[ , [@server_name =] 'server_name']
[ , [@step_name =] 'step_name']
[ , [@output_flag =] output_flag]
인수
[ @job_name= ] 'job_name'
시작할 작업의 이름입니다. job_id 또는 job_name 중 하나를 지정해야 하며 둘 다를 지정할 수는 없습니다. job_name은 sysname이며 기본값은 NULL입니다.[ @job_id= ] job_id
시작할 작업의 ID입니다. job_id 또는 job_name 중 하나를 지정해야 하며 둘 다를 지정할 수는 없습니다. job_id는 uniqueidentifier이며 기본값은 NULL입니다.[ @error_flag= ] error_flag
정보를 제공하기 위해서만 확인됩니다. 지원되지 않습니다. 향후 호환성은 보장되지 않습니다.[ @server_name= ] 'server_name'
작업을 시작할 대상 서버입니다. server_name은 nvarchar(128)이며 기본값은 NULL입니다. server_name은 현재 작업의 대상 서버 중 하나여야 합니다.[ @step_name= ] 'step_name'
작업 실행을 시작할 단계의 이름입니다. 로컬 로그에만 적용됩니다. step_name은 sysname이며 기본값은 NULL입니다.[ @output_flag= ] output_flag
정보를 제공하기 위해서만 확인됩니다. 지원되지 않습니다. 향후 호환성은 보장되지 않습니다.
반환 코드 값
0(성공) 또는 1(실패)
결과 집합
없음
주의
이 저장 프로시저는 msdb 데이터베이스에 저장됩니다.
사용 권한
기본적으로 sysadmin 고정 서버 역할의 멤버는 이 저장 프로시저를 실행할 수 있습니다. 다른 사용자는 msdb 데이터베이스의 다음 SQL Server 에이전트 고정 데이터베이스 역할 중 하나를 부여 받아야 합니다.
SQLAgentUserRole
SQLAgentReaderRole
SQLAgentOperatorRole
이러한 역할의 사용 권한에 대한 자세한 내용은 SQL Server 에이전트 고정 데이터베이스 역할을 참조하십시오.
SQLAgentUserRole 및 SQLAgentReaderRole의 멤버는 각자 소유한 작업만 시작할 수 있습니다. SQLAgentOperatorRole의 멤버는 다른 사용자가 소유한 작업을 비롯하여 모든 로컬 작업을 시작할 수 있습니다. sysadmin의 멤버는 모든 로컬 및 다중 서버 작업을 시작할 수 있습니다.
예
다음 예에서는 Weekly Sales Data Backup라는 작업을 시작합니다.
USE msdb ;
GO
EXEC dbo.sp_start_job N'Weekly Sales Data Backup' ;
GO