適用対象:
SQL ServerAzure SQL Managed Instance
SQL Server エージェント サービスのジョブからジョブ ステップを削除します。
構文
sp_delete_jobstep
[ [ @job_id = ] 'job_id' ]
[ , [ @job_name = ] N'job_name' ]
, [ @step_id = ] step_id
[ ; ]
引数
[ @job_id = ] 「job_id」
ステップを削除するジョブの識別番号を指定します。
@job_id は uniqueidentifier で、既定値は NULL です。
@job_idまたは@job_nameを指定する必要があります。両方を指定することはできません。
[ @job_name = ] N'job_name
ステップを削除するジョブの名前を指定します。
@job_name は sysname で、既定値は NULL です。
@job_idまたは@job_nameを指定する必要があります。両方を指定することはできません。
[ @step_id = ] step_id
削除するステップの識別番号を指定します。 @step_id は int で、既定値はありません。
リターン コードの値
0 (成功) または 1 (失敗)。
結果セット
ありません。
解説
ジョブ ステップを削除すると、削除したステップを参照する他のジョブ ステップは自動的に更新されます。
特定のジョブに関連付けられている手順の詳細については、 sp_help_jobstepを実行します。
Note
sp_delete_jobstep値が 0 のを呼び出すと、ジョブのすべてのジョブ ステップが削除されます。
SQL Server Management Studio は、簡単かつ直観的な方法でジョブを管理するためのツールで、ジョブ体系の作成および管理に最適です。
このストアド プロシージャは、azure SQL Database 用の Azure Elastic Jobs サービスの同様のオブジェクトとsp_delete_jobstepの名前を共有。 エラスティック ジョブのバージョンについては、「 jobs.sp_delete_jobstep (Azure エラスティック ジョブ)」を参照してください。
アクセス許可
この手順では EXECUTE アクセス許可を付与できますが、これらのアクセス許可は SQL Server のアップグレード中にオーバーライドされる可能性があります。
他のユーザーには、msdb データベース内の次SQL Server エージェント固定データベース ロールのいずれかを付与する必要があります。
- SQLAgentUserRole
- SQLAgentReaderRole
- SQLAgentOperatorRole
これらのロールの権限の詳細については、「 SQL Server エージェントの固定データベース ロール」を参照してください。
sysadmin のメンバーのみが、別のユーザーが所有するジョブ ステップを削除できます。
例
次の例では、ジョブ ステップ 1 をジョブ Weekly Sales Data Backupから削除します。
USE msdb;
GO
EXECUTE dbo.sp_delete_jobstep
@job_name = N'Weekly Sales Data Backup',
@step_id = 1;
GO