Sprache

DistributionDatabase.MaxDistributionRetention Eigenschaft

Definition

Namespace:
Microsoft.SqlServer.Replication
Assembly:
Microsoft.SqlServer.Rmo.dll

Erhält oder setzt die maximale Aufbewahrungszeit in Stunden, bevor Transaktionen aus der Verteilungsdatenbank gelöscht werden.

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 Wert Int32 .

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 Eigenschaft MaxDistributionRetention legt die maximale Aufbewahrungsdauer fest, bevor Transaktionen gelöscht werden. Abonnements, die noch keine replizierten Befehle erhalten haben, die älter als die maximale Verteilungsaufbewahrungszeit sind, werden als inaktiv markiert.

Die Eigenschaft MaxDistributionRetention kann nur von Mitgliedern der oder der db_ownerreplmonitor festen Datenbankrolle in der Verteilungsdatenbank, von Benutzern in der Publikationszugriffsliste (PAL) einer Publikation über die Verteilungsdatenbank oder von Benutzern mit SELECT-Berechtigung in der MSdistributiondbs-Systemtabelle in der Verteilungsdatenbank abgerufen werden.

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

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

Das Setzen der MaxDistributionRetention Eigenschaft ist gleichbedeutend mit der Ausführung von sp_adddistributiondb oder sp_changedistributiondb.

Gilt für:

Weitere Informationen