sp_start_job (Transact-sql)sp_start_job (Transact-SQL)

適用対象:Applies to: はいSQL ServerSQL Server (サポートされているすべてのバージョン) yesSQL ServerSQL Server (all supported versions) 適用対象:Applies to: はいSQL ServerSQL Server (サポートされているすべてのバージョン) yesSQL ServerSQL Server (all supported versions)

SQL ServerSQL Server直ちにジョブを実行するようにエージェントに指示します。Instructs SQL ServerSQL Server Agent to execute a job immediately.

トピック リンク アイコン Transact-SQL 構文表記規則Topic link icon Transact-SQL Syntax Conventions

構文Syntax

  
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]  

引数Arguments

[ @job_name = ] 'job_name' 開始するジョブの名前を指定します。[ @job_name = ] 'job_name' The name of the job to start. Job_idまたはjob_nameのいずれかを指定する必要がありますが、両方を指定することはできません。Either job_id or job_name must be specified, but both cannot be specified. job_namesysname,、既定値は NULL です。job_name is sysname, with a default of NULL.

[ @job_id = ] job_id 開始するジョブの識別番号を指定します。[ @job_id = ] job_id The identification number of the job to start. Job_idまたはjob_nameのいずれかを指定する必要がありますが、両方を指定することはできません。Either job_id or job_name must be specified, but both cannot be specified. job_iduniqueidentifier,、既定値は NULL です。job_id is uniqueidentifier, with a default of NULL.

[ @error_flag = ] error_flag 単に情報を示すためだけに特定されます。Identified for informational purposes only. サポートされていません。Not supported. 将来の互換性は保証されません。Future compatibility is not guaranteed.[ @error_flag = ] error_flag 単に情報を示すためだけに特定されます。Identified for informational purposes only. サポートされていません。Not supported. 将来の互換性は保証されません。Future compatibility is not guaranteed.

[ @server_name = ] 'server_name' ジョブを開始する対象サーバー。[ @server_name = ] 'server_name' The target server on which to start the job. server_namenvarchar (128),、既定値は NULL です。server_name is nvarchar(128), with a default of NULL. server_name には、ジョブが現在対象となっている対象サーバーのいずれかを指定する必要があります。server_name must be one of the target servers to which the job is currently targeted.

[ @step_name = ] 'step_name' ジョブの実行を開始するステップの名前です。[ @step_name = ] 'step_name' The name of the step at which to begin execution of the job. ローカルジョブにのみ適用されます。Applies only to local jobs. step_namesysname,、既定値は NULL です。step_name is sysname, with a default of NULL

[ @output_flag = ] output_flag 単に情報を示すためだけに特定されます。Identified for informational purposes only. サポートされていません。Not supported. 将来の互換性は保証されません。Future compatibility is not guaranteed.[ @output_flag = ] output_flag 単に情報を示すためだけに特定されます。Identified for informational purposes only. サポートされていません。Not supported. 将来の互換性は保証されません。Future compatibility is not guaranteed.

リターン コードの値Return Code Values

0 (成功) または 1 (失敗)0 (success) or 1 (failure)

結果セットResult Sets

なしNone

解説Remarks

このストアドプロシージャは msdb データベースにあります。This stored procedure is in the msdb database.

アクセス許可Permissions

既定では、 sysadmin 固定サーバーロールのメンバーは、このストアドプロシージャを実行できます。By default, members of the sysadmin fixed server role can execute this stored procedure. 他のユーザーには、 SQL ServerSQL Server msdb データベースの次のいずれかの エージェント固定データベース ロールが許可されている必要があります。Other users must be granted one of the following SQL ServerSQL Server Agent fixed database roles in the msdb database:

  • SQLAgentUserRoleSQLAgentUserRole

  • SQLAgentReaderRoleSQLAgentReaderRole

  • SQLAgentOperatorRoleSQLAgentOperatorRole

これらのロールの権限の詳細については、「 SQL Server エージェントの固定データベース ロール」を参照してください。For details about the permissions of these roles, see SQL Server Agent Fixed Database Roles.

SQLAgentUserRoleSQLAgentReaderRoleのメンバーは、自分が所有するジョブのみを開始できます。Members of SQLAgentUserRole and SQLAgentReaderRole can only start jobs that they own. Sqlagentoperatorroleのメンバーは、他のユーザーによって所有されているものも含め、すべてのローカルジョブを開始できます。Members of SQLAgentOperatorRole can start all local jobs including those that are owned by other users. Sysadminのメンバーは、すべてのローカルジョブとマルチサーバージョブを開始できます。Members of sysadmin can start all local and multiserver jobs.

Examples

次の例では、という名前のジョブを開始し Weekly Sales Data Backup ます。The following example starts a job named Weekly Sales Data Backup.

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

参照See Also

sp_delete_job (Transact-sql) sp_delete_job (Transact-SQL)
sp_help_job (Transact-sql) sp_help_job (Transact-SQL)
sp_stop_job (Transact-sql) sp_stop_job (Transact-SQL)
sp_update_job (Transact-sql) sp_update_job (Transact-SQL)
システム ストアド プロシージャ (Transact-SQL)System Stored Procedures (Transact-SQL)