sp_disableagentoffload (Transact-SQL)

Статья
12/15/2008

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

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

Синтаксис

sp_disableagentoffload [ @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_disableagentoffload используется для отключения возможности выполнения агента распространителя или агента слияния на другом сервере.

После успешного выполнения процедуры sp_disableagentoffload аргумент –Offload offloadserver удаляется из командной строки вызова агента репликации. Поле offload_enabled для агента из таблицы MSdistribution_agents (Transact-SQL) получает значение 0, а поле offload_server обновляется новым значением, указанным аргументом 'remote_agent_server_name', если такой имеется.

Разрешения

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

См. также

Справочник

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

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

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

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