sp_post_msx_operation (Transact-SQL)

Статья
06/18/2013

Вставляет операции (строки) в системную таблицу sysdownloadlist для последующей загрузки и выполнения целевыми серверами.

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

Синтаксис

sp_post_msx_operation
     [ @operation = ] 'operation'
     [ , [ @object_type = ] 'object' ] 
     { , [ @job_id = ] job_id } 
     [ , [ @specific_target_server = ] 'target_server' ] 
     [ , [ @value = ] value ]
     [ , [ @schedule_uid = ] schedule_uid ]

Аргументы

[ @operation =] 'operation'
Тип операции для отправленной операции. Аргумент operation имеет тип varchar(64) и не имеет значения по умолчанию. Допустимость операций зависит от object_type.

Тип объекта

Операция

JOB

INSERT

UPDATE

DELETE

START

STOP

SERVER

RE-ENLIST

DEFECT

SYNC-TIME

SET-POLL

SCHEDULE

INSERT

UPDATE

DELETE
[ @object_type =] 'object'
Тип объекта, для которого отправляется операция. К корректным типам относятся JOB, SERVER и SCHEDULE. Аргумент object имеет тип varchar(64) и значение по умолчанию JOB.
[ @job_id =] job_id
Идентификационный номер задания, к которому применяется операция. Аргумент job_id имеет тип uniqueidentifier и не имеет значения по умолчанию. Значение 0x00 подразумевает все задания. Если аргумент object имеет тип SERVER, то аргумент job_id не требуется.
[ @specific_target_server =] 'target_server'
Имя целевого сервера, к которому применяется заданная операция. Если указан аргумент job_id, а аргумент target_server не указан, то операции направляются на все серверы задания. Аргумент target_server имеет тип nvarchar(30) и значение по умолчанию NULL.
[ @value =] value
Интервал опроса (в секундах). Аргумент value имеет тип int и значение по умолчанию NULL. Этот аргумент указывается только в том случае, если аргумент operation имеет значение SET-POLL.
[ @schedule_uid= ] schedule_uid
Уникальный идентификатор расписания, к которому применяется операция. Аргумент schedule_uid имеет тип uniqueidentifier и не имеет значения по умолчанию.

Тип объекта	Операция
JOB	INSERT UPDATE DELETE START STOP
SERVER	RE-ENLIST DEFECT SYNC-TIME SET-POLL
SCHEDULE	INSERT UPDATE DELETE

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

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

Результирующие наборы

Нет

Замечания

Процедура sp_post_msx_operation должна запускаться из базы данных msdb.

Процедура sp_post_msx_operation всегда работает корректно, так как перед ее выполнением производится проверка, является ли текущий сервер многосерверным агентом Microsoft SQL Server, а в случае положительного результата первой проверки также проверяется, является ли object многосерверным заданием.

После отправки операции она появляется в таблице sysdownloadlist. После создания и отправки задания все его дальнейшие изменения должны отправляться на целевые серверы (TSX). Для этого необходимо использовать список загрузки.

Для управления списком загрузки настоятельно рекомендуется использовать среду SQL Server Management Studio. Дополнительные сведения см. в разделе Просмотр или изменение заданий.