DistributionDatabase Klasse

Definition

Stellt eine Verteilungsdatenbank beim Verteiler dar.

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) Member dieses Typs sind für Multithreadvorgänge sicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Konstruktoren

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 mit dem Verteiler.

Eigenschaften

CachePropertyChanges

Ruft ab oder legt fest, ob Änderungen an den Replikationseigenschaften zwischengespeichert oder sofort angewendet werden sollen.

(Geerbt von ReplicationObject)
ConnectionContext

Ruft die Verbindung mit einer Instanz von Microsoft SQL Server ab oder legt sie fest.

(Geerbt von ReplicationObject)
DataFile

Ruft den Namen der Datendatei für die Verteilungsdatenbank ab oder legt ihn fest.

DataFileSize

Ruft die Größe der primären Datenbankdatei für die Verteilungsdatenbank ab oder legt sie fest.

DataFolder

Ruft den Pfad zum Verzeichnis ab, das die Datendatei für die Verteilungsdatenbank enthält, oder legt ihn fest.

DistributionCleanupTaskName

Ruft den Namen des SQL Server-Agent Auftrags ab, der für das Bereinigen der Replikationstabellen in der Verteilung verantwortlich ist.

DistributorSecurity

Ruft den Sicherheitskontext ab, der zum Herstellen einer Verbindung mit dem Verteiler verwendet wird, um die Verteilungsdatenbank zu erstellen.

HistoryCleanupTaskName

Ruft den Namen des SQL Server-Agent Auftrags ab, der für das Bereinigen von Replikationsverlaufstabellen verantwortlich ist.

HistoryRetention

Ruft die Zeit in Stunden ab, für die Replikations-Agentverlaufsdaten beibehalten werden sollen, oder legt sie fest.

IsExistingObject

Ruft ab, ob das Objekt auf dem Server vorhanden ist.

(Geerbt von ReplicationObject)
LogFile

Ruft den Namen der Datei ab, in der Datenbank-Transaktionsprotokoll-Datensätze gespeichert werden, oder legt ihn fest.

LogFileSize

Ruft die Größe der Datei ab, in der Datenbank-Transaktionsprotokoll-Datensätze gespeichert werden, oder legt sie fest.

LogFolder

Ruft den Pfad zu dem Verzeichnis ab, in dem sich die Datei befindet, in der Datenbank-Transaktionsprotokoll-Datensätze gespeichert werden, oder legt ihn fest.

MaxDistributionRetention

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

MinDistributionRetention

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

Name

Ruft den Namen der Verteilungsdatenbank ab oder legt diesen fest.

QueueReaderAgentExists

Ruft ab oder legt fest, ob der Warteschlangenlese-Agentauftrag für diese Verteilungsdatenbank erstellt wurde.

QueueReaderAgentName

Ruft den Namen des für diese Verteilungsdatenbank erstellten Warteschlangenlese-Agentauftrags ab oder legt ihn fest.

QueueReaderAgentProcessSecurity

Ruft den Agent-Prozesssicherheitskontext zum Ausführen des Warteschlangenlese-Agentauftrags ab.

SqlServerName

Ruft den Namen der Microsoft SQL Server-Instanz ab, mit der dieses Objekt verbunden ist.

(Geerbt von ReplicationObject)
UserData

Ruft eine Objekteigenschaft ab, die es Benutzern ermöglicht, ihre eigenen Daten an das Objekt anzufügen, oder legt sie fest.

(Geerbt von ReplicationObject)

Methoden

CheckValidCreation()

Überprüft, ob die Replikationserstellung gültig ist.

(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 Verteiler.

CommitPropertyChanges()

Sendet alle zwischengespeicherten Eigenschaftsänderungsanweisungen an die Instanz von Microsoft SQL Server.

(Geerbt von ReplicationObject)
Create()

Erstellt die Verteilungsdatenbank.

CreateQueueReaderAgent()

Erstellt den Warteschlangenlese-Agent-Auftrag auf der Verteilerdatenbank.

Decouple()

Entkoppelt das Replikationsobjekt, auf das verwiesen wird, vom Server.

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

Gibt den Änderungsbefehl von der Replikation zurück.

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

Gibt den Erstellungsbefehl von der Replikation zurück.

(Geerbt von ReplicationObject)
GetDropCommand(StringBuilder, Boolean)

Gibt den Löschbefehl von der Replikation zurück.

(Geerbt von ReplicationObject)
InternalRefresh(Boolean)

Initiiert eine interne Aktualisierung von der Replikation.

(Geerbt von ReplicationObject)
Load()

Lädt die Eigenschaften eines vorhandenen Objekts vom Server.

(Geerbt von ReplicationObject)
LoadProperties()

Lädt die Eigenschaften eines vorhandenen Objekts vom Server.

(Geerbt von ReplicationObject)
Refresh()

Lädt die Eigenschaften des Objekts erneut.

(Geerbt von ReplicationObject)
RegisterBusinessLogicHandler(BusinessLogicHandler)

Registriert eine Geschäftslogikhandler-Assembly beim Verteiler.

Remove()

Löscht die Verteilungsdatenbank.

Script(ScriptOptions)

Generiert ein Transact-SQL-Skript, das zum Erstellen oder Löschen der Verteilungsdatenbank verwendet werden kann, die das Objekt darstellt.

UnregisterBusinessLogicHandler(BusinessLogicHandler)

Entfernt die Registrierung für einen Geschäftslogikhandler aus dem Verteiler.

Gilt für:

Weitere Informationen