Поделиться через

sp_changedistributor_property (Transact-SQL)

Область применения: SQL Server Управляемый экземпляр SQL Azure

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

Если база данных распространителя или издателя находится в группе доступности, хранимая процедура должна выполняться на всех узлах распространителя и издателя независимо от их текущей роли в группе доступности.

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

Синтаксис

sp_changedistributor_property
    [ [ @property = ] N'property' ]
    [ , [ @value = ] N'value' ]
[ ; ]

Аргументы

[ @property = ] N'property'

Свойство для данного распространителя. @property является sysname и может быть одним из следующих значений:

Название свойства Допустимые значения Описание
heartbeat_interval Любое значение int (в минутах) Максимальное время работы агента (в минутах) без регистрации сообщения о ходе выполнения. @heartbeat_interval имеет значение int с значением 10 по умолчанию.
encrypt_distributor_connection mandatory, optional, stricttruefalseyesno Указывает тип шифрования между распространителем и другими компонентами репликации.

Применимо к: SQL Server 2025 (17.x) и более поздних версий.
trust_distributor_certificate yes, no Указывает, следует ли доверять сертификату, используемому распространителем для зашифрованных подключений. Значение по умолчанию — no.

Применимо к: SQL Server 2025 (17.x) и более поздних версий.
host_name_in_distributor_certificate Любая строка Указывает ожидаемое имя узла в сертификате распространителя.

Применимо к: SQL Server 2025 (17.x) и более поздних версий.
NULL (по умолчанию) Печатаются все доступные @property значения.

Замечание

Безопасные значения по умолчанию относятся к базовому поставщику OLEDB 19, что повышает безопасность. Параметр переопределения по умолчанию является менее безопасным, чем настройка экземпляра для использования доверенного сертификата. После переопределения по умолчанию у вас есть возможность настроить SQL Server для использования сертификата, а затем использовать хранимую процедуру sp_changedistributor_property для возврата trust_distributor_certificate=no свойства в безопасное значение по умолчанию.

[ @value = ] N'value'

Значение для заданного свойства распространителя. @value — nvarchar(255) с значением по умолчаниюNULL.

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

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

Замечания

sp_changedistributor_property используется во всех типах репликации.

Примеры


-- Change the heartbeat interval at the Distributor to 5 minutes. 
USE master 
exec sp_changedistributor_property 
    @property = N'heartbeat_interval', 
    @value = 5;
GO

Настройка распространителя для доверия самозаверяющего сертификата

Чтобы переопределить безопасное значение по умолчанию поставщика OLEDB 19 и установить trust_distributor_certificate=yes , чтобы распространитель доверял самозаверяющий сертификат, используйте следующий пример:

EXECUTE sp_changedistributor_property
    @property = N'trust_distributor_certificate',
    @value = N'yes';

Замечание

Безопасные значения по умолчанию относятся к базовому поставщику OLEDB 19, что повышает безопасность. Параметр переопределения по умолчанию является менее безопасным, чем настройка экземпляра для использования доверенного сертификата. После переопределения по умолчанию у вас есть возможность настроить SQL Server для использования сертификата, а затем использовать хранимую процедуру sp_changedistributor_property для возврата trust_distributor_certificate=no свойства в безопасное значение по умолчанию.

Для получения дополнительной информации ознакомьтесь с удалённым дистрибьютором, который стал решающим изменением в SQL Server 2025.

Разрешения

Могут выполняться только члены sp_changedistributor_property.

Связанный контент

  • Last updated on