sp_delete_job (Transact-SQL)

  • [アーティクル]

適用対象:SQL Server

ジョブを削除します。

Transact-SQL 構文表記規則

構文

  
sp_delete_job { [ @job_id = ] job_id | [ @job_name = ] 'job_name' } ,  
     [ , [ @originating_server = ] 'server' ]   
     [ , [ @delete_history = ] delete_history ]  
     [ , [ @delete_unused_schedule = ] delete_unused_schedule ]

引数

[ @job_id = ] job_id 削除するジョブの識別番号を指定します。 job_id は uniqueidentifier で、既定値は NULL です。

[ @job_name = ] 'job_name' 削除するジョブの名前を指定します。 job_name は sysname で、既定値は NULL です。

注意

job_idまたはjob_nameを指定する必要があります。どちらも指定できません。

[ @originating_server = ] 'server' 内部使用の場合。

[ @delete_history = ] delete_history ジョブの履歴を削除するかどうかを指定します。 delete_history は ビットで、既定値は 1 です。 delete_historyが 1 の場合、ジョブのジョブ履歴が削除されます。 delete_historyが 0 の場合、ジョブ履歴は削除されません。

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

[ @delete_unused_schedule = ] delete_unused_schedule 他のジョブにアタッチされていない場合に、このジョブにアタッチされているスケジュールを削除するかどうかを指定します。 delete_unused_schedule は ビットで、既定値は 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を使用してメンテナンス プランを削除します。

アクセス許可

既定では、このストアド プロシージャを実行できるのは、 sysadmin 固定サーバー ロールのメンバーです。 他のユーザーには、 SQL Server msdb データベースの次のいずれかの エージェント固定データベース ロールが許可されている必要があります。

  • SQLAgentUserRole

  • SQLAgentReaderRole

  • SQLAgentOperatorRole

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

sp_delete_job を実行して任意のジョブを削除できるのは、 sysadmin 固定サーバー ロールのメンバーです。 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)