sp_update_schedule (Transact-SQL)
Quita una asociación entre una programación y un trabajo.
Sintaxis
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
Argumentos
- [ @job_id= ] job_id
Número de identificación del trabajo cuya programación se va a quitar. job_id es de tipo uniqueidentifier y su valor predeterminado es NULL.
[ @job_name= ] 'job_name'
Nombre del trabajo cuya programación se va a quitar. job_name es de tipo sysname y su valor predeterminado es NULL.[!NOTA] Se debe especificar job_id o job_name, pero no ambos.
- [ @schedule_id= ] schedule_id
Número de identificación de la programación que se va a quitar del trabajo. schedule_id es de tipo int y su valor predeterminado es NULL.
[ @schedule_name= ] 'schedule_name'
Nombre de la programación que se va a quitar del trabajo. schedule_name es de tipo sysname y su valor predeterminado es NULL.[!NOTA] Se debe especificar schedule_id o schedule_name, pero no ambos.
- [ @delete_unused_schedule= ] delete_unused_schedule
Especifica si se van a eliminar las programaciones de trabajo no utilizadas. delete_unused_schedule es de tipo bit y su valor predeterminado es 0, lo que indica que todas las programaciones se mantienen, incluso aunque ningún trabajo haga referencia a ellas. Si se establece en 1, las programaciones de trabajo no utilizadas se eliminan si ningún trabajo hace referencia a ellas.
Conjuntos de resultados
Ninguno
Permisos
De forma predeterminada, los miembros de la función fija de servidor sysadmin pueden ejecutar este procedimiento almacenado. A otros usuarios debe concederse una de las siguientes funciones fijas de base de datos del Agente SQL Server en la base de datos msdb:
- SQLAgentUserRole
- SQLAgentReaderRole
- SQLAgentOperatorRole
Para obtener más información acerca de los permisos de estas funciones, vea Funciones fijas de base de datos del Agente SQL Server.
Microsoft SQL Server realiza una comprobación para determinar si el usuario es propietario de la programación. Tan sólo los miembros de la función fija de servidor sysadmin pueden separar programaciones de los trabajos que pertenecen a otro usuario.
Valores de código de retorno
0 (correcto) o 1 (error)
Ejemplos
En el siguiente ejemplo se quita una asociación entre una programación 'NightlyJobs' y un trabajo 'BackupDatabase'.
USE msdb ;
GO
EXEC dbo.sp_detach_schedule
@job_name = 'BackupDatabase',
@schedule_name = 'NightlyJobs' ;
GO
Vea también
Referencia
sp_add_schedule (Transact-SQL)
sp_attach_schedule (Transact-SQL)
sp_delete_schedule (Transact-SQL)