sp_delete_jobstep (Transact-SQL)

適用対象: SQL Server Azure SQL Managed Instance

SQL Server エージェント サービスのジョブからジョブ ステップを削除します。

Transact-SQL 構文表記規則

構文

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

@step_id値が 0 のsp_delete_jobstepを呼び出すと、ジョブのすべてのジョブ ステップが削除されます。

SQL Server Management Studio は、簡単かつ直観的な方法でジョブを管理するためのツールで、ジョブ体系の作成および管理に最適です。

このストアド プロシージャは、azure SQL Database 用の Azure Elastic Jobs サービスの同様のオブジェクトとsp_delete_jobstepの名前を共有。 エラスティック ジョブのバージョンについては、「 jobs.sp_delete_jobstep (Azure エラスティック ジョブ)」を参照してください。

アクセス許可

このストアド プロシージャは、 db_owner ロールによって所有されています。 EXECUTEアクセス許可は任意のユーザーに付与できますが、SQL Server のアップグレード中にこれらのアクセス許可がオーバーライドされる可能性があります。

他のユーザーには、msdb データベース内の次SQL Server エージェント固定データベース ロールのいずれかを付与する必要があります。

• SQLAgentUserRole
• SQLAgentReaderRole
• SQLAgentOperatorRole

これらのロールの権限の詳細については、「 SQL Server エージェントの固定データベース ロール」を参照してください。

sysadmin のメンバーのみが、別のユーザーが所有するジョブ ステップを削除できます。

例

次の例では、ジョブ ステップ 1 をジョブ Weekly Sales Data Backupから削除します。

USE msdb;
GO

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

関連するコンテンツ

• ジョブの表示または変更
• sp_add_jobstep (Transact-SQL)
• sp_update_jobstep (Transact-SQL)
• sp_help_jobstep (Transact-SQL)
• システム ストアド プロシージャ (Transact-SQL)