Partilhar via

  • Artigo

sp_apply_job_to_targets (Transact-SQL)

Aplica um trabalho a um ou mais servidores de destino ou aos servidores de destino pertencentes a um ou mais grupos de servidores de destino.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

sp_apply_job_to_targets { [ @job_id = ] job_id | [ @job_name = ] 'job_name' }
     [ , [ @target_server_groups = ] 'target_server_groups' ] 
     [ , [ @target_servers = ] 'target_servers' ] 
     [ , [ @operation = ] 'operation' ]

Argumentos

  • [ @job_id =] job_id
    O número de identificação do trabalho a ser aplicado aos servidores de destino ou grupos de servidores de destino especificados. job_id é uniqueidentifier, com um padrão NULL.

  • [ @job_name =] 'job_name'
    O nome do trabalho a ser aplicado aos servidores de destino ou grupos de servidores de destino associados. job_name é sysname, com um padrão NULL.

    ObservaçãoObservação

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

  • [ @target_server_groups =] 'target_server_groups'
    Uma lista separada por vírgulas de grupos de servidores de destino aos quais o trabalho especificado será aplicado. target_server_groups é nvarchar(2048), com um padrão NULL.

  • [ @target_servers= ] 'target_servers'
    Uma lista separada por vírgulas de servidores de destino aos quais o trabalho especificado será aplicado. target_serversé nvarchar(2048), com um padrão NULL.

  • [ @operation= ] 'operation'
    Se o trabalho especificado deve ser aplicado aos servidores de destino ou grupos de servidores de destino especificados ou removido dos mesmos. operationé varchar(7), com um padrão APPLY. As operações válidas são APPLY e REMOVE.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Comentários

sp_apply_job_to_targets fornece uma maneira fácil de aplicar (ou remover) um trabalho em vários servidores de destino, sendo uma alternativa à chamada de sp_add_jobserver (ou sp_delete_jobserver) uma vez para cada servidor de destino necessário.

Permissões

Somente os membros da função de servidor fixa sysadmin podem executar este procedimento.

Exemplos

O exemplo a seguir aplica o trabalho Backup Customer Information criado anteriormente a todos os servidores de destino do grupo Servers Maintaining Customer Information.

USE msdb ;
GO

EXEC dbo.sp_apply_job_to_targets
    @job_name = N'Backup Customer Information',
    @target_server_groups = N'Servers Maintaining Customer Information', 
    @operation = N'APPLY' ;
GO