sp_delete_jobstep (Transact-SQL)
Quita un paso de un trabajo.
.gif "Icono de vínculo a temas")
Convenciones de sintaxis de Transact-SQL
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 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 valor predeterminado.
Valores de código de retorno
0 (correcto) o 1 (error)
Conjuntos de resultados
Ninguno
Comentarios
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 forma predeterminada, los miembros del rol fijo de servidor sysadmin pueden ejecutar este procedimiento almacenado. Al resto de usuarios se les debe conceder uno de los siguientes roles fijos de base de datos del Agente SQL Server en la base de datos msdb:
SQLAgentUserRole
SQLAgentReaderRole
SQLAgentOperatorRole
Para obtener detalles sobre los permisos de estos roles, vea Roles fijos de base de datos del Agente SQL Server.
Solo los miembros de sysadmin pueden eliminar un paso de trabajo que sea propiedad de otro usuario.
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_update_jobstep (Transact-SQL)
sp_help_jobstep (Transact-SQL)
Procedimientos almacenados del sistema (Transact-SQL)