sp_changemergepullsubscription (Transact-SQL)

Статья
05/08/2013

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

Значок ссылки на раздел Синтаксические обозначения в 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.