sp_changedistributiondb (Transact-SQL)

Ändert die Eigenschaften der Verteilungsdatenbank. Diese gespeicherte Prozedur wird auf dem Verteiler für jede Datenbank ausgeführt.

Themenlink (Symbol)Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

  • [ @database=] 'database'
    Der Name der Verteilungsdatenbank. database ist ein Wert vom Datentyp sysname und weist keinen Standardwert auf.

  • [ @property=] 'property'
    Die Eigenschaft, die für die angegebene Datenbank geändert werden soll. property ist ein Wert vom Datentyp sysname. Die folgenden Werte sind möglich.

    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 ausgegeben.

  • [ @value=] 'value'
    Der neue Wert der angegebenen Eigenschaft. value ist ein Wert vom Datentyp nvarchar(255), der Standardwert ist NULL.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_changedistributiondb wird für alle 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.