sp_changedistributiondb (Transact-SQL)

Artikel
12/22/2023

Gilt für:SQL Server Azure SQL Managed Instance

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

Transact-SQL-Syntaxkonventionen

Syntax

  
sp_changedistributiondb [ @database= ] 'database'   
    [ , [ @property= ] 'property' ]   
    [ , [ @value= ] 'value' ]

Argumente

[ @database = ] 'database' Ist der Name der Verteilungsdatenbank. Datenbank ist "sysname" ohne Standard.

[ @property = ] 'property' Ist die Eigenschaft, die für die angegebene Datenbank geändert werden soll. "property " ist "sysname" und kann einer dieser Werte sein.

Wert	Beschreibung
history_retention	Beibehaltungsdauer für die Verlaufstabelle.
max_distretention	Maximale Beibehaltungsdauer für die Verteilung.
min_distretention	Minimale Beibehaltungsdauer für die Verteilung.
NULL (Standard)	Alle verfügbaren Eigenschaftswerte werden gedruckt.

[ @value = ] 'value' Ist der neue Wert für die angegebene Eigenschaft. value is nvarchar(255), with a default of NULL.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_changedistributiondb wird in allen Replikationstypen verwendet.

Beispiel

DECLARE @distributionDB AS sysname;
SET @distributionDB = N'distribution';

-- Change the history retention period to 24 hours and the
-- maximum retention period to 48 hours.  
USE distribution
EXEC sp_changedistributiondb @distributionDB, N'history_retention', 24
EXEC sp_changedistributiondb @distributionDB, N'max_distretention', 48
GO

Berechtigungen

Nur Mitglieder der festen Serverrolle "sysadmin" können sp_changedistributiondb ausführen.

Weitere Informationen

Anzeigen und Ändern der Verteiler- und Verlegereigenschaften
sp_adddistributiondb (Transact-SQL)
sp_dropdistributiondb (Transact-SQL)
sp_helpdistributiondb (Transact-SQL)
Gespeicherte Replikationsprozeduren (Transact-SQL)