sp_update_job (Transact-SQL)

Cambia los atributos de un trabajo.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_update_job [ @job_id =] job_id | [@job_name =] 'job_name'
     [, [@new_name =] 'new_name' ] 
     [, [@enabled =] enabled ]
     [, [@description =] 'description' ] 
     [, [@start_step_id =] step_id ]
     [, [@category_name =] 'category' ] 
     [, [@owner_login_name =] 'login' ]
     [, [@notify_level_eventlog =] eventlog_level ]
     [, [@notify_level_email =] email_level ]
     [, [@notify_level_netsend =] netsend_level ]
     [, [@notify_level_page =] page_level ]
     [, [@notify_email_operator_name =] 'operator_name' ]
     [, [@notify_netsend_operator_name =] 'netsend_operator' ]
     [, [@notify_page_operator_name =] 'page_operator' ]
     [, [@delete_level =] delete_level ] 
     [, [@automatic_post =] automatic_post ]

Argumentos

• [ @job_id =] job_id
  Número de identificación del trabajo que se va a actualizar. job_ides de tipo uniqueidentifier.

• [ @job_name =] 'job_name'
  Nombre del trabajo. job_namees de tipo nvarchar(128).

  [!NOTA]

  Se debe especificar job_id o job_name, pero no ambos.

• [ @new_name =] 'new_name'
  Nuevo nombre del trabajo. new_namees de tipo nvarchar(128).

• [ @enabled =] enabled
  Especifica si el trabajo está habilitado (1) o no (0). enabledes de tipo tinyint.

• [ @description =] 'description'
  Descripción del trabajo. description es de tipo nvarchar(512).

• [ @start_step_id =] step_id
  Número de identificación del primer paso que se va a ejecutar para el trabajo. step_ides de tipo int.

• [ @category_name =] 'category'
  Categoría del trabajo. categoryes de tipo nvarchar(128).

• [ @owner_login_name =] 'login'
  Nombre del inicio de sesión al que pertenece el trabajo. logines de tipo nvarchar(128). Solo pueden cambiar la propiedad de un trabajo los miembros del rol fijo de servidor sysadmin.

• [ @notify_level_eventlog =] eventlog_level
  Especifica cuándo se debe incluir una entrada para este trabajo en el registro de aplicación de Microsoft Windows. eventlog_leveles de tipo int y puede tener uno de estos valores.

  Valor	Descripción (acción)
  0	Never
  1	En caso de éxito
  2	En caso de error
  3	Always

• [ @notify_level_email =] email_level
  Especifica cuándo se debe enviar un mensaje de correo electrónico tras finalizar este trabajo. email_leveles de tipo int. email_levelutiliza los mismos valores que eventlog_level.

• [ @notify_level_netsend =] netsend_level
  Especifica cuándo se debe enviar un mensaje de red tras finalizar este trabajo. netsend_leveles de tipo int. netsend_levelutiliza los mismos valores que eventlog_level.

• [ @notify_level_page =] page_level
  Especifica cuándo se debe enviar una página tras finalizar este trabajo. page_leveles de tipo int. page_levelutiliza los mismos valores que eventlog_level.

• [ @notify_email_operator_name =] 'email_name'
  El nombre del operador al que se envía el mensaje de correo electrónico cuando se alcanza el valor de email_level. email_name es de tipo nvarchar(128).

• [ @notify_netsend_operator_name =] 'netsend_operator'
  El nombre del operador al que se envía el mensaje de red. netsend_operator es de tipo nvarchar(128).

• [ @notify_page_operator_name =] 'page_operator'
  El nombre del operador al que se envía una página. page_operator es de tipo nvarchar(128).

• [ @delete_level =] delete_level
  Especifica cuándo debe eliminarse el trabajo. delete_valuees de tipo int. delete_levelutiliza los mismos valores que eventlog_level.

• [ @automatic_post =] automatic_post
  Reservado.

Valores de código de retorno

0 (correcto) o 1 (error)

Comentarios

sp_update_job se debe ejecutar desde la base de datos msdb.

sp_update_job solo cambia las opciones para las que se especifican valores de parámetro. Si se omite un parámetro, se conserva la configuración actual.

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 más información acerca de los permisos de estos roles, vea Roles fijos de base de datos del Agente SQL Server.

Solo los miembros de sysadmin pueden utilizar este procedimiento almacenado para editar los atributos de los trabajos que pertenecen a otros usuarios.

Ejemplos

En el ejemplo siguiente se cambia el nombre, la descripción y el estado de habilitación del trabajo NightlyBackups.

USE msdb ;
GO

EXEC dbo.sp_update_job
    @job_name = N'NightlyBackups',
    @new_name = N'NightlyBackups -- Disabled',
    @description = N'Nightly backups disabled during server migration.',
    @enabled = 0 ;
GO

Vea también

Referencia

sp_add_job (Transact-SQL)

sp_delete_job (Transact-SQL)

sp_help_job (Transact-SQL)

Procedimientos almacenados del sistema (Transact-SQL)