DistributionDatabase Clase

Definición

Representa una base de datos de distribución en el Distribuidor.

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
Herencia
DistributionDatabase

Ejemplos

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

Comentarios

Seguridad de hilos

Cualquier miembro público estático (Shareden Microsoft Visual Basic) de este tipo es seguro para operaciones multihilo. No se garantiza que los miembros de instancia sean seguros para el acceso concurrente.

Constructores

Nombre Description
DistributionDatabase()

Crea una nueva instancia de la clase DistributionDatabase.

DistributionDatabase(String, ServerConnection)

Crea una nueva instancia de la DistributionDatabase clase, con el nombre de base de datos especificado y una conexión al Distribuidor.

Propiedades

Nombre Description
CachePropertyChanges

Obtiene o establece si guardar en caché los cambios realizados en las propiedades de replicación o aplicarlos inmediatamente.

(Heredado de ReplicationObject)
ConnectionContext

Obtiene o establece la conexión a una instancia de Microsoft SQL Server.

(Heredado de ReplicationObject)
DataFile

Obtiene o establece el nombre del archivo de datos para la base de datos de distribución.

DataFileSize

Obtiene o establece el tamaño del archivo principal de la base de datos para la base de datos de distribución.

DataFolder

Obtiene o establece la ruta hacia el directorio que contiene el archivo de datos de la base de datos de distribución.

DistributionCleanupTaskName

Obtiene el nombre del trabajo Agente SQL Server que se encarga de limpiar las tablas de replicación en la distribución.

DistributorSecurity

Obtiene el contexto de seguridad utilizado para conectarse al distribuidor y crear la base de datos de distribución.

HistoryCleanupTaskName

Obtiene el nombre del trabajo Agente SQL Server que se encarga de limpiar las tablas de historial de replicación.

HistoryRetention

Obtiene o establece la duración del tiempo, en horas, los datos del historial del agente de replicación que deben conservarse.

IsExistingObject

Anota si el objeto existe en el servidor o no.

(Heredado de ReplicationObject)
LogFile

Obtiene o establece el nombre del archivo que almacena los registros de transacciones de la base de datos.

LogFileSize

Obtiene o establece el tamaño del archivo que almacena los registros de transacciones de la base de datos.

LogFolder

Obtiene o establece la ruta hacia el directorio donde se encuentra el archivo que almacena los registros de transacciones de la base de datos.

MaxDistributionRetention

Obtiene o establece el periodo máximo de retención, en horas, antes de que las transacciones se eliminen de la base de datos de distribución.

MinDistributionRetention

Obtiene o establece el periodo mínimo de retención, en horas, antes de que las transacciones se eliminen de la base de datos de distribución.

Name

Obtiene o establece el nombre de la base de datos de distribución.

QueueReaderAgentExists

Obtiene o establece si el trabajo Agente Lector de Cola ha sido creado para esta base de datos de distribución.

QueueReaderAgentName

Obtiene o establece el nombre del trabajo del Agente Lector de Cola creado para esta base de datos de distribución.

QueueReaderAgentProcessSecurity

Obtiene el contexto de seguridad del proceso del agente para ejecutar el trabajo del Agente del Lector de Colas.

SqlServerName

Obtiene el nombre de la instancia de Microsoft SQL Server a la que está conectado este objeto.

(Heredado de ReplicationObject)
UserData

Obtiene o establece una propiedad de objeto que permite a los usuarios adjuntar sus propios datos al objeto.

(Heredado de ReplicationObject)

Métodos

Nombre Description
CheckValidCreation()

Comprueba la creación válida de la replicación.

(Heredado de ReplicationObject)
CheckValidDefinition(Boolean)

Indica si la definición es válida.

(Heredado de ReplicationObject)
CleanUpAnonymousSubscription(Int32, PublicationType)

Elimina metadatos de suscripciones anónimas en el distribuidor.

CommitPropertyChanges()

Envía todas las sentencias de cambio de propiedades en caché a la instancia de Microsoft SQL Server.

(Heredado de ReplicationObject)
Create()

Crea la base de datos de distribución.

CreateQueueReaderAgent()

Crea el trabajo de Agente Lector de Cola en la base de datos de distribución.

Decouple()

Desacopla el objeto de replicación referenciado del servidor.

(Heredado de ReplicationObject)
GetChangeCommand(StringBuilder, String, String)

Devuelve el comando de cambio de la replicación.

(Heredado de ReplicationObject)
GetCreateCommand(StringBuilder, Boolean, ScriptOptions)

Devuelve el comando create de la replicación.

(Heredado de ReplicationObject)
GetDropCommand(StringBuilder, Boolean)

Devuelve el comando drop de la replicación.

(Heredado de ReplicationObject)
InternalRefresh(Boolean)

Inicia una actualización interna desde la replicación.

(Heredado de ReplicationObject)
Load()

Carga las propiedades de un objeto existente desde el servidor.

(Heredado de ReplicationObject)
LoadProperties()

Carga las propiedades de un objeto existente desde el servidor.

(Heredado de ReplicationObject)
Refresh()

Recarga las propiedades del objeto.

(Heredado de ReplicationObject)
RegisterBusinessLogicHandler(BusinessLogicHandler)

Registra un conjunto de manejadores de lógica de negocio en el distribuidor.

Remove()

Elimina la base de datos de distribución.

Script(ScriptOptions)

Genera un script Transact-SQL que puede usarse para crear o eliminar la base de datos de distribución que representa el objeto.

UnregisterBusinessLogicHandler(BusinessLogicHandler)

Elimina el registro de un gestor de lógica de negocio del Distribuidor.

Se aplica a

Consulte también