sp_changesubscription (Transact-SQL)
Применимо к: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)
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по