Share via

  • Статья

sp_apply_job_to_targets (Transact-SQL)

Применяет задание к одному или нескольким целевым серверам или к целевым серверам, принадлежащим к одной или нескольким группам целевых серверов.

Значок ссылки на разделСинтаксические обозначения в Transact-SQL

Синтаксис

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' ]

Аргументы

  • [ @job_id =] job_id
    Идентификатор задания, применяемого к указанным целевым серверам или группам целевых серверов. Аргумент job_id имеет тип uniqueidentifier и значение по умолчанию NULL.

  • [ @job_name =] 'job_name'
    Имя задания, применяемого к указанным целевым серверам или группам целевых серверов. Аргумент job_name имеет тип sysname и значение по умолчанию NULL.

    ПримечаниеПримечание

    Необходимо указать либо job_id, либо job_name, но не оба аргумента одновременно.

  • [ @target_server_groups =] 'target_server_groups'
    Список групп целевых серверов с разделителями-запятыми, к которым следует применить указанное задание. Аргумент target_server_groups имеет тип nvarchar(2048) и значение по умолчанию NULL.

  • [ @target_servers= ] 'target_servers'
    Список целевых серверов с разделителями-запятыми, к которым следует применить указанное задание. Аргумент target_serversимеет тип nvarchar(2048) и значение по умолчанию NULL.

  • [ @operation= ] 'operation'
    Определяет, должно ли указанное задание быть применено или удалено с указанных целевых серверов или групп целевых серверов. Аргумент operationимеет тип varchar(7) и значение по умолчанию APPLY. Допустимыми операциями являются APPLY и REMOVE.

Значения кодов возврата

0 (успешное завершение) или 1 (неуспешное завершение)

Замечания

Процедура sp_apply_job_to_targets обеспечивает легкий способ применения (или удаления) задания к нескольким целевым серверам и является альтернативным методом одноразового вызова процедуры sp_add_jobserver (или sp_delete_jobserver) для каждого целевого сервера в случае необходимости.

Разрешения

Эту процедуру могут выполнять только члены предопределенной роли сервера sysadmin.

Примеры

В следующем примере ко всем целевым серверам в группе Servers Maintaining Customer Information применяется ранее созданное задание Backup 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