sp_MSchange_distribution_agent_properties (Transact-SQL)
Изменяет свойства задания агента распространителя, выполняющегося на распространителе Microsoft SQL Server 2005. Эта хранимая процедура используется для изменения свойств SQL Server 2005, если издатель запущен на экземпляре SQL Server 2000. Эта хранимая процедура выполняется на распространителе в базе данных распространителя.
Синтаксические обозначения в Transact-SQL
Синтаксис
sp_MSchange_distribution_agent_properties [ @publisher = ] 'publisher'
, [ @publisher_db = ] 'publisher_db'
, [ @publication = ] 'publication'
, [ @subscriber = ] 'subscriber'
, [ @subscriber_db = ] 'subscriber_db'
, [ @property = ] 'property'
, [ @value = ] 'value' ]
Аргументы
- [ @publisher = ] 'publisher'
Имя издателя. Аргумент publisher имеет тип sysname и не имеет значения по умолчанию.
- [ @publisher_db= ] 'publisher_db'
Имя базы данных публикации. Аргумент publisher_db имеет тип sysname и не имеет значения по умолчанию.
- [ @publication = ] 'publication'
Имя публикации. Аргумент publication имеет тип sysname и не имеет значения по умолчанию.
- [ @subscriber= ] 'subscriber'
Имя подписчика. Аргумент subscriber имеет тип sysname и не имеет значения по умолчанию.
- [ @subscriber_db= ] 'subscriber_db'
Имя базы данных подписки. Аргумент subscriber_db имеет тип sysname и не имеет значения по умолчанию.
- [ @property = ] 'property'
Изменяемое свойство публикации. Аргумент property имеет тип sysname и не имеет значения по умолчанию.
[ @value = ] 'value'
Новое значение свойства. Аргумент value имеет тип nvarchar(524) и значение по умолчанию NULL.В следующей таблице приводятся свойства задания агента распространителя, доступные для изменения, а также ограничения на значения этих свойств.
Свойство Значение Описание distrib_job_login
Имя входа учетной записи Microsoft Windows, под которой запускается агент.
distrib_job_password
Пароль учетной записи Windows, под которой запускается агент.
subscriber_catalog
Каталог, используемый при установлении подключения к поставщику OLE DB. Данное свойство допустимо только для подписчиков, не являющихся подписчиками SQL Server.
subscriber_datasource
Имя источника данных, понятное поставщику OLE DB. Данное свойство допустимо только для подписчиков, не являющихся подписчиками SQL Server.
subscriber_location
Местонахождение базы данных, понятное поставщику OLE DB. Данное свойство допустимо только для подписчиков, не являющихся подписчиками SQL Server.
subscriber_login
Имя входа при подключении к подписчику дли синхронизации подписки.
subscriber_password
Пароль подписчика.
Не используйте пустые пароли. Выбирайте надежные пароли.
subscriber_provider
Уникальный программный идентификатор (PROGID), с которым зарегистрирован поставщик OLE DB для источников данных, не относящихся к SQL Server. Данное свойство допустимо только для подписчиков, не являющихся подписчиками SQL Server.
subscriber_providerstring
Зависящая от поставщика OLE DB строка соединения, идентифицирующая источник данных. Данное свойство допустимо только для подписчиков, отличных от подписчика SQL Server.
subscriber_security_mode
1
Проверка подлинности Windows.
При возможности используйте проверку подлинности Windows.
0
Проверка подлинности SQL Server.
subscriber_type
0
Подписчик SQL Server.
1
Сервер источника данных ODBC.
3
Поставщик OLE DB.
subscriptionstreams
Обозначает количество соединений, разрешенных для агента распространителя с тем, чтобы он применял пакеты изменений параллельно с подписчиком. Не поддерживается для подписчиков, не являющихся подписчиками SQL Server, издателей Oracle и одноранговых подписок.
Примечание. После изменения имени входа и пароля агента необходимо остановить и перезапустить его с тем, чтобы изменения вступили в силу.
Значения кодов возврата
0 (успешное завершение) или 1 (неуспешное завершение)
Замечания
Процедура sp_MSchange_distribution_agent_properties используется в репликации моментальных снимков и репликации транзакций.
Если издатель выполняется на экземпляре SQL Server 2005, то необходимо использовать процедуру sp_changesubscription для изменения свойств задания агента слияния, который синхронизирует принудительную подписку, выполняющуюся на распространителе.
Разрешения
Только члены фиксированной серверной роли sysadmin на распространителе могут выполнять процедуру sp_MSchange_distribution_agent_properties.
См. также
Справочник
sp_addpushsubscription_agent (Transact-SQL)
sp_addsubscription (Transact-SQL)
Другие ресурсы
Использование нескольких версий SQL Server в топологии репликации