sp_change_subscription_properties (Transact-SQL)

Статья
05/08/2013

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

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

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

При подключении к подписчику используется проверка подлинности 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

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

Для веб-синхронизации используется обычная проверка подлинности.

Примечание
Для веб-синхронизации необходимо соединение с веб-сервером по протоколу 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

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

При подключении к издателю используется проверка подлинности 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.