DistributionDatabase Classe

Referência

Definição

Namespace:: Microsoft.SqlServer.Replication

Assembly:: Microsoft.SqlServer.Rmo.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Representa um banco de dados de distribuição no 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

Herança: Object

ReplicationObject
DistributionDatabase

Exemplos

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

Comentários

Acesso thread-safe

Todos os membros estáticos públicos (Shared no Microsoft Visual Basic) desse tipo são seguros para operações multithread. Não há garantia de que qualquer membro de instância seja seguro para threads.

Construtores

DistributionDatabase()	Cria uma nova instância da classe DistributionDatabase.
DistributionDatabase(String, ServerConnection)	Cria uma nova instância da classe DistributionDatabase, com o nome do banco de dados e a conexão com o Distribuidor especificados.

Propriedades

CachePropertyChanges	Obtém ou define se as alterações feitas às propriedades de replicação devem ser armazenadas em cache ou aplicadas imediatamente. (Herdado de ReplicationObject)
ConnectionContext	Obtém ou define a conexão com uma instância do Microsoft SQL Server. (Herdado de ReplicationObject)
DataFile	Obtém ou define o nome do arquivo de dados para o banco de dados de distribuição.
DataFileSize	Obtém ou define o tamanho do arquivo de banco de dados primário para o banco de dados de distribuição.
DataFolder	Obtém ou define o caminho do diretório que contém o arquivo de dados para o banco de dados de distribuição.
DistributionCleanupTaskName	Obtém o nome do trabalho SQL Server Agent responsável por limpar as tabelas de replicação na distribuição.
DistributorSecurity	Obtém o contexto de segurança usado na conexão ao Distribuidor para criar o banco de dados de distribuição.
HistoryCleanupTaskName	Obtém o nome do trabalho de SQL Server Agent responsável por limpar tabelas de histórico de replicação.
HistoryRetention	Obtém ou define o período de tempo, em horas, que leva para reter dados de histórico do agente de replicação.
IsExistingObject	Especifica se o objeto existe no servidor ou não. (Herdado de ReplicationObject)
LogFile	Obtém ou define o nome do arquivo que armazena registros de log de transação do banco de dados.
LogFileSize	Obtém ou define o tamanho do arquivo que armazena registros de log de transação do banco de dados.
LogFolder	Obtém ou define o caminho para o diretório onde está localizado o arquivo que armazena registros de log de transação do banco de dados.
MaxDistributionRetention	Obtém ou define o período de retenção máximo, em horas, antes de as transações serem excluídas do banco de dados de distribuição.
MinDistributionRetention	Obtém ou define o período de retenção mínimo, em horas, antes de as transações serem excluídas do banco de dados de distribuição.
Name	Obtém ou define o nome do banco de dados de distribuição.
QueueReaderAgentExists	Obtém ou define se o trabalho do Queue Reader Agent foi criado para este banco de dados de distribuição.
QueueReaderAgentName	Obtém ou define o nome do trabalho do Queue Reader Agent criado para este banco de dados de distribuição.
QueueReaderAgentProcessSecurity	Obtém o contexto de segurança de processo de agente para executar o trabalho do Queue Reader Agent.
SqlServerName	Obtém o nome da instância do Microsoft SQL Server à qual esse objeto está conectado. (Herdado de ReplicationObject)
UserData	Obtém ou define uma propriedade de objeto que permite que os usuários anexem seus próprios dados ao objeto. (Herdado de ReplicationObject)

Métodos

CheckValidCreation()	Verifica a criação de replicação válida. (Herdado de ReplicationObject)
CheckValidDefinition(Boolean)	Indica se a definição é válida. (Herdado de ReplicationObject)
CleanUpAnonymousSubscription(Int32, PublicationType)	Remove metadados para assinaturas anônimas no Distribuidor.
CommitPropertyChanges()	Envia todas as instruções de alteração de propriedade armazenadas em cache para a instância do Microsoft SQL Server. (Herdado de ReplicationObject)
Create()	Cria o banco de dados de distribuição.
CreateQueueReaderAgent()	Cria o trabalho do Queue Reader Agent no banco de dados de distribuição.
Decouple()	Desacopla o objeto de replicação referenciado do servidor. (Herdado de ReplicationObject)
GetChangeCommand(StringBuilder, String, String)	Retorna o comando change da replicação. (Herdado de ReplicationObject)
GetCreateCommand(StringBuilder, Boolean, ScriptOptions)	Retorna o comando create da replicação. (Herdado de ReplicationObject)
GetDropCommand(StringBuilder, Boolean)	Retorna o comando drop da replicação. (Herdado de ReplicationObject)
InternalRefresh(Boolean)	Inicia uma atualização interna da replicação. (Herdado de ReplicationObject)
Load()	Carrega as propriedades de um objeto existente do servidor. (Herdado de ReplicationObject)
LoadProperties()	Carrega as propriedades de um objeto existente do servidor. (Herdado de ReplicationObject)
Refresh()	Recarrega as propriedades do objeto. (Herdado de ReplicationObject)
RegisterBusinessLogicHandler(BusinessLogicHandler)	Registra um assembly do manipulador de lógica de negócios no Distribuidor.
Remove()	Exclui o banco de dados de distribuição.
Script(ScriptOptions)	Gera um script Transact-SQL que pode ser usado para criar ou excluir o banco de dados de distribuição que o objeto representa.
UnregisterBusinessLogicHandler(BusinessLogicHandler)	Remove o registro de um manipulador de lógica de negócios do Distribuidor.

Aplica-se a