Delen via

sp_changedistributor_property (Transact-SQL)

Van toepassing op:SQL ServerAzure SQL Managed Instance

Hiermee wijzigt u de eigenschappen van de distributeur. Deze opgeslagen procedure wordt uitgevoerd bij de Distributeur op elke database. Voor externe distributeurs moet deze opgeslagen procedure worden uitgevoerd op alle Publisher-servers die verbinding maken met de externe distributeur.

Als de distributie- of Publisher-database zich in een beschikbaarheidsgroep bevindt, moet de opgeslagen procedure worden uitgevoerd op alle knooppunten Distributeur en Publisher, ongeacht hun huidige rol in de beschikbaarheidsgroep.

Transact-SQL syntaxis-conventies

Syntaxis

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

Arguments

[ @property = ] N'eigenschap'

De accommodatie voor een bepaalde distributeur. @propertysysname is en kan een van deze waarden zijn:

Naam van de eigenschap Acceptabele waarden Description
heartbeat_interval Elke int-waarde (in minuten) Maximum aantal minuten dat een agent kan worden uitgevoerd zonder een voortgangsbericht te registreren. @heartbeat_interval is int, met een standaardwaarde van 10 minuten.
encrypt_distributor_connection mandatory, , optionalstrict, true, , false, , yesno Hiermee geeft u het versleutelingstype tussen de distributeur en andere replicatieonderdelen.

Van toepassing op: SQL Server 2025 (17.x) Preview en latere versies.
trust_distributor_certificate yes, no Hiermee geeft u op of het certificaat dat door de distributeur wordt gebruikt voor versleutelde verbindingen moet worden vertrouwd. De standaardwaarde is no.

Van toepassing op: SQL Server 2025 (17.x) Preview en latere versies.
host_name_in_distributor_certificate Elke tekenreeks Hiermee geeft u de verwachte hostnaam in het certificaat van de distributeur.

Van toepassing op: SQL Server 2025 (17.x) Preview en latere versies.
NULL (standaard) Alle beschikbare @property waarden worden afgedrukt.

Opmerking

Veilige standaardinstellingen hebben betrekking op de onderliggende OLEDB-provider 19, waardoor de beveiliging wordt verbeterd. De optie voor het overschrijven van de standaardwaarde is minder veilig dan het configureren van uw exemplaar voor het gebruik van een vertrouwd certificaat. Nadat u de standaardwaarde hebt overschreven, kunt u SQL Server configureren voor het gebruik van een certificaat en vervolgens de sp_changedistributor_property opgeslagen procedure gebruiken om de trust_distributor_certificate=no eigenschap weer in te stellen op de beveiligde standaardwaarde.

[ @value = ] N'waarde'

De waarde voor de opgegeven distributeureigenschap. @value is nvarchar(255), met een standaardwaarde van NULL.

Codewaarden retourneren

0 (geslaagd) of 1 (mislukt).

Opmerkingen

sp_changedistributor_property wordt gebruikt in alle typen replicatie.

Voorbeelden


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

Distributeur configureren om het zelfondertekende certificaat te vertrouwen

Gebruik het volgende voorbeeld om de veilige standaardwaarde van de OLEDB-provider 19 te overschrijven en zo in te stellen trust_distributor_certificate=yes dat de distributeur het zelfondertekende certificaat vertrouwt:

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

Opmerking

Veilige standaardinstellingen hebben betrekking op de onderliggende OLEDB-provider 19, waardoor de beveiliging wordt verbeterd. De optie voor het overschrijven van de standaardwaarde is minder veilig dan het configureren van uw exemplaar voor het gebruik van een vertrouwd certificaat. Nadat u de standaardwaarde hebt overschreven, kunt u SQL Server configureren voor het gebruik van een certificaat en vervolgens de sp_changedistributor_property opgeslagen procedure gebruiken om de trust_distributor_certificate=no eigenschap weer in te stellen op de beveiligde standaardwaarde.

Raadpleeg voor meer informatie de belangrijke wijziging voor externe distributeur in SQL Server 2025 Preview.

Permissions

Alleen leden van de vaste serverrol sysadmin kunnen worden uitgevoerd sp_changedistributor_property.

Verwante inhoud