DistributionDatabase Klasse

Definition

Repräsentiert eine Vertriebsdatenbank beim Verteiler.

public ref class DistributionDatabase sealed : Microsoft::SqlServer::Replication::ReplicationObject
public sealed class DistributionDatabase : Microsoft.SqlServer.Replication.ReplicationObject
type DistributionDatabase = class
    inherit ReplicationObject
Public NotInheritable Class DistributionDatabase
Inherits ReplicationObject
Vererbung
DistributionDatabase

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

Threadsicherheit

Alle öffentlichen statischen (Shared in Microsoft Visual Basic) Mitglieder dieses Typs sind für Multithread-Operationen sicher. Instanzenmitglieder sind nicht garantiert threadsicher.

Konstruktoren

Name Beschreibung
DistributionDatabase()

Erstellt eine neue Instanz der DistributionDatabase Klasse.

DistributionDatabase(String, ServerConnection)

Erstellt eine neue Instanz der DistributionDatabase Klasse mit dem angegebenen Datenbanknamen und einer Verbindung zum Distributor.

Eigenschaften

Name Beschreibung
CachePropertyChanges

Es gibt oder setzt, ob Änderungen an den Replikationseigenschaften zwischengespeichert oder sofort angewendet werden.

(Geerbt von ReplicationObject)
ConnectionContext

Erhält oder setzt die Verbindung zu einer Instanz von Microsoft SQL Server.

(Geerbt von ReplicationObject)
DataFile

Erhält oder setzt den Namen der Datendatei für die Verteilungsdatenbank.

DataFileSize

Erhält oder setzt die Größe der primären Datenbankdatei für die Verteilungsdatenbank.

DataFolder

Erhält oder setzt den Pfad zu dem Verzeichnis, das die Datendatei für die Verteilungsdatenbank enthält.

DistributionCleanupTaskName

Erhält den Namen des SQL Server-Agent-Jobs, der für die Bereinigung der Replikationstabellen in der Distribution verantwortlich ist.

DistributorSecurity

Erhält den Sicherheitskontext, der zur Verbindung mit dem Distributor verwendet wird, um die Verteilungsdatenbank zu erstellen.

HistoryCleanupTaskName

Erhält den Namen des SQL Server-Agent-Jobs, der für die Bereinigung von Replikationsverlauftabellen verantwortlich ist.

HistoryRetention

Erhält oder legt die Zeitspanne, in Stunden fest, in denen die Historikdaten des Replikationsagenten gespeichert werden sollen.

IsExistingObject

Es bekommt, ob das Objekt auf dem Server existiert oder nicht.

(Geerbt von ReplicationObject)
LogFile

Erhält oder setzt den Namen der Datei, die Datenbanktransaktionsprotokolle speichert.

LogFileSize

Erhält oder legt die Größe der Datei fest, die Datenbanktransaktionsprotokolle speichert.

LogFolder

Erhält oder setzt den Pfad zu dem Verzeichnis, in dem sich die Datei befindet, die Datenbanktransaktionsprotokolle speichert.

MaxDistributionRetention

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

MinDistributionRetention

Erhält oder legt die Mindestaufbewahrungszeit in Stunden fest, bevor Transaktionen aus der Verteilungsdatenbank gelöscht werden.

Name

Erhält oder setzt den Namen der Verteilungsdatenbank.

QueueReaderAgentExists

Erhält oder setzt, ob der Job Queue Reader Agent für diese Verteilungsdatenbank erstellt wurde.

QueueReaderAgentName

Erhält oder setzt den Namen des Queue Reader Agent-Jobs, der für diese Verteilungsdatenbank erstellt wurde.

QueueReaderAgentProcessSecurity

Erhält den Sicherheitskontext für den Agentenprozess, um den Queue Reader Agent-Job auszuführen.

SqlServerName

Erhält den Namen der Microsoft SQL Server-Instanz, mit der dieses Objekt verbunden ist.

(Geerbt von ReplicationObject)
UserData

Erhält oder setzt eine Objekt-Eigenschaft, die es Nutzern erlaubt, eigene Daten an das Objekt anzuhängen.

(Geerbt von ReplicationObject)

Methoden

Name Beschreibung
CheckValidCreation()

Prüft die gültige Replikationserstellung.

(Geerbt von ReplicationObject)
CheckValidDefinition(Boolean)

Gibt an, ob die Definition gültig ist.

(Geerbt von ReplicationObject)
CleanUpAnonymousSubscription(Int32, PublicationType)

Entfernt Metadaten für anonyme Abonnements beim Distributor.

CommitPropertyChanges()

Sendet alle zwischengespeicherten Property-Change-Anweisungen an die Instanz von Microsoft SQL Server.

(Geerbt von ReplicationObject)
Create()

Erstellt die Vertriebsdatenbank.

CreateQueueReaderAgent()

Erstellt den Job Queue Reader Agent in der Verteilungsdatenbank.

Decouple()

Entkoppelt das referenzierte Replikationsobjekt vom Server.

(Geerbt von ReplicationObject)
GetChangeCommand(StringBuilder, String, String)

Gibt den Änderungsbefehl aus der Replikation zurück.

(Geerbt von ReplicationObject)
GetCreateCommand(StringBuilder, Boolean, ScriptOptions)

Gibt den Create-Befehl aus der Replikation zurück.

(Geerbt von ReplicationObject)
GetDropCommand(StringBuilder, Boolean)

Gibt den Drop-Befehl aus der Replikation zurück.

(Geerbt von ReplicationObject)
InternalRefresh(Boolean)

Führt eine interne Aktualisierung aus der Replikation ein.

(Geerbt von ReplicationObject)
Load()

Lädt die Eigenschaften eines bestehenden Objekts vom Server.

(Geerbt von ReplicationObject)
LoadProperties()

Lädt die Eigenschaften eines bestehenden Objekts vom Server.

(Geerbt von ReplicationObject)
Refresh()

Lädt die Eigenschaften des Objekts neu.

(Geerbt von ReplicationObject)
RegisterBusinessLogicHandler(BusinessLogicHandler)

Registriert eine Business Logic Handler-Assembly beim Verteiler.

Remove()

Löscht die Verteilungsdatenbank.

Script(ScriptOptions)

Erzeugt ein Transact-SQL-Skript, das verwendet werden kann, um die Verteilungsdatenbank, die das Objekt repräsentiert, zu erstellen oder zu löschen.

UnregisterBusinessLogicHandler(BusinessLogicHandler)

Entzieht die Registrierung für einen Business Logic Handler aus dem Distributor.

Gilt für:

Weitere Informationen