sp_add_jobserver (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 ao qual o trabalho se destina. server é nvarchar(30), com um padrão N'(LOCAL)'. serverpode ser (LOCAL) para um servidor local ou o nome de um servidor de destino existente.

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 infra-estrutura 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