sp_delete_schedule (Transact-SQL)

スケジュールを削除します。

構文

sp_delete_schedule { [ @schedule_id = ] schedule_id | [ @schedule_name = ] 'schedule_name' } ,
     [ @force_delete = ] force_delete

メモ :
schedule_id または schedule_name のいずれかを指定する必要があります。両方を指定することはできません。

メモ :
schedule_id または schedule_name のいずれかを指定する必要があります。両方を指定することはできません。

[ @force_delete = ] force_delete
スケジュールがジョブに関連付けられている場合にプロシージャを失敗させるかどうかを指定します。Force_delete のデータ型は bit で、既定値は 0 です。force_delete に 0 を指定すると、スケジュールがジョブに関連付けられている場合、ストアドプロシージャは失敗します。force_delete に 1 を指定すると、スケジュールがジョブに関連付けられているかどうかに関係なく、スケジュールは削除されます。

なし

既定では、スケジュールがジョブに関連付けられている場合、スケジュールを削除することはできません。ジョブに関連付けられているスケジュールを削除するには、force_delete に値 1 を指定します。スケジュールを削除しても、現在実行中のジョブは停止しません。

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

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

他のユーザーが所有するジョブスケジュールを削除できるのは、sysadmin ロールのメンバだけです。

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

A. スケジュールを削除する

次の例では、スケジュール NightlyJobs を削除します。スケジュールがジョブに関連付けられている場合、この例ではスケジュールは削除されません。

USE msdb ;
GO

EXEC dbo.sp_delete_schedule
    @schedule_name = N'NightlyJobs' ;
GO

B. ジョブに関連付けられているスケジュールを削除する

次の例では、スケジュールがジョブに関連付けられているかどうかに関係なく、スケジュール RunOnce を削除します。

USE msdb ;
GO

EXEC dbo.sp_delete_schedule
    @schedule_name = 'RunOnce',
    @force_delete = 1;
GO