Share via

  • Статья

sp_MSchange_distribution_agent_properties (Transact-SQL)

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