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) один раз для каждого целевого сервера.

Разрешения

Эта хранимая процедура принадлежит роли db_owner . Вы можете предоставить 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

Связанный контент