sp_add_jobserver (Transact-SQL)

Artigo
06/18/2013

Tem como destino o trabalho especificado no servidor especificado.

Ícone de vínculo de tópico Convenções da sintaxe Transact-SQL

Sintaxe

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

Argumentos

[ @job_id = ] job_id
O número de identificação do trabalho. job_id é uniqueidentifier, com um padrão NULL.
[ @job_name = ] 'job_name'
O nome do trabalho. job_name é sysname, com um padrão NULL.

Observação

É necessário especificar a job_id ou o job_name, mas não é possível especificar ambos ao mesmo tempo.
[ @server_name = ] 'server'
O nome do servidor no qual o trabalho será direcionado. server é nvarchar(30), com o valor padrão N'(LOCAL)'. serverpode ser (LOCAL) para um servidor local, ou o nome de um servidor de destino existente.

Observação
É necessário especificar a job_id ou o job_name, mas não é possível especificar ambos ao mesmo tempo.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

Nenhum

Comentários

@automatic_post existe em sp_add_jobserver, mas não está listado em Argumentos. @ automatic_post é reservado para uso interno.

O SQL Server Management Studio gerencia trabalhos de forma fácil e com representação gráfica. Além disso, ele é recomendado para criar e gerenciar a infraestrutura de trabalhos.

Permissões

Por padrão, os membros da função de servidor fixa sysadmin podem executar este procedimento armazenado. Deve ser concedida a outros usuários uma das seguintes funções de banco de dados fixas do SQL Server Agent no banco de dados msdb:

SQLAgentUserRole
SQLAgentReaderRole
SQLAgentOperatorRole

Para obter detalhes sobre as permissões dessas funções, consulte Funções de banco de dados fixas do SQL Server Agent.

Somente membros da função de servidor fixa sysadmin podem executar sp_add_jobserver para trabalhos que envolvam vários servidores.

Exemplos

A.Atribuindo um trabalho ao servidor local

O exemplo a seguir atribui o trabalho NightlyBackups para ser executado no servidor local.

Observação
Este exemplo supõe que o trabalho NightlyBackups já exista.

USE msdb ;
GO

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

B.Atribuindo um trabalho para ser executado em um servidor diferente

O exemplo a seguir atribui o trabalho de vários servidores Weekly Sales Backups ao servidor SEATTLE2.

Observação
Este exemplo assume que o trabalho Weekly Sales Backups já exista e que SEATTLE2 esteja registrado como um servidor de destino para a instância atual.

USE msdb ;
GO

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

Consulte também

Referência

sp_apply_job_to_targets (Transact-SQL)

sp_delete_jobserver (Transact-SQL)

Procedimentos armazenados do sistema (Transact-SQL)

Partilhar via