sp_apply_job_to_targets (Transact-SQL)

Статья
12/15/2008

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

Синтаксис

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, но не оба аргумента одновременно.

Примечание.
Необходимо указать либо 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

См. также

Справочник

sp_add_jobserver (Transact-SQL)
sp_delete_jobserver (Transact-SQL)
sp_remove_job_from_targets (Transact-SQL)
Системные хранимые процедуры (Transact-SQL)

Справка и поддержка

Получение помощи по SQL Server 2005

Поделиться через