sp_start_job(Transact-SQL)

SQL Server 에이전트가 즉시 작업을 실행하도록 지시합니다.

항목 링크 아이콘 Transact-SQL 구문 표기 규칙

구문

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 에이전트 고정 데이터베이스 역할을 참조하십시오.

SQLAgentUserRoleSQLAgentReaderRole의 멤버는 각자 소유한 작업만 시작할 수 있습니다. SQLAgentOperatorRole의 멤버는 다른 사용자가 소유한 작업을 비롯하여 모든 로컬 작업을 시작할 수 있습니다. sysadmin의 멤버는 모든 로컬 및 다중 서버 작업을 시작할 수 있습니다.

다음 예에서는 Weekly Sales Data Backup라는 작업을 시작합니다.

USE msdb ;
GO

EXEC dbo.sp_start_job N'Weekly Sales Data Backup' ;
GO

참고 항목

참조

sp_delete_job(Transact-SQL)

sp_help_job(Transact-SQL)

sp_stop_job(Transact-SQL)

sp_update_job(Transact-SQL)

시스템 저장 프로시저(Transact-SQL)