DistributionDatabase Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
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. |