sp_delete_jobstep (Transact-SQL)sp_delete_jobstep (Transact-SQL)

適用対象: yesSQL Server noAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse APPLIES TO: yesSQL Server noAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

ジョブからジョブ ステップを削除します。Removes a job step from a job.

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

構文Syntax

  
sp_delete_jobstep { [ @job_id = ] job_id | [ @job_name = ] 'job_name' } ,   
     [ @step_id = ] step_id   

引数Arguments

[ @job_id = ] job_id ステップの削除元となるジョブの識別番号。[ @job_id = ] job_id The identification number of the job from which the step will be removed. job_iduniqueidentifier、既定値は NULL です。job_idis uniqueidentifier, with a default of NULL.

[ @job_name = ] 'job_name' ステップの削除元となるジョブの名前。[ @job_name = ] 'job_name' The name of the job from which the step will be removed. job_namesysname、既定値は NULL です。job_nameis sysname, with a default of NULL.

注: いずれかjob_idまたはjob_name指定する必要があります。 両方を指定することはできません。NOTE: Either job_id or job_name must be specified; both cannot be specified.

[ @step_id = ] step_id 削除するステップの識別番号。[ @step_id = ] step_id The identification number of the step being removed. step_idint、既定値はありません。step_idis int, with no default.

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

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

結果セットResult Sets

なしNone

コメントRemarks

ジョブ ステップを削除すると、削除したステップを参照する他のジョブ ステップは自動的に更新されます。Removing a job step automatically updates the other job steps that reference the deleted step.

特定のジョブに関連する手順の詳細については、実行sp_help_jobstepします。For more information about the steps associated with a particular job, run sp_help_jobstep.

注: 呼び出すsp_delete_jobstepで、 step_idゼロの値はすべて、ジョブのジョブ ステップを削除します。NOTE: Calling sp_delete_jobstep with a step_id value of zero deletes all job steps for the job.

Microsoft SQL Server Management Studio は、ジョブを簡単に管理できるグラフィカルなツールです。ジョブのインフラストラクチャを作成し、管理するには、Microsoft SQL Server Management Studio を使用することをお勧めします。Microsoft SQL Server Management Studio provides an easy, graphical way to manage jobs, and is the recommended way to create and manage the job infrastructure.

アクセス許可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.

メンバーだけsysadmin別のユーザーが所有するジョブ ステップを削除することができます。Only members of sysadmin can delete a job step that is owned by another user.

使用例Examples

次の例では、ジョブ ステップを削除する1ジョブからWeekly Sales Data Backupします。The following example removes job step 1 from the job Weekly Sales Data Backup.

USE msdb ;  
GO  
  
EXEC dbo.sp_delete_jobstep  
    @job_name = N'Weekly Sales Data Backup',  
    @step_id = 1 ;  
GO  

関連項目See Also

表示またはジョブの変更 View or Modify Jobs
sp_add_jobstep (TRANSACT-SQL) sp_add_jobstep (Transact-SQL)
sp_update_jobstep (TRANSACT-SQL) sp_update_jobstep (Transact-SQL)
sp_help_jobstep (TRANSACT-SQL) sp_help_jobstep (Transact-SQL)
システム ストアド プロシージャ (Transact-SQL)System Stored Procedures (Transact-SQL)