DistributionDatabase Classe

Définition

Représente une base de données de distribution au niveau du serveur de distribution.

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
Héritage
DistributionDatabase

Exemples

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

Remarques

Cohérence de thread

Tous les membres statiques publics (Shared dans Microsoft Visual Basic) de ce type sont sécurisés pour les opérations multithread. Tous les membres de l'instance ne sont pas garantis comme étant thread-safe.

Constructeurs

DistributionDatabase()

Crée une instance de la classe DistributionDatabase.

DistributionDatabase(String, ServerConnection)

Crée une nouvelle instance de la classe DistributionDatabase avec le nom spécifié de la base de données et une connexion au serveur de distribution.

Propriétés

CachePropertyChanges

Obtient ou définit s'il faut mettre en cache des modifications effectuées sur les propriétés de réplication ou les appliquer immédiatement.

(Hérité de ReplicationObject)
ConnectionContext

Obtient ou définit la connexion à une instance de Microsoft SQL Server.

(Hérité de ReplicationObject)
DataFile

Obtient ou définit le nom du fichier de données pour la base de données de distribution.

DataFileSize

Obtient ou définit la taille du fichier de base de données primaire pour la base de données de distribution.

DataFolder

Obtient ou définit le chemin d'accès au répertoire qui contient le fichier de données pour la base de données de distribution.

DistributionCleanupTaskName

Obtient le nom du travail SQL Server Agent chargé de nettoyer les tables de réplication dans la distribution.

DistributorSecurity

Obtient le contexte de sécurité utilisé pour la connexion au serveur de distribution pour créer la base de données de distribution.

HistoryCleanupTaskName

Obtient le nom du travail SQL Server Agent chargé de nettoyer les tables d’historique de réplication.

HistoryRetention

Obtient ou définit la durée en heures pendant laquelle les données d'historique de l'agent de réplication doivent être conservées.

IsExistingObject

Détermine si l'objet existe ou non sur le serveur.

(Hérité de ReplicationObject)
LogFile

Obtient ou définit le nom du fichier qui stocke les enregistrements du journal des transactions de la base de données.

LogFileSize

Obtient ou définit la taille du fichier qui stocke les enregistrements du journal des transactions de la base de données.

LogFolder

Obtient ou définit le chemin d'accès au répertoire où se trouve le fichier qui stocke les enregistrements du journal des transactions de la base de données.

MaxDistributionRetention

Obtient ou définit la période de rétention maximale, en heures, avant que les transactions soient supprimées de la base de données de distribution.

MinDistributionRetention

Obtient ou définit la période de rétention minimale, en heures, avant que les transactions soient supprimées de la base de données de distribution.

Name

Obtient ou définit le nom de la base de données de distribution.

QueueReaderAgentExists

Obtient ou définit si le travail de l'Agent de lecture de file d'attente a été créé pour cette base de données de distribution.

QueueReaderAgentName

Obtient ou définit le nom du travail de l'Agent de lecture de file d'attente créé pour cette base de données de distribution.

QueueReaderAgentProcessSecurity

Obtient le contexte de sécurité du processus de l'agent pour l'exécution du travail de l'Agent de lecture de file d'attente.

SqlServerName

Obtient le nom de l’instance Microsoft SQL Server à laquelle cet objet est connecté.

(Hérité de ReplicationObject)
UserData

Obtient ou définit une propriété d'objet qui permet aux utilisateurs d'attacher leurs propres données à l'objet.

(Hérité de ReplicationObject)

Méthodes

CheckValidCreation()

Vérifie la création de la réplication valide.

(Hérité de ReplicationObject)
CheckValidDefinition(Boolean)

Indique si la définition est valide.

(Hérité de ReplicationObject)
CleanUpAnonymousSubscription(Int32, PublicationType)

Supprime des métadonnées pour les abonnements anonymes au serveur de distribution.

CommitPropertyChanges()

Envoie toutes les instructions de modification de propriété mises en cache à l’instance de Microsoft SQL Server.

(Hérité de ReplicationObject)
Create()

Crée la base de données de distribution.

CreateQueueReaderAgent()

Crée le travail de l'Agent de lecture de la file d'attente sur la base de données de distribution.

Decouple()

Dissocie l'objet de réplication référencé du serveur.

(Hérité de ReplicationObject)
GetChangeCommand(StringBuilder, String, String)

Retourne la commande de modification de la réplication.

(Hérité de ReplicationObject)
GetCreateCommand(StringBuilder, Boolean, ScriptOptions)

Retourne la commande de création de la réplication.

(Hérité de ReplicationObject)
GetDropCommand(StringBuilder, Boolean)

Retourne la commande de suppression de la réplication.

(Hérité de ReplicationObject)
InternalRefresh(Boolean)

Initialise une actualisation interne de la réplication.

(Hérité de ReplicationObject)
Load()

Charge les propriétés d'un objet existant à partir du serveur.

(Hérité de ReplicationObject)
LoadProperties()

Charge les propriétés d'un objet existant à partir du serveur.

(Hérité de ReplicationObject)
Refresh()

Recharge les propriétés de l'objet.

(Hérité de ReplicationObject)
RegisterBusinessLogicHandler(BusinessLogicHandler)

Inscrit un assembly de gestionnaire de logique métier sur le serveur de distribution.

Remove()

Supprime la base de données de distribution.

Script(ScriptOptions)

Génère un script Transact-SQL qui peut être utilisé pour créer ou supprimer la base de données de distribution que l’objet représente.

UnregisterBusinessLogicHandler(BusinessLogicHandler)

Supprime l'inscription d'un gestionnaire de logique métier du serveur de distribution.

S’applique à

Voir aussi