sp_MSchange_distribution_agent_properties (Transact-SQL)

Статья
12/22/2023

Применимо к:SQL Server

Изменяет свойства задания агент распространения, которое выполняется в распространителю microsoft SQL Server 2005 (9.x) или более поздней версии. Эта хранимая процедура используется для изменения свойств при запуске издателя на экземпляре SQL Server 2000 (8.x). Эта хранимая процедура выполняется на распространителе в базе данных распространителя.

Соглашения о синтаксисе 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' Имя публикации. публикация — sysname, без значения по умолчанию.

[ @subscriber = ] 'subscriber' Имя подписчика. подписчик — sysname, без значения по умолчанию.

[ @subscriber_db = ] 'subscriber_db' Имя базы данных подписки. subscriber_db — sysname без значения по умолчанию.

[ @property = ] 'property' Свойство публикации для изменения. свойство — sysname, без значения по умолчанию.

[ @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
потоки подписок		Обозначает количество соединений, разрешенных для агента распространителя с тем, чтобы он применял пакеты изменений параллельно с подписчиком. Не поддерживается для подписчиков, отличных от SQL Server , издателей Oracle или одноранговых подписок.

Примечание.

После изменения имени входа и пароля агента необходимо остановить и повторно запустить агент, чтобы изменения вступили в силу.

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

0 (успешно) или 1 (сбой)

Замечания

sp_MSchange_distribution_agent_properties используется в реплика моментальных снимков и реплика транзакций.

При запуске издателя на экземпляре SQL Server 2005 (9.x) или более поздней версии необходимо использовать sp_changesubscription для изменения свойств задания агент слияния, которое синхронизирует push-подписку, которая выполняется на распространитете.

Разрешения

Только члены предопределенных ролей сервера sysadmin на распространителю могут выполняться sp_MSchange_distribution_agent_properties.

См. также

sp_addpushsubscription_agent (Transact-SQL)
sp_addsubscription (Transact-SQL)