Compartir a través de

  • Artículo

sp_update_job (Transact-SQL)

Cambia los atributos de un trabajo.

Icono de vínculo a temasConvenciones 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 =] 'email_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 propietario el trabajo. logines de tipo nvarchar(128). Sólo los miembros de la función fija de servidor sysadmin pueden cambiar la propiedad del trabajo.

  • [ @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

    Nunca

    1

    En caso de éxito

    2

    En caso de error

    3

    Siempre

  • [ @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 de correo electrónico 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)

Notas

sp_update_job se debe ejecutar desde la base de datos msdb.

sp_update_job sólo 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 de la función fija de servidor sysadmin pueden ejecutar este procedimiento almacenado. A otros usuarios debe concederse 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 más información acerca de los permisos de estas funciones, vea Funciones fijas de base de datos del Agente SQL Server.

Sólo 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