Teilen über


sp_changedistributor_property (Transact-SQL)

Gilt für:SQL ServerAzure SQL Managed Instance

Ändert die Eigenschaften des Verteilers. Diese gespeicherte Prozedur wird beim Distributor auf einer beliebigen Datenbank ausgeführt. Für Remotehändler muss diese gespeicherte Prozedur auf allen Publisher-Servern ausgeführt werden, die eine Verbindung mit dem Remoteverteiler herstellen.

Wenn sich die Verteilungs- oder Publisher-Datenbank in einer Verfügbarkeitsgruppe befindet, muss die gespeicherte Prozedur auf allen Verteiler- und Publisher-Knoten ausgeführt werden, unabhängig von ihrer aktuellen Rolle in der Verfügbarkeitsgruppe.

Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

[ @property = ] N'property'

Die Eigenschaft für einen bestimmten Distributor. @property ist "sysname" und kann einer der folgenden Werte sein:

Eigenschaftsname Zulässige Werte Beschreibung
heartbeat_interval Beliebiger Int-Wert (in Minuten) Maximale Anzahl von Minuten, die ein Agent ausführen kann, ohne eine Statusmeldung zu protokollieren. @heartbeat_interval ist "int" mit einer Standardeinstellung von 10 Minuten.
encrypt_distributor_connection mandatory, , optionalstrict, true, false, , yesno Gibt den Verschlüsselungstyp zwischen dem Distributor und anderen Replikationskomponenten an.

Gilt für: SQL Server 2025 (17.x) und höhere Versionen.
trust_distributor_certificate yes, no Gibt an, ob dem Zertifikat vertraut werden soll, das vom Distributor für verschlüsselte Verbindungen verwendet wird. Der Standardwert lautet no.

Gilt für: SQL Server 2025 (17.x) und höhere Versionen.
host_name_in_distributor_certificate Beliebige Zeichenfolge Gibt den erwarteten Hostnamen im Zertifikat des Distributors an.

Gilt für: SQL Server 2025 (17.x) und höhere Versionen.
NULL (Standard) Alle verfügbaren @property Werte werden gedruckt.

Hinweis

Sichere Standardwerte beziehen sich auf den zugrunde liegenden OLEDB-Anbieter 19, der die Sicherheit verbessert. Die Option zum Überschreiben des Standardwerts ist weniger sicher als das Konfigurieren Ihrer Instanz für die Verwendung eines vertrauenswürdigen Zertifikats. Nachdem Sie den Standardwert überschrieben haben, haben Sie die Möglichkeit, SQL Server für die Verwendung eines Zertifikats zu konfigurieren, und verwenden Sie dann die gespeicherte sp_changedistributor_property Prozedur, um die trust_distributor_certificate=no Eigenschaft wieder auf den sicheren Standardwert festzulegen.

[ @value = ] N'value'

Der Wert für die angegebene Distributor-Eigenschaft. @value ist nvarchar(255), mit einem Standardwert von NULL.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Hinweise

sp_changedistributor_property wird in allen Replikationstypen verwendet.

Beispiele


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

Konfigurieren des Distributors, um dem selbstsignierten Zertifikat zu vertrauen

Um den sicheren Standardwert des OLEDB-Anbieters 19 außer Kraft zu setzen und so festzulegen trust_distributor_certificate=yes , dass der Distributor dem selbstsignierten Zertifikat vertraut, verwenden Sie das folgende Beispiel:

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

Hinweis

Sichere Standardwerte beziehen sich auf den zugrunde liegenden OLEDB-Anbieter 19, der die Sicherheit verbessert. Die Option zum Überschreiben des Standardwerts ist weniger sicher als das Konfigurieren Ihrer Instanz für die Verwendung eines vertrauenswürdigen Zertifikats. Nachdem Sie den Standardwert überschrieben haben, haben Sie die Möglichkeit, SQL Server für die Verwendung eines Zertifikats zu konfigurieren, und verwenden Sie dann die gespeicherte sp_changedistributor_property Prozedur, um die trust_distributor_certificate=no Eigenschaft wieder auf den sicheren Standardwert festzulegen.

Weitere Informationen finden Sie in SQL Server 2025 in der Änderung der Remote-Distributoren.

Berechtigungen

Nur Mitglieder der festen Serverrolle sysadmin können ausgeführt werden sp_changedistributor_property.