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

適用対象: ○SQL Server XAzure SQL Database XAzure SQL Data Warehouse XParallel Data WarehouseAPPLIES TO: yesSQL Server noAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

指示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、既定値は NULLstep_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)