Compartir a través de


sp_add_jobserver (Transact-SQL)

Destina el trabajo indicado al servidor especificado.

Icono de vínculo a temasConvenciones de sintaxis de Transact-SQL

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.

Valores de código de retorno

0 (correcto) o 1 (error)

Conjuntos de resultados

Ninguno

Comentarios

@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.

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