Dela via

sp_changedistributor_property (Transact-SQL)

gäller för:SQL ServerAzure SQL Managed Instance

Ändrar distributörens egenskaper. Den här lagrade proceduren körs på distributören på valfri databas. För fjärranslutna distributörer måste den här lagrade proceduren köras på alla Publisher-servrar som ansluter till fjärrdistributören.

Om distributionen eller Publisher-databasen finns i en tillgänglighetsgrupp måste den lagrade proceduren köras på alla noder för distributör och utgivare, oavsett deras aktuella roll i tillgänglighetsgruppen.

Transact-SQL syntaxkonventioner

Syntax

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

Arguments

[ @property = ] N'property'

Egenskapen för en viss distributör. @property är sysname och kan vara ett av följande värden:

Egenskapsnamn Godtagbara värden Description
heartbeat_interval Valfritt int-värde (i minuter) Maximalt antal minuter som en agent kan köra utan att logga ett förloppsmeddelande. @heartbeat_interval är int, med standardvärdet 10 minuter.
encrypt_distributor_connection mandatory, optional, strict, true, false, , , yesno Anger krypteringstypen mellan distributören och andra replikeringskomponenter.

Gäller för: SQL Server 2025 (17.x) Förhandsversion och senare versioner.
trust_distributor_certificate yes, no Anger om certifikatet som används av distributören ska vara tillförlitligt för krypterade anslutningar. Standardvärdet är no.

Gäller för: SQL Server 2025 (17.x) Förhandsversion och senare versioner.
host_name_in_distributor_certificate Valfri sträng Anger det förväntade värdnamnet i distributörens certifikat.

Gäller för: SQL Server 2025 (17.x) Förhandsversion och senare versioner.
NULL (standardinställning) Alla tillgängliga @property värden skrivs ut.

Anmärkning

Säkra standardvärden gäller den underliggande OLEDB-providern 19, vilket förbättrar säkerheten. Alternativet att åsidosätta standardinställningen är mindre säkert än att konfigurera din instans för att använda ett betrott certifikat. När du har åsidosättt standardinställningen har du möjlighet att konfigurera SQL Server att använda ett certifikat och sedan använda den sp_changedistributor_property lagrade proceduren för att ange trust_distributor_certificate=no egenskapen tillbaka till den säkra standardinställningen.

[ @value = ] N'value'

Värdet för den angivna distributörsegenskapen. @value är nvarchar(255), med standardvärdet NULL.

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Anmärkningar

sp_changedistributor_property används i alla typer av replikering.

Examples


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

Konfigurera distributören att lita på det självsignerade certifikatet

Om du vill åsidosätta den säkra standardinställningen för OLEDB-providern 19 och ange trust_distributor_certificate=yes så att distributören litar på det självsignerade certifikatet använder du följande exempel:

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

Anmärkning

Säkra standardvärden gäller den underliggande OLEDB-providern 19, vilket förbättrar säkerheten. Alternativet att åsidosätta standardinställningen är mindre säkert än att konfigurera din instans för att använda ett betrott certifikat. När du har åsidosättt standardinställningen har du möjlighet att konfigurera SQL Server att använda ett certifikat och sedan använda den sp_changedistributor_property lagrade proceduren för att ange trust_distributor_certificate=no egenskapen tillbaka till den säkra standardinställningen.

Mer information finns i fjärrdistributörens icke-bakåtkompatibla ändring i SQL Server 2025 Preview.

Permissions

Endast medlemmar i den fasta serverrollen sysadmin kan köra sp_changedistributor_property.

Relaterat innehåll