DistributionDatabase.MaxDistributionRetention Eigenschaft

Referenz

Definition

Namespace:: Microsoft.SqlServer.Replication

Assembly:: Microsoft.SqlServer.Rmo.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft die maximale Beibehaltungsdauer in Stunden ab, bevor Transaktionen aus der Verteilungsdatenbank gelöscht werden, oder legt sie fest.

public:
 property int MaxDistributionRetention { int get(); void set(int value); };

public int MaxDistributionRetention { get; set; }

member this.MaxDistributionRetention : int with get, set

Public Property MaxDistributionRetention As Integer

Eigenschaftswert

Int32

Ein Int32-Wert.

Beispiele

// Set the server and database names
string distributionDbName = "distribution";
string publisherName = publisherInstance;
string publicationDbName = "AdventureWorks2012";

DistributionDatabase distributionDb;
ReplicationServer distributor;
DistributionPublisher publisher;
ReplicationDatabase publicationDb;

// Create a connection to the server using Windows Authentication.
ServerConnection conn = new ServerConnection(publisherName);

try
{
    // Connect to the server acting as the Distributor 
    // and local Publisher.
    conn.Connect();

    // Define the distribution database at the Distributor,
    // but do not create it now.
    distributionDb = new DistributionDatabase(distributionDbName, conn);
    distributionDb.MaxDistributionRetention = 96;
    distributionDb.HistoryRetention = 120;

    // Set the Distributor properties and install the Distributor.
    // This also creates the specified distribution database.
    distributor = new ReplicationServer(conn);
    distributor.InstallDistributor((string)null, distributionDb);

    // Set the Publisher properties and install the Publisher.
    publisher = new DistributionPublisher(publisherName, conn);
    publisher.DistributionDatabase = distributionDb.Name;
    publisher.WorkingDirectory = @"\\" + publisherName + @"\repldata";
    publisher.PublisherSecurity.WindowsAuthentication = true;
    publisher.Create();

    // Enable AdventureWorks2012 as a publication database.
    publicationDb = new ReplicationDatabase(publicationDbName, conn);

    publicationDb.EnabledTransPublishing = true;
    publicationDb.EnabledMergePublishing = true;
}
catch (Exception ex)
{
    // Implement appropriate error handling here.
    throw new ApplicationException("An error occured when installing distribution and publishing.", ex);
}
finally
{
    conn.Disconnect();
}

' Set the server and database names
Dim distributionDbName As String = "distribution"
Dim publisherName As String = publisherInstance
Dim publicationDbName As String = "AdventureWorks2012"

Dim distributionDb As DistributionDatabase
Dim distributor As ReplicationServer
Dim publisher As DistributionPublisher
Dim publicationDb As ReplicationDatabase

' Create a connection to the server using Windows Authentication.
Dim conn As ServerConnection = New ServerConnection(publisherName)

Try
    ' Connect to the server acting as the Distributor 
    ' and local Publisher.
    conn.Connect()

    ' Define the distribution database at the Distributor,
    ' but do not create it now.
    distributionDb = New DistributionDatabase(distributionDbName, conn)
    distributionDb.MaxDistributionRetention = 96
    distributionDb.HistoryRetention = 120

    ' Set the Distributor properties and install the Distributor.
    ' This also creates the specified distribution database.
    distributor = New ReplicationServer(conn)
    distributor.InstallDistributor((CType(Nothing, String)), distributionDb)

    ' Set the Publisher properties and install the Publisher.
    publisher = New DistributionPublisher(publisherName, conn)
    publisher.DistributionDatabase = distributionDb.Name
    publisher.WorkingDirectory = "\\" + publisherName + "\repldata"
    publisher.PublisherSecurity.WindowsAuthentication = True
    publisher.Create()

    ' Enable AdventureWorks2012 as a publication database.
    publicationDb = New ReplicationDatabase(publicationDbName, conn)

    publicationDb.EnabledTransPublishing = True
    publicationDb.EnabledMergePublishing = True

Catch ex As Exception
    ' Implement appropriate error handling here.
    Throw New ApplicationException("An error occured when installing distribution and publishing.", ex)

Finally
    conn.Disconnect()

End Try

Hinweise

Die MaxDistributionRetention -Eigenschaft gibt den maximalen Aufbewahrungszeitraum an, bevor Transaktionen gelöscht werden. Abonnements, die noch keine replizierten Befehle erhalten haben, die älter als der maximale Aufbewahrungszeitraum der Verteilung sind, werden als inaktiv markiert.

Die MaxDistributionRetention Eigenschaft kann nur von Mitgliedern der oder replmonitor festen db_owner Datenbankrolle in der Verteilungsdatenbank, von Benutzern in der Veröffentlichungszugriffsliste (PAL) einer Publikation mithilfe der Verteilungsdatenbank oder von Benutzern mit der SELECT-Berechtigung für die MSdistributiondbs-Systemtabelle in der Verteilungsdatenbank abgerufen werden.

Die MaxDistributionRetention Eigenschaft kann nur von Mitgliedern der sysadmin festen Serverrolle am Verteiler festgelegt werden.

Das Abrufen der MaxDistributionRetention Eigenschaft entspricht der Ausführung sp_helpdistributiondb.

Das Festlegen der MaxDistributionRetention Eigenschaft entspricht der Ausführung sp_adddistributiondb oder sp_changedistributiondb.

Gilt für:

Freigeben über