sp_delete_job (Transact-SQL)

適用対象: SQL Server Azure SQL Managed Instance

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

Transact-SQL 構文表記規則

構文

sp_delete_job
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @originating_server = ] N'originating_server' ]
    [ , [ @delete_history = ] delete_history ]
    [ , [ @delete_unused_schedule = ] delete_unused_schedule ]
[ ; ]

引数

[ @job_id = ] 'job_id'

削除するジョブの ID 番号。 @job_id は uniqueidentifier で、既定値は NULL です。

@job_idまたは@job_nameを指定する必要があります。両方を指定することはできません。

[ @job_name = ] N'job_name'

削除するジョブの名前。 @job_name は sysname で、既定値は NULL です。

@job_idまたは@job_nameを指定する必要があります。両方を指定することはできません。

[ @originating_server = ] N'originating_server'

単に情報を示すためだけに特定されます。 サポートされていません。 将来の互換性は保証されません。

[ @delete_history = ] delete_history

ジョブの履歴を削除するかどうかを指定します。 @delete_history は bit で、既定値は 1 です。

• @delete_historyが1されると、ジョブのジョブ履歴が削除されます。
• @delete_historyが0されると、ジョブ履歴は削除されません。

ジョブが削除され、履歴が削除されない場合、ジョブの履歴情報はSQL Server エージェントのグラフィカル ユーザー インターフェイス ジョブ履歴には表示されませんが、情報はmsdb データベースのsysjobhistory テーブルに残ります。

[ @delete_unused_schedule = ] delete_unused_schedule

他のジョブにアタッチされていない場合に、このジョブにアタッチされているスケジュールを削除するかどうかを指定します。 @delete_unused_schedule は bit で、既定値は 1 です。

• @delete_unused_scheduleが1されると、他のジョブがスケジュールを参照していない場合、このジョブにアタッチされているスケジュールは削除されます。
• @delete_unused_scheduleが0されると、スケジュールは削除されません。

リターン コードの値

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

結果セット

ありません。

解説

@originating_server引数は内部使用のために予約されています。

@delete_unused_schedule引数は、ジョブにアタッチされていないスケジュールを自動的に削除することで、以前のバージョンの SQL Server との下位互換性を提供します。 このパラメーターの既定値は、下位互換性のある動作です。 ジョブにアタッチされていないスケジュールを保持するには、@delete_unused_schedule引数として0値を指定する必要があります。

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

このストアド プロシージャは、メンテナンス プランを削除することも、メンテナンス プランの一部であるジョブを削除することもできません。 代わりに、SQL Server Management Studio を使用してメンテナンス プランを削除します。

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

アクセス許可

この手順では EXECUTE アクセス許可を付与できますが、これらのアクセス許可は SQL Server のアップグレード中にオーバーライドされる可能性があります。

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

• SQLAgentUserRole
• SQLAgentReaderRole
• SQLAgentOperatorRole

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

sysadmin固定サーバー ロールのメンバーはsp_delete_jobを実行してジョブを削除できます。 sysadmin固定サーバー ロールのメンバーではないユーザーは、そのユーザーが所有するジョブのみを削除できます。

例

次の例では、ジョブ NightlyBackups を削除します。

USE msdb;
GO

EXEC sp_delete_job
    @job_name = N'NightlyBackups';
GO

関連するコンテンツ

• sp_add_job (Transact-SQL)
• sp_help_job (Transact-SQL)
• sp_update_job (Transact-SQL)
• システム ストアド プロシージャ (Transact-SQL)