sp_enableagentoffload (Transact-SQL)

Включает удаленную активацию агента принудительной репликации, определяемого аргументом @job_id. Эта хранимая процедура запускается на компьютере, который является текущим сервером удаленного агента. Эта хранимая процедура выполняется на издателе в базе данных публикации.

Важно!
Поддержка удаленной активации агента для распространителей под управлением Microsoft SQL Server 2005 и более поздних версий прекращена.

Синтаксические обозначения в Transact-SQL

Синтаксис

sp_enableagentoffload [ @job_id = ] job_id
    [ , [ @offloadserver = ] 'remote_agent_server_name' ]
    [ , [ @agent_type = ] 'agent_type' ]

Аргументы

• [ @job_id=] 'job_id'
  Указывает идентификатор задания агента SQL Server для агента репликации, подлежащего удаленной активации. Аргумент job_id имеет тип varbinary(16) и не имеет значения по умолчанию.

• [ @offloadserver=] 'remote_agent_server_name'
  Указывает сетевое имя сервера, используемого для удаленной активации агентов. Аргумент remote_agent_server_name имеет тип sysname и значение по умолчанию NULL. Если значение равно NULL, то используется текущее значение столбца offload_server из таблицы MSDistribution_agents.

• [ @agent_type=] 'agent_type'
  Тип агента. Аргумент agent_type имеет тип sysname и значение по умолчанию, равное NULL, означающее, что система сама определяет тип агента (распространителя или слияния). Допустимыми значениями являются distribution, merge или NULL.

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

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

Замечания

Процедура sp_enableagentoffload используется для разрешения выполнения агента распространителя или агента слияния на другом сервере.

После успешного завершения хранимой процедуры sp_enableagentoffload аргумент –Offloadoffloadserver добавляется в конец командной строки агента репликации, или обновляется новым значением 'remote_agent_server_name', если аргумент –Offloadoffloadserver уже имеется в командной строке.

Кроме того, поле offload_enabled агента в MSdistribution_agents (Transact-SQL) устанавливается в значение 1, а поле сервера разгрузки обновляется новым значением, заданным в 'remote_agent_server_name', если он имеется.

Разрешения

Только члены фиксированной серверной роли sysadmin или фиксированной роли базы данных db_owner, либо владелец подписки указанного агента могут выполнять хранимую процедуру sp_enableagentoffload.

См. также

Справочник

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

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

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