sp_changedistributiondb (Transact-SQL)

Artikel
2025-01-02

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 = ] N'database'
    [ , [ @property = ] N'property' ]
    [ , [ @value = ] N'value' ]
[ ; ]

Argumente

[ @database = ] N'datenbank'

Der Name der Verteilungsdatenbank. @database ist "sysname" ohne Standard.

[ @property = ] N'property'

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 @property Werte werden gedruckt.

[ @value = ] N'value'

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

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Hinweise

sp_changedistributiondb wird in allen Replikationstypen verwendet.

Beispiele

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 ausgeführt werden sp_changedistributiondb.

Freigeben über