sp_changesubscription (Transact-SQL)

Статья
12/22/2023

Применимо к:SQL Server Управляемый экземпляр SQL Azure

Изменяет свойства моментального снимка или транзакционной принудительной подписки или подписки по запросу, участвующей в репликации транзакций, обновляемой посредством очередей. Чтобы изменить свойства всех других типов подписок на вытягивание, используйте sp_change_subscription_properties (Transact-SQL). sp_changesubscription выполняется на издателе в базе данных публикации.

Важно!

Если издатель настраивается с удаленным распространителем, то значения, передаваемые для всех аргументов, включая job_login и job_password, передаются распространителю в формате обычного (незашифрованного) текста. Прежде чем выполнять эту хранимую процедуру, необходимо зашифровать соединение между издателем и его удаленным распространителем. Дополнительные сведения см. в статье Включение шифрования соединений в компоненте Database Engine (диспетчер конфигурации SQL Server).

Соглашения о синтаксисе Transact-SQL

Синтаксис

  
sp_changesubscription [ @publication = ] 'publication'  
        , [ @article = ] 'article'  
        , [ @subscriber = ] 'subscriber'  
        , [ @destination_db = ] 'destination_db'  
        , [ @property = ] 'property'  
        , [ @value = ] 'value'  
    [ , [ @publisher = ] 'publisher' ]

Аргументы

[ @publication = ] 'publication' Имя публикации для изменения. публикация— sysname, без значения по умолчанию

[ @article = ] 'article' Имя статьи для изменения. статья — sysname, без значения по умолчанию.

[ @subscriber = ] 'subscriber' Имя подписчика. подписчик — sysname, без значения по умолчанию.

[ @destination_db = ] 'destination_db' Имя базы данных подписки. destination_db — sysname без значения по умолчанию.

[ @property = ] 'property' Свойство, которое нужно изменить для данной подписки. свойство nvarchar (30) и может быть одним из значений в таблице.

[ @value = ] 'value' Новое значение для указанного свойства. значение равно nvarchar(4000) и может быть одним из значений в таблице.

Свойство	Значение	Описание
distrib_job_login		Войдите в учетную запись Microsoft Windows, в которой выполняется агент.
distrib_job_password		Пароль учетной записи Windows, от имени которой выполняется агент.
subscriber_catalog		Каталог, используемый при соединении с поставщиком OLE DB. Это свойство допустимо только для подписчиков, отличных от Microsoft SQL Server.
subscriber_datasource		Имя источника данных, понятное поставщику OLE DB. Это свойство допустимо только для подписчиков, отличных от SQL Server .
subscriber_location		Местоположение базы данных, понятное поставщику OLE DB. Это свойство допустимо только для подписчиков, отличных от SQL Server .
subscriber_login		Имя входа на подписчик.
subscriber_password		Надежный пароль для указанного имени входа.
subscriber_security_mode	1	При подключении к подписчику используется проверка подлинности Windows.
	0	При подключении к подписчику используйте проверку подлинности SQL Server.
subscriber_provider		Уникальный программный идентификатор (PROGID), с которым регистрируется поставщик OLE DB для источника данных, отличного от SQL Server. Это свойство допустимо только для подписчиков, отличных от SQL Server .
subscriber_providerstring		Идентифицирующая источник данных строка соединения, зависящая от поставщика OLE DB. Это свойство допустимо только для подписчиков, отличных от SQL Server .
потоки подписок		Количество дозволенных соединений на каждого агента распространителя при применении пакета изменения параллельно с подписчиком. Диапазон значений от 1 до 64 поддерживается для издателей SQL Server. Это свойство должно быть равно 0 для подписчиков, отличных от SQL Server, издателей Oracle или одноранговых подписок.
subscriber_type	1	Сервер источника данных ODBC
	3	Поставщик OLE DB
memory_optimized	bit	Указывает, что подписка поддерживает оптимизированные для памяти таблицы. memory_optimized бит, где 1 равно true (подписка поддерживает оптимизированные для памяти таблицы).

[ @publisher = ] 'publisher' Указывает издатель, отличный от SQL Server. publisher имеет имя sysname с значением NULL по умолчанию.

Примечание.

Издатель SQL Server не должен быть указан для издателя SQL Server.

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

0 (успешно) или 1 (сбой)

Замечания

sp_changesubscription используется в моментальном снимке и реплика транзакций.

sp_changesubscription можно использовать только для изменения свойств push-подписок или подписок по запросу, участвующих в обновлении транзакционных реплика в очереди. Чтобы изменить свойства всех других типов подписок на вытягивание, используйте sp_change_subscription_properties (Transact-SQL).

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

Разрешения

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

См. также

sp_addsubscription (Transact-SQL)
sp_dropsubscription (Transact-SQL)