sp_changemergepullsubscription (Transact-SQL)

Изменяет свойства подписки слиянием по запросу. Эта хранимая процедура выполняется на подписчике в базе данных подписки.

Значок ссылки на разделСинтаксические обозначения в Transact-SQL

Синтаксис

sp_changemergepullsubscription [ [ @publication= ] 'publication' ]
    [ , [ @publisher= ] 'publisher' ]
    [ , [ @publisher_db= ] 'publisher_db' ]
    [ , [ @property= ] 'property' ]
    [ , [ @value= ] 'value' ]

Аргументы

  • [ @publication=] 'publication'
    Имя публикации. Аргумент publication имеет тип sysname и значение по умолчанию %.

  • [ @publisher=] 'publisher'
    Имя издателя. Аргумент publisher имеет тип sysname и значение по умолчанию %.

  • [ @publisher_db=] 'publisher_db'
    Имя базы данных издателя. Аргумент publisher_dbимеет тип sysname и значение по умолчанию %.

  • [ @property=] 'property'
    Имя изменяемого свойства. Аргумент property имеет тип sysname и может принимать одно из значений, приведенных в таблице.

  • [ @value=] 'value'
    Новое значение заданного свойства. Аргумент value имеет тип nvarchar(255) и может принимать одно из значений, приведенных в таблице.

    Свойство

    Значение

    Описание

    alt_snapshot_folder

    Местоположение папки моментальных снимков, если оно отлично от местоположения по умолчанию или дополняет его.

    description

    Описание подписки слиянием по запросу.

    distributor

    Имя распространителя.

    distributor_login

    Идентификатор входа, используемый на стороне распространителя для проверки подлинности SQL Server.

    distributor_password

    Пароль (шифрованный), используемый на стороне распространителя для проверки подлинности SQL Server.

    distributor_security_mode

    1

    При подключении к подписчику используется проверка подлинности Windows.

    0

    При подключении к подписчику используется проверка подлинности SQL Server.

    dynamic_snapshot_location

    Путь к папке, в которой сохраняются файлы моментальных снимков.

    ftp_address

    Только для обеспечения обратной совместимости. Сетевой адрес службы FTP распространителя.

    ftp_login

    Только для обеспечения обратной совместимости. Имя пользователя, используемое при подключении к службе FTP.

    ftp_password

    Только для обеспечения обратной совместимости. Пароль, используемый при подключении к службе FTP.

    ftp_port

    Только для обеспечения обратной совместимости. Номер порта службы FTP распространителя.

    hostname

    Указывает значение HOST_NAME(), когда эта функция используется в предложении WHERE фильтра соединения или отношения логических записей.

    internet_login

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

    internet_password

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

    internet_security_mode

    1

    Использование системы проверки подлинности Windows при подключении к веб-серверу, который поддерживает веб-синхронизацию.

    0

    Использование обычной системы проверки подлинности при подключении к веб-серверу, который поддерживает веб-синхронизацию.

    internet_timeout

    Продолжительность времени, в секундах, перед истечением срока действия запроса на веб-синхронизацию.

    internet_url

    UR-адрес, который представляет собой адрес средства прослушивания репликации для веб-синхронизации.

    merge_job_login

    Имя входа для учетной записи Windows, которую использует агент.

    merge_job_password

    Пароль учетной записи Windows, которую использует агент.

    priority

    Только для обеспечения обратной совместимости. Для изменения приоритета подписки следует запустить хранимую процедуру sp_changemergesubscription на стороне издателя.

    publisher_login

    Идентификатор входа, используемый на стороне издателя для проверки подлинности SQL Server.

    publisher_password

    Пароль (шифрованный), используемый на издателе для проверки подлинности SQL Server.

    publisher_security_mode

    0

    При подключении к издателю используется проверка подлинности SQL Server.

    1

    При подключении к подписчику используется проверка подлинности Windows.

    2

    Триггеры синхронизации используют статическую запись sysservers при выполнении удаленного вызова процедур (RPC), а издатель должен быть определен в таблице sysservers как удаленный или связанный сервер.

    sync_type

    automatic

    Подписчику предварительно передаются схема и начальные данные для опубликованных таблиц.

    none

    Подписчик уже имеет схему и начальные данные для опубликованных таблиц; системные таблицы и данные передаются всегда.

    use_ftp

    true

    Для получения моментальных снимков используется FTP вместо обычного протокола.

    false

    Получение моментальных снимков с помощью обычного протокола.

    use_web_sync

    true

    Подписку можно синхронизировать через HTTP.

    false

    Подписку нельзя синхронизировать через HTTP.

    use_interactive_resolver

    true

    При проверке используется интерактивный арбитр.

    false

    Интерактивный арбитр не используется.

    working_directory

    Полностью специфицированный путь к каталогу, куда передаются файлы моментальных снимков с использованием протокола FTP, если этот параметр задан.

    NULL (по умолчанию)

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

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

0 (успешное завершение) или 1 (неуспешное завершение)

Замечания

Процедура sp_changemergepullsubscription применяется в репликации слиянием.

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

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

Разрешения

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