Compartir a través de

sp_delete_jobstep (Transact-SQL)

  • Artículo

Se aplica a: SQL Server Azure SQL Managed Instance

Quita un paso de trabajo de un trabajo en el servicio Agente SQL Server.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_delete_jobstep
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'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_id es uniqueidentifier, con un valor predeterminado de NULL.

Se deben especificar @job_id o @job_name ; no se pueden especificar ambos.

[ @job_name = ] N'job_name'

Nombre del trabajo del que se quitará el paso. @job_name es sysname, con un valor predeterminado de NULL.

Se deben especificar @job_id o @job_name ; no se pueden especificar ambos.

[ @step_id = ] step_id

Número de identificación del paso que se va a quitar. @step_id es int, sin valor predeterminado.

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Conjunto 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 sobre los pasos asociados a un trabajo determinado, ejecute sp_help_jobstep.

Nota:

Al llamar sp_delete_jobstep con un @step_id valor de cero, se eliminan todos los pasos de trabajo del trabajo.

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.

Este procedimiento almacenado comparte el nombre de sp_delete_jobstep con un objeto similar para el servicio Trabajos elásticos de Azure para Azure SQL Database. Para obtener información sobre la versión de trabajos elásticos, consulte jobs.sp_delete_jobstep (Trabajos elásticos de Azure).

Permisos

Puede conceder EXECUTE permisos en este procedimiento, pero estos permisos se pueden invalidar durante una actualización de SQL Server.

A otros usuarios se les debe conceder uno de los siguientes Agente SQL Server roles fijos de base de datos en la msdb base de datos:

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

Para detalles sobre los permisos de estos roles, consulte 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

Contenido relacionado