jobs.sp_delete_jobstep (Azure エラスティック ジョブ) (Transact-SQL)

適用対象:Azure SQL Database

Azure SQL Database の Azure Elastic Jobs サービスの既存の ジョブから既存のジョブ ステップを削除します

このストアド プロシージャは、SQL Server エージェント サービスの sp_delete_jobstep SQL Server の同様のオブジェクトと名前を共有します。 SQL Server エージェントバージョンの詳細については、「sp_delete_jobstep (Transact-SQL)」を参照してください

Transact-SQL 構文表記規則

構文

[jobs].sp_delete_jobstep [ @job_name = ] 'job_name'
     [ , [ @step_id = ] step_id ]
     [ , [ @step_name = ] 'step_name' ]
     [ , [ @job_version = ] job_version OUTPUT ]

引数

@job_name

ステップを削除するジョブの名前。 job_nameは nvarchar(128) で、既定値はありません。

@step_id

削除するジョブ ステップの ID 番号。 step_idまたはstep_name指定する必要があります。 step_idは int です。

@step_name

削除するステップの名前。 step_idまたはstep_name指定する必要があります。 step_nameは nvarchar(128) です。

@job_version 出力

新しいジョブのバージョン番号が割り当てられた出力パラメーター。 job_versionは int です。

リターン コードの値

0 (成功) または 1 (失敗)

解説

ジョブ全体を削除するには、jobs.sp_delete_job (Azure エラスティック ジョブ) (Transact-SQL) を使用します。

ジョブの進行中の実行は影響を受けません。

他のジョブ ステップは、削除されたジョブ ステップによって残されたギャップを埋めるために自動的に番号が付け直されます。

アクセス許可

既定では、このストアド プロシージャを実行できるのは、 sysadmin 固定サーバー ロールのメンバーです。 このストアド プロシージャを使って、他のユーザーが所有するジョブの属性を編集できるのは、sysadmin のメンバーだけです。