sp_changedistpublisher (Transact-SQL)

Artikel
2025-01-02

Gilt für: SQL Server Azure SQL Managed Instance

Ändert die Eigenschaften des Verteilungsverlegers. Diese gespeicherte Prozedur wird beim Distributor auf einer beliebigen Datenbank ausgeführt.

Transact-SQL-Syntaxkonventionen

Syntax

sp_changedistpublisher
    [ @publisher = ] N'publisher'
    [ , [ @property = ] N'property' ]
    [ , [ @value = ] N'value' ]
[ ; ]

Argumente

[ @publisher = ] N'publisher'

Der Herausgebername. @publisher ist "sysname" ohne Standard.

[ @property = ] N'property'

Eine Eigenschaft, die für den angegebenen Publisher geändert werden soll. @property ist "sysname" und kann eine der Eigenschaften in der Tabelle sein, die unter @value aufgeführt ist.

[ @value = ] N'value'

Der Wert für die angegebene Eigenschaft. @value ist nvarchar(255) und kann einer der Werte in der folgenden Tabelle sein.

Hinweis

Publisher- und Distributordatenbanken auf Azure SQL-Datenbank erfordern SQL-verwaltete Instanz. Weitere Informationen finden Sie unter Replikation mit Azure SQL-Datenbank.

Diese Tabelle beschreibt die Eigenschaften von Verlegern und die Werte für diese Eigenschaften.

Eigenschaft	Werte	Beschreibung
`active`	`true`	Aktiviert den Verleger
	`false`	Deaktiviert den Verleger
`distribution_db`		Der Name der Verteilungsdatenbank.
`login`		Benutzername
`password`		Sicheres Kennwort für den angegebenen Anmeldenamen.
`security_mode` ¹	`1`	Verwendung der Windows-Authentifizierung für die Verbindung mit dem Verleger.
	`0`	Verwenden Sie die SQL Server-Authentifizierung beim Herstellen einer Verbindung mit dem Publisher.
`working_directory`		Das zum Speichern von Daten- und Schemadateien für die Veröffentlichung verwendete Arbeitsverzeichnis
`NULL` (Standard)		Alle verfügbaren Eigenschaftenoptionen werden gedruckt.
`storage_connection_string`	Zugangsschlüssel	Der Zugriffsschlüssel für das Arbeitsverzeichnis, wenn die Datenbank Azure SQL verwaltete Instanz ist.

¹ Dies kann für einen Nicht-SQL Server-Herausgeber nicht geändert werden.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Hinweise

sp_changedistpublisher wird in allen Replikationstypen verwendet.

Wenn Sie die working_directory Eigenschaft ändern und die storage_connection_string Eigenschaft aktualisiert werden muss, führen Sie die gespeicherte Prozedur separat aus, indem Sie die working_directory Eigenschaft aktualisieren, gefolgt von der Aktualisierung der storage_connection_string Eigenschaft oder umgekehrt.

Berechtigungen

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

Freigeben über