sp_disableagentoffload (Transact-SQL)
Отключает активацию удаленного агента принудительной подписки для агента принудительной подписки репликации, определяемого аргументом @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)