sp_delete_jobstep (Transact-SQL)
Quita un paso de un trabajo.
Sintaxis
sp_delete_jobstep { [ @job_id = ] job_id | [ @job_name = ] 'job_name' } ,
[ @step_id = ] step_id
Argumentos
- [ @job_id= ] job_id
Número de identificación del trabajo del que se quitará el paso. job_ides de tipo uniqueidentifier y su valor predeterminado es NULL.
[ @job_name= ] 'job_name'
Nombre del trabajo del que se va a quitar el paso. job_namees de tipo sysname y su valor predeterminado es NULL.[!NOTA] Se debe especificar job_id o job_name, pero no ambos.
- [ @step_id= ] step_id
Número de identificación del paso que se va a quitar. step_ides de tipo int y no tiene ningún valor predeterminado.
Conjuntos de resultados
Ninguno
Notas
Si se quita un paso de un trabajo, se actualizan automáticamente los otros pasos del trabajo que hacen referencia al paso eliminado.
Para obtener más información acerca de los pasos asociados a un trabajo determinado, ejecute sp_help_jobstep.
[!NOTA] Al llamar a sp_delete_jobstep con el valor cero para step_id, se eliminan todos los pasos del trabajo.
Microsoft SQL Server Management Studio ofrece un método gráfico sencillo para administrar trabajos y es el método recomendado para crear y administrar la infraestructura de trabajo.
Permisos
De manera predeterminada, este procedimiento almacenado lo pueden ejecutar los miembros de la función fija de servidor sysadmin. Al resto de usuarios se les debe conceder 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 detalles sobre los permisos de estas funciones, vea Funciones fijas de base de datos del Agente SQL Server.
Sólo los miembros de sysadmin pueden eliminar un paso de trabajo que sea propiedad de otro usuario.
Valores de código de retorno
0 (correcto) o 1 (error)
Ejemplos
En el ejemplo siguiente se quita el paso de trabajo 1 del trabajo Weekly Sales Data Backup.
USE msdb ;
GO
EXEC dbo.sp_delete_jobstep
@job_name = N'Weekly Sales Data Backup',
@step_id = 1 ;
GO
Vea también
Referencia
sp_add_jobstep (Transact-SQL)
sp_update_jobstep (Transact-SQL)
sp_help_jobstep (Transact-SQL)
Procedimientos almacenados del sistema (Transact-SQL)