sp_detach_schedule (Transact-SQL)sp_detach_schedule (Transact-SQL)

適用対象: yesSQL Server noAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse APPLIES TO: yesSQL Server noAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

スケジュールとジョブ間の関連付けを削除します。Removes an association between a schedule and a job.

トピック リンク アイコン Transact-SQL 構文表記規則Topic link icon Transact-SQL Syntax Conventions

構文Syntax

  
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   

引数Arguments

[ @job_id = ] job_id スケジュールを削除するジョブのジョブ識別番号。[ @job_id = ] job_id The job identification number of the job to remove the schedule from. job_iduniqueidentifier、既定値は NULL です。job_id is uniqueidentifier, with a default of NULL.

[ @job_name = ] 'job_name' スケジュールを削除するジョブの名前。[ @job_name = ] 'job_name' The name of the job to remove the schedule from. job_namesysname、既定値は NULL です。job_name is sysname, with a default of NULL.

注意

いずれかjob_idまたはjob_name指定する必要がありますが、両方を指定することはできません。Either job_id or job_name must be specified, but both cannot be specified.

[ @schedule_id = ] schedule_id ジョブから削除するスケジュールの識別番号を指定します。[ @schedule_id = ] schedule_id The schedule identification number of the schedule to remove from the job. schedule_idint、既定値は NULL です。schedule_id is int, with a default of NULL.

[ @schedule_name = ] 'schedule_name' ジョブから削除するスケジュールの名前。[ @schedule_name = ] 'schedule_name' The name of the schedule to remove from the job. schedule_namesysname、既定値は NULL です。schedule_name is sysname, with a default of NULL.

注意

いずれかschedule_idまたはschedule_name指定する必要がありますが、両方を指定することはできません。Either schedule_id or schedule_name must be specified, but both cannot be specified.

[ @delete_unused_schedule = ] delete_unused_schedule 未使用のジョブ スケジュールを削除するかどうかを指定します。[ @delete_unused_schedule = ] delete_unused_schedule Specifies whether to delete unused job schedules. *@delete_unused_schedule*は**ビット**、既定値は**0**、つまりすべてのスケジュールを保持することでもジョブ参照されていない場合にします。delete_unused_schedule is bit, with a default of 0, which means that all schedules will be kept, even if no jobs reference them. 場合設定1ジョブを参照しない場合、未使用のジョブ スケジュールは削除されます。If set to 1, unused job schedules are deleted if no jobs reference them.

リターン コードの値Return Code Values

0 (成功) または1 (失敗)0 (success) or 1 (failure)

結果セットResult Sets

なしNone

アクセス許可Permissions

既定では、このストアド プロシージャを実行できるのは、 sysadmin 固定サーバー ロールのメンバーです。By default, members of the sysadmin fixed server role can execute this stored procedure. 他のユーザーには、 SQL ServerSQL Server msdb データベースの次のいずれかの エージェント固定データベース ロールが許可されている必要があります。Other users must be granted one of the following SQL ServerSQL Server Agent fixed database roles in the msdb database:

  • SQLAgentUserRoleSQLAgentUserRole

  • SQLAgentReaderRoleSQLAgentReaderRole

  • SQLAgentOperatorRoleSQLAgentOperatorRole

ジョブの所有者が、ジョブをスケジュールにアタッチおよびにスケジュール所有者にならなくても、ジョブ、スケジュールをデタッチできますに注意してください。Note that the job owner can attach a job to a schedule and detach a job from a schedule without also having to be the schedule owner. ただし場合は、デタッチがのままにジョブがいずれも、呼び出し元が、スケジュール所有者でない限り、スケジュールを削除できません。However, a schedule cannot be deleted if the detach would leave it with no jobs unless the caller is the schedule owner.

これらのロールの権限の詳細については、「 SQL Server エージェントの固定データベース ロール」を参照してください。For details about the permissions of these roles, see SQL Server Agent Fixed Database Roles.

SQL ServerSQL Server では、ユーザーがスケジュールを所有しているかどうかが判断されます。checks to determine whether the user owns the schedule. メンバーのみ、 sysadmin固定サーバー ロールは、別のユーザーが所有するジョブからスケジュールをデタッチできます。Only members of the sysadmin fixed server role can detach schedules from jobs owned by another user.

使用例Examples

次の例では、間のアソシエーションの削除、'NightlyJobs'スケジュールと'BackupDatabase'ジョブ。The following example removes an association between a 'NightlyJobs' schedule and a 'BackupDatabase' job.

USE msdb ;  
GO  
  
EXEC dbo.sp_detach_schedule  
    @job_name = 'BackupDatabase',  
    @schedule_name = 'NightlyJobs' ;  
GO  

関連項目See Also

sp_add_schedule (TRANSACT-SQL) sp_add_schedule (Transact-SQL)
sp_attach_schedule (TRANSACT-SQL) sp_attach_schedule (Transact-SQL)
sp_delete_schedule (TRANSACT-SQL)sp_delete_schedule (Transact-SQL)