Compartir a través de


sp_delete_jobstep (Transact-SQL)

Quita un paso de un trabajo.

Icono de vínculo a temasConvenciones 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 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.

Valores de código de retorno

0 (correcto) o 1 (error)

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.

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