sp_MSchange_distribution_agent_properties (Transact-SQL)

Статья
05/08/2013

Изменяет свойства задания агента распространителя, выполняемого на распространителе Microsoft 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)

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