Sdílet prostřednictvím


sp_changedistributor_property (Transact-SQL)

platí pro:SQL Serverazure SQL Managed Instance

Změní vlastnosti distributora. Tato uložená procedura se provádí u distributora v libovolné databázi. U vzdálených distributorů musí být tato uložená procedura spuštěna na všech serverech vydavatele, které se připojují ke vzdálenému distributoru.

Pokud je distribuce nebo databáze Publisheru ve skupině dostupnosti, musí být uložená procedura spuštěna na všech uzlech Distributor a Publisher bez ohledu na jejich aktuální roli ve skupině dostupnosti.

Transact-SQL konvence syntaxe

Syntaxe

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

Arguments

[ @property = ] N'property'

Vlastnost pro daného distributora. @property je sysname a může to být jedna z těchto hodnot:

Název vlastnosti Přijatelné hodnoty Description
heartbeat_interval Libovolná hodnota int (v minutách) Maximální počet minut, po které může agent běžet bez protokolování zprávy o průběhu. @heartbeat_interval je int s výchozím nastavením 10 minut.
encrypt_distributor_connection mandatory, optional, strict, true, false, , yesno Určuje typ šifrování mezi distributorem a dalšími komponentami replikace.

Platí pro: SQL Server 2025 (17.x) a novější verze
trust_distributor_certificate yes, no Určuje, jestli se má certifikát používaný distributorem pro šifrovaná připojení důvěřovat. Výchozí hodnota je no.

Platí pro: SQL Server 2025 (17.x) a novější verze
host_name_in_distributor_certificate Libovolný řetězec Určuje očekávaný název hostitele v certifikátu distributora.

Platí pro: SQL Server 2025 (17.x) a novější verze
NULL (výchozí) Vytisknou se všechny dostupné @property hodnoty.

Poznámka:

Výchozí nastavení zabezpečení se týkají základního zprostředkovatele OLEDB 19, který zvyšuje zabezpečení. Možnost přepsání výchozího nastavení je méně bezpečná než konfigurace instance tak, aby používala důvěryhodný certifikát. Po přepsání výchozího nastavení máte možnost nakonfigurovat SQL Server tak, aby používal certifikát, a pak pomocí sp_changedistributor_property uložené procedury nastavit trust_distributor_certificate=no vlastnost zpět na zabezpečené výchozí.

[ @value = ] N'value'

Hodnota pro danou vlastnost Distributor. @value je nvarchar(255) s výchozí hodnotou NULL.

Hodnoty návratového kódu

0 (úspěch) nebo 1 (selhání).

Poznámky

sp_changedistributor_property se používá ve všech typech replikace.

Examples


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

Konfigurace distributora tak, aby důvěřoval certifikátu podepsanému svým držitelem

Pokud chcete přepsat zabezpečené výchozí nastavení zprostředkovatele OLEDB 19 a nastavit trust_distributor_certificate=yes tak, aby distributor důvěřoval certifikátu podepsanému svým držitelem, použijte následující příklad:

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

Poznámka:

Výchozí nastavení zabezpečení se týkají základního zprostředkovatele OLEDB 19, který zvyšuje zabezpečení. Možnost přepsání výchozího nastavení je méně bezpečná než konfigurace instance tak, aby používala důvěryhodný certifikát. Po přepsání výchozího nastavení máte možnost nakonfigurovat SQL Server tak, aby používal certifikát, a pak pomocí sp_changedistributor_property uložené procedury nastavit trust_distributor_certificate=no vlastnost zpět na zabezpečené výchozí.

Pro více informací si přečtěte změnu v oblasti vzdáleného distributora, která přerušuje SQL Server 2025.

Povolení

Spustit můžou pouze členové pevné role serveru sp_changedistributor_property .