sp_apply_job_to_targets (Transact-SQL)
Область применения: SQL Server
Применяет задание к одному или нескольким целевым серверам или к целевым серверам, принадлежащим к одной или нескольким группам целевых серверов.
Соглашения о синтаксисе Transact-SQL
Синтаксис
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' ]
[ ; ]
Аргументы
[ @job_id = ] 'job_id'
Идентификационный номер задания, которое следует применить к указанным целевым серверам и группам целевых серверов. @job_id является уникальным идентификатором по умолчаниюNULL
.
Необходимо указать @job_id или @job_name, но их нельзя указать.
[ @job_name = ] N'job_name'
Имя указания, которое следует применить к связанным целевым серверам и группам целевых серверов. @job_name — sysname с значением по умолчаниюNULL
.
Необходимо указать @job_id или @job_name, но их нельзя указать.
[ @target_server_groups = ] N'target_server_groups'
Список групп целевых серверов с разделителями-запятыми, к которым следует применить указанное задание. @target_server_groups — nvarchar(2048) с значением по умолчаниюNULL
.
[ @target_servers = ] N'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
) один раз для каждого целевого сервера.
Разрешения
Вы можете предоставить EXECUTE
разрешения для этой процедуры, но эти разрешения могут быть переопределены во время обновления SQL Server.
Примеры
В следующем примере ко всем целевым серверам в группе Backup Customer Information
применяется ранее созданное задание 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