Статья
04/01/2012

sp_change_subscription_properties (Transact-SQL)

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

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

Синтаксис

sp_change_subscription_properties [ @publisher = ] 'publisher'
        , [ @publisher_db = ] 'publisher_db'
        , [ @publication = ] 'publication'
        , [ @property = ] 'property'
        , [ @value = ] 'value'
    [ , [ @publication_type = ] publication_type ]

Аргументы

[ @publisher=] 'publisher'
Имя издателя. Аргумент publisher имеет тип sysname и не имеет значения по умолчанию.
[ @publisher_db=] 'publisher_db'
Имя базы данных издателя. Аргумент publisher_db имеет тип sysname и не имеет значения по умолчанию.
[ @publication=] 'publication'
Имя публикации. Аргумент publication имеет тип sysname и не имеет значения по умолчанию.
[ @property=] 'property'
Изменяемое свойство. Аргумент property имеет тип sysname.
[ @value=] 'value'
Новое значение свойства. Аргумент value имеет тип nvarchar(1000) и не имеет значения по умолчанию.

[ @publication_type = ] publication_type
Указывает тип репликации публикации. Аргумент publication_type имеет тип int и может принимать одно из следующих значений:

Значение	Тип публикации
0	Транзакционная.
1	Публикация моментальных снимков.
2	Публикация слиянием.
NULL (по умолчанию)	Репликация определяет тип публикации. Так как хранимая процедура должна выполнять просмотр в нескольких таблицах, работа при указании этого значения производится медленнее, чем в случае, когда предоставлен точный тип публикации.

Следующая таблица описывает свойства статей и значения этих свойств.

Свойство	Значение	Описание
alt_snapshot_folder		Указывает местоположение альтернативной папки для моментального снимка. Если это свойство имеет значение NULL, файлы моментальных снимков выбираются из места по умолчанию, задаваемого издателем.
distrib_job_login		Имя входа учетной записи Microsoft Windows, от имени которой выполняется агент.
distrib_job_password		Пароль учетной записи Windows, от имени которой выполняется агент.
distributor_login		Имя входа распространителя.
distributor_password		Пароль распространителя.
distributor_security_mode	1	При подключении к подписчику используется проверка подлинности Windows.
	0	При подключении к подписчику используется проверка подлинности SQL Server.
dts_package_name		Указывает имя пакета служб SQL Server 2000 Data Transformation Services (DTS). Это значение может задаваться, если только публикация является транзакционной или публикацией моментальных снимков.
dts_package_password		Указывает пароль пакета. Аргумент dts_package_password имеет тип sysname и значение по умолчанию NULL; это означает, что свойство пароля должно быть оставлено без изменений. Примечание У пакета служб DTS должен быть пароль. Это значение может задаваться, если только публикация является транзакционной или публикацией моментальных снимков.
dts_package_location		Местоположение, где хранится пакет служб DTS. Это значение может задаваться, если только публикация является транзакционной или публикацией моментальных снимков.
dynamic_snapshot_location		Указывает путь к папке, в которой сохраняются файлы моментальных снимков. Это значение может задаваться, если только публикация является публикацией слиянием.
ftp_address		Только для обратной совместимости.
ftp_login		Только для обратной совместимости.
ftp_password		Только для обратной совместимости.
ftp_port		Только для обратной совместимости.
hostname		Имя узла, используемое при соединении с издателем.
internet_login		Имя входа, используемое агентом слияния для подключения к веб-серверу, на котором доступна веб-синхронизация с обычной проверкой подлинности.
internet_password		Пароль, используемый агентом слияния для подключения к веб-серверу, на котором доступна веб-синхронизация с обычной проверкой подлинности.
internet_security_mode	1	Для веб-синхронизации используется встроенная проверка подлинности Windows. При веб-синхронизации рекомендуется использовать обычную проверку подлинности. Дополнительные сведения см. в разделе Настройка веб-синхронизации.
	0	Для веб-синхронизации используется обычная проверка подлинности. Примечание Для веб-синхронизации необходимо соединение с веб-сервером по протоколу SSL.
internet_timeout		Время (в секундах) перед отменой запроса на веб-синхронизацию.
internet_url		UR-адрес, который представляет собой адрес средства прослушивания репликации для веб-синхронизации.
merge_job_login		Имя входа учетной записи Windows, от имени которой выполняется агент.
merge_job_password		Пароль учетной записи Windows, от имени которой выполняется агент.
publisher_login		Имя входа издателя. Изменение свойства publisher_login поддерживается только для подписок на публикации слиянием.
publisher_password		Пароль издателя. Изменение свойства publisher_password поддерживается только для подписок на публикации слиянием.
publisher_security_mode	1	При подключении к подписчику используется проверка подлинности Windows. Изменение свойства publisher_security_mode поддерживается только для подписок на публикации слиянием.
	0	При подключении к издателю используется проверка подлинности SQL Server.
use_ftp	true	Использование FTP вместо обычного протокола для получения моментальных снимков.
	false	Использование обычного протокола для получения моментальных снимков.
use_web_sync	true	Включение веб-синхронизации.
	false	Отключение веб-синхронизации.
working_directory		Имя рабочего каталога, используемого для временного хранения файлов данных и схем для публикации, если для передачи файлов моментальных снимков используется протокол передачи файлов (FTP).

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

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

Замечания

Хранимая процедура sp_change_subscription_properties используется для всех типов репликации.

Процедура sp_change_subscription_properties используется для подписок по запросу.

Для издателей Oracle значение аргумента publisher_db не учитывается, т. к. Oracle допускает наличие только одной базы данных на экземпляре сервера.

Разрешения

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