sp_MSchange_distribution_agent_properties (Transact-SQL)

  • Статья

Область применения: SQL Server

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

Соглашения о синтаксисе Transact-SQL

Синтаксис

sp_MSchange_distribution_agent_properties
    [ @publisher = ] N'publisher'
    , [ @publisher_db = ] N'publisher_db'
    , [ @publication = ] N'publication'
    , [ @subscriber = ] N'subscriber'
    , [ @subscriber_db = ] N'subscriber_db'
    , [ @property = ] N'property'
    , [ @value = ] N'value'
[ ; ]

Аргументы

[ @publisher = ] N'publisher'

Имя издателя. @publisher — sysname без значения по умолчанию.

[ @publisher_db = ] N'publisher_db'

Имя базы данных публикации. @publisher_db — sysname без значения по умолчанию.

[ @publication = ] N'publication'

Имя публикации. @publication — sysname без значения по умолчанию.

[ @subscriber = ] N'подписчик'

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

[ @subscriber_db = ] N'subscriber_db'

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

[ @property = ] N'property'

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

[ @value = ] N'value'

Значение нового свойства. @value — nvarchar(524), без значения по умолчанию.

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

Свойство Значение Описание
distrib_job_login Войдите в учетную запись Microsoft Windows, в которой выполняется агент.
distrib_job_password Пароль учетной записи Windows, под которой запускается задание агента.
subscriber_catalog 1 Каталог, используемый при соединении с поставщиком OLE DB.
subscriber_datasource 1 Имя источника данных, понятное поставщику OLE DB.
subscriber_location 1 Местоположение базы данных, понятное поставщику OLE DB.
subscriber_login Имя входа, используемое при подключении к подписчику для синхронизации подписки.
subscriber_password Пароль подписчика.

Не используйте пустые пароли. Выбирайте надежные пароли.
subscriber_provider 1 Уникальный программный идентификатор (PROGID), с которым регистрируется поставщик OLE DB для источника данных, отличного от SQL Server.
subscriber_providerstring 1 Идентифицирующая источник данных строка соединения, зависящая от поставщика OLE DB.
subscriber_security_mode 1 Проверка подлинности Windows.

По возможности используйте аутентификацию Windows.
0 Проверка подлинности SQL Server.
subscriber_type 0 Подписчик SQL Server
1 Сервер источника данных ODBC
3 Поставщик OLE DB
subscriptionstreams 2 Обозначает количество соединений, разрешенных для агента распространителя с тем, чтобы он применял пакеты изменений параллельно с подписчиком.

1 Допустимо только для подписчиков, отличных от SQL Server.

2 Не поддерживается для подписчиков, отличных от SQL Server, издателей Oracle или одноранговых подписок.

Примечание.

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

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

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

Замечания

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

Вы можете использовать sp_changesubscription на издателе, чтобы изменить свойства задания агент слияния, которое синхронизирует push-подписку, которая выполняется на распространителю.

Разрешения

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

Связанный контент