sp_detach_schedule (Transact-SQL)
スケジュールとジョブ間の関連付けを削除します。
適用対象: SQL Server (SQL Server 2008 から現在のバージョンまで) |
.jpeg "トピック リンク アイコン")
構文
sp_detach_schedule
{ [ @job_id = ] job_id | [ @job_name = ] 'job_name' } ,
{ [ @schedule_id = ] schedule_id | [ @schedule_name = ] 'schedule_name' } ,
[ @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 のいずれかを指定する必要があります。両方を指定することはできません。
[ @schedule_id= ] schedule_id
ジョブから削除するスケジュールの識別番号を指定します。 schedule_id のデータ型は int で、既定値は NULL です。[ @schedule_name= ] 'schedule_name'
ジョブから削除するスケジュールの名前を指定します。 schedule_name のデータ型は sysname で、既定値は NULL です。注意
schedule_id または schedule_name のいずれかを指定する必要があります。両方を指定することはできません。
[ @delete_unused_schedule= ] delete_unused_schedule
使用のジョブ スケジュールを削除するかどうかを指定します。 delete_unused_schedule のデータ型は bit で、既定値は 0 です。既定値は、すべてのスケジュールが、ジョブによって参照されていない場合でも保持されることを意味します。 1 に設定すると、未使用のジョブ スケジュールは、ジョブによって参照されていない場合は削除されます。
戻り値
0 (成功) または 1 (失敗)
結果セット
なし
権限
既定では、このストアド プロシージャを実行できるのは、sysadmin 固定サーバー ロールのメンバーです。 他のユーザーには、msdb データベースの次のいずれかの SQL Server エージェント固定データベース ロールが許可されている必要があります。
SQLAgentUserRole
SQLAgentReaderRole
SQLAgentOperatorRole
ジョブ所有者は、同時にスケジュール所有者にならなくても、ジョブをスケジュールにアタッチしたり、スケジュールからデタッチしたりできます。 ただし、呼び出し元がスケジュール所有者ではない場合、デタッチによってスケジュールにジョブがなくなっても、スケジュールを削除することはできません。
これらのロールの権限に関する詳細については、「SQL Server エージェントの固定データベース ロール」を参照してください。
SQL Server では、ユーザーがスケジュールを所有しているかどうかが判断されます。 別のユーザーが所有するジョブからスケジュールを切り離せるのは、sysadmin 固定サーバー ロールのメンバーだけです。
使用例
次の例では、'NightlyJobs' スケジュールと 'BackupDatabase' ジョブ間の関連付けを削除します。
USE msdb ;
GO
EXEC dbo.sp_detach_schedule
@job_name = 'BackupDatabase',
@schedule_name = 'NightlyJobs' ;
GO
関連項目
参照
sp_add_schedule (Transact-SQL)