DistributionDatabase Classe

Riferimento

Definizione

Spazio dei nomi:: Microsoft.SqlServer.Replication

Assembly:: Microsoft.SqlServer.Rmo.dll

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à: Object

ReplicationObject
DistributionDatabase

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.

Si applica a