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

  • Статья

sp_post_msx_operation (Transact-SQL)

Вставляет операции (строки) в системную таблицу 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 и не имеет значения по умолчанию.

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

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

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

Нет

Замечания

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

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

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

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

Разрешения

Для выполнения данной хранимой процедуры пользователи должны быть членами предопределенной роли сервера sysadmin.