Compartilhar via


sp_apply_job_to_targets (Transact-SQL)

Aplica-se a: SQL Server

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.

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_apply_job_to_targets
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @target_server_groups = ] N'target_server_groups' ]
    [ , [ @target_servers = ] N'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 de NULL.

Tanto @job_id quanto @job_name devem ser especificados, mas ambos não podem ser especificados.

@job_name [ = ] N'job_name'

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

Tanto @job_id quanto @job_name devem ser especificados, mas ambos não podem ser especificados.

@target_server_groups [ = ] N'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 de NULL.

@target_servers [ = ] N'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 de NULL.

@operation [ = ] 'operação'

Especifica se o trabalho especificado deve ser aplicado ou removido dos servidores de destino ou grupos de servidores de destino especificados. @operation é varchar(7), com um padrão de APPLY. As operações válidas são APPLY e REMOVE.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Comentários

sp_apply_job_to_targets fornece uma maneira fácil de aplicar (ou remover) um trabalho de vários servidores de destino e é uma alternativa para chamar sp_add_jobserver (ou sp_delete_jobserver) uma vez para cada servidor de destino necessário.

Permissões

Esse procedimento armazenado pertence à função db_owner . Você pode conceder EXECUTE permissões para qualquer usuário, mas essas permissões podem ser substituídas durante uma atualização do SQL Server.

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