sp_add_jobserver (Transact-SQL)

  • Artículo

Destina el trabajo indicado al servidor especificado.

Sintaxis

sp_add_jobserver [ @job_id = ] job_id | [ @job_name = ] 'job_name'
     [ , [ @server_name = ] 'server' ]

Argumentos

  • [ @job_id = ] job_id
    Número de identificación del trabajo. job_id es de tipo uniqueidentifier y su valor predeterminado es NULL.

  • [ @job_name =] 'job_name'
    Nombre del trabajo. job_name es de tipo sysname y su valor predeterminado es NULL.

    [!NOTA] Se debe especificar job_id o job_name, pero no ambos.

  • [ @server_name = ] 'server'
    Nombre del servidor al que se va a destinar el trabajo. server es de tipo nvarchar(30) y su valor predeterminado es N‘(LOCAL)’. serverpuede ser (LOCAL) para un servidor local o el nombre de un servidor de destino existente.

Conjuntos de resultados

Ninguno

Notas

@automatic_post existe en sp_add_jobserver, pero no aparece en Argumentos. @automatic_post se reserva para uso interno.

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 la función fija de servidor sysadmin pueden ejecutar sp_add_jobserver para los trabajos multiservidor.

Valores de código de retorno

0 (correcto) o 1 (error)

Ejemplos

A. Asignar un trabajo al servidor local

En el ejemplo siguiente se asigna el trabajo NightlyBackups para su ejecución en el servidor local.

[!NOTA] En este ejemplo se da por supuesto que el trabajo NightlyBackups ya existe.

USE msdb ;
GO

EXEC dbo.sp_add_jobserver
    @job_name = N'NightlyBackups' ;
GO

B. Asignar un trabajo para su ejecución en un servidor diferente

En el ejemplo siguiente se asigna el trabajo multiservidor Weekly Sales Backups al servidor SEATTLE2.

[!NOTA] En este ejemplo se da por supuesto que el trabajo Weekly Sales Backups ya existe y que SEATTLE2 está registrado como servidor de destino para la instancia actual.

USE msdb ;
GO

EXEC dbo.sp_add_jobserver
    @job_name = N'Weekly Sales Backups',
    @server_name = N'SEATTLE2' ;
GO

Vea también

Referencia

sp_apply_job_to_targets (Transact-SQL)
sp_delete_jobserver (Transact-SQL)
Procedimientos almacenados del sistema (Transact-SQL)

Ayuda e información

Obtener ayuda sobre SQL Server 2005