DistributionDatabase Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Rappresenta un database di distribuzione nel server di distribuzione.
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
- Ereditarietà
Esempio
// 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
Commenti
Thread safety
Tutti i membri statici pubblici (Shared
in Microsoft Visual Basic) di questo tipo sono sicuri per le operazioni multithreading. Non è invece garantita la sicurezza dei membri dell'istanza.
Costruttori
DistributionDatabase() |
Crea una nuova istanza della classe DistributionDatabase. |
DistributionDatabase(String, ServerConnection) |
Crea una nuova istanza della classe DistributionDatabase con il nome del database specificato e una connessione al server di distribuzione. |
Proprietà
CachePropertyChanges |
Ottiene o imposta un valore che indica se memorizzare nella cache o se applicare immediatamente le modifiche apportate alle proprietà di replica. (Ereditato da ReplicationObject) |
ConnectionContext |
Ottiene o imposta la connessione a un'istanza di Microsoft SQL Server. (Ereditato da ReplicationObject) |
DataFile |
Ottiene o imposta il nome del file di dati per il database di distribuzione. |
DataFileSize |
Ottiene o imposta le dimensioni del file di database primario per il database di distribuzione. |
DataFolder |
Ottiene o imposta il percorso della directory che contiene il file di dati per il database di distribuzione. |
DistributionCleanupTaskName |
Ottiene il nome del processo SQL Server Agent responsabile della pulizia delle tabelle di replica nella distribuzione. |
DistributorSecurity |
Ottiene il contesto di sicurezza utilizzato per la connessione al server di distribuzione per creare il database di distribuzione. |
HistoryCleanupTaskName |
Ottiene il nome del processo SQL Server Agent responsabile della pulizia delle tabelle della cronologia di replica. |
HistoryRetention |
Ottiene o imposta la durata, espressa in ore, di memorizzazione dei dati di cronologia dell'agente di replica. |
IsExistingObject |
Ottiene un valore che indica se l'oggetto esiste nel server. (Ereditato da ReplicationObject) |
LogFile |
Ottiene o imposta il nome del file in cui vengono archiviati i record del log delle transazioni del database. |
LogFileSize |
Ottiene o imposta le dimensioni del file in cui vengono archiviati i record del log delle transazioni del database. |
LogFolder |
Ottiene o imposta il percorso della directory contenente il file in cui vengono archiviati i record del log delle transazioni del database. |
MaxDistributionRetention |
Ottiene o imposta il periodo di memorizzazione massimo, espresso in ore, che deve trascorrere prima dell'eliminazione delle transazioni dal database di distribuzione. |
MinDistributionRetention |
Ottiene o imposta il periodo di memorizzazione minimo, espresso in ore, che deve trascorrere prima dell'eliminazione delle transazioni dal database di distribuzione. |
Name |
Ottiene o imposta il nome del database di distribuzione. |
QueueReaderAgentExists |
Ottiene o imposta un valore che indica se il processo dell'agente di lettura coda è stato creato per questo database di distribuzione. |
QueueReaderAgentName |
Ottiene o imposta il nome del processo dell'agente di lettura coda creato per questo database di distribuzione. |
QueueReaderAgentProcessSecurity |
Ottiene il contesto di sicurezza del processo dell'agente per l'esecuzione del processo dell'agente di lettura coda. |
SqlServerName |
Ottiene il nome dell'istanza di Microsoft SQL Server a cui è connesso questo oggetto. (Ereditato da ReplicationObject) |
UserData |
Ottiene o imposta una proprietà di un oggetto che consente agli utenti di collegare i relativi dati all'oggetto in questione. (Ereditato da ReplicationObject) |
Metodi
CheckValidCreation() |
Controlla la creazione della replica valida. (Ereditato da ReplicationObject) |
CheckValidDefinition(Boolean) |
Indica se la definizione è valida. (Ereditato da ReplicationObject) |
CleanUpAnonymousSubscription(Int32, PublicationType) |
Rimuove i metadati per le sottoscrizioni anonime nel server di distribuzione. |
CommitPropertyChanges() |
Invia tutte le istruzioni di modifica delle proprietà memorizzate nella cache all'istanza di Microsoft SQL Server. (Ereditato da ReplicationObject) |
Create() |
Crea il database di distribuzione. |
CreateQueueReaderAgent() |
Crea il processo dell'agente di lettura coda nel database di distribuzione. |
Decouple() |
Disaccoppia dal server l'oggetto di replica a cui si fa riferimento. (Ereditato da ReplicationObject) |
GetChangeCommand(StringBuilder, String, String) |
Restituisce il comando di modifica dalla replica. (Ereditato da ReplicationObject) |
GetCreateCommand(StringBuilder, Boolean, ScriptOptions) |
Restituisce il comando di creazione dalla replica. (Ereditato da ReplicationObject) |
GetDropCommand(StringBuilder, Boolean) |
Restituisce il comando di eliminazione dalla replica. (Ereditato da ReplicationObject) |
InternalRefresh(Boolean) |
Avvia un aggiornamento interno dalla replica. (Ereditato da ReplicationObject) |
Load() |
Carica le proprietà di un oggetto esistente dal server. (Ereditato da ReplicationObject) |
LoadProperties() |
Carica le proprietà di un oggetto esistente dal server. (Ereditato da ReplicationObject) |
Refresh() |
Ricarica le proprietà dell'oggetto. (Ereditato da ReplicationObject) |
RegisterBusinessLogicHandler(BusinessLogicHandler) |
Registra un assembly del gestore della logica di business nel server di distribuzione. |
Remove() |
Elimina il database di distribuzione. |
Script(ScriptOptions) |
Genera uno script Transact-SQL che può essere utilizzato per creare o eliminare il database di distribuzione rappresentato dall'oggetto. |
UnregisterBusinessLogicHandler(BusinessLogicHandler) |
Rimuove la registrazione per un gestore della logica di business dal server di distribuzione. |