DistributionDatabase Klasse
Definition
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.
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
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. |