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