DistributionDatabase Classe
Definição
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
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
Segurança de Thread
Qualquer membro público estático (Sharedem Microsoft Visual Basic) desse tipo é seguro para operações multithread. Não há garantia de que quaisquer membros de instância sejam thread-safe.
Construtores
| Nome | Description |
|---|---|
| DistributionDatabase() |
Cria uma nova instância da classe DistributionDatabase. |
| DistributionDatabase(String, ServerConnection) |
Cria uma nova instância da DistributionDatabase classe, com o nome do banco de dados especificado e uma conexão com o Distribuidor. |
Propriedades
| Nome | Description |
|---|---|
| CachePropertyChanges |
Obtém ou define se devem armazenar em cache as alterações feitas nas propriedades de replicação ou aplicá-las imediatamente. (Herdado de ReplicationObject) |
| ConnectionContext |
Obtém ou configura a conexão para 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 principal do banco de dados da distribuição. |
| DataFolder |
Obtém ou define o caminho para o diretório que contém o arquivo de dados do banco de dados de distribuição. |
| DistributionCleanupTaskName |
Obtém o nome do trabalho do SQL Server Agent responsável por limpar as tabelas de replicação na distribuição. |
| DistributorSecurity |
Obtém o contexto de segurança usado para se conectar ao Distribuidor e criar o banco de dados de distribuição. |
| HistoryCleanupTaskName |
Recebe o nome do job do SQL Server Agent responsável por limpar as tabelas de histórico de replicação. |
| HistoryRetention |
Obtém ou define o tempo em horas, os dados do histórico do agente de replicação devem ser mantidos. |
| IsExistingObject |
Determina 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 registros de transações no banco de dados. |
| LogFileSize |
Obtém ou define o tamanho do arquivo que armazena registros de log de transações no banco de dados. |
| LogFolder |
Obtém ou define o caminho até o diretório onde está localizado o arquivo que armazena registros de logs de transações no banco de dados. |
| MaxDistributionRetention |
Obtém ou define o período máximo de retenção, em horas, antes que as transações sejam excluídas do banco de dados de distribuição. |
| MinDistributionRetention |
Obtém ou define o período mínimo de retenção, em horas, antes de as transações serem excluídas do banco de dados de distribuição. |
| Name |
Recebe ou define o nome do banco de dados de distribuição. |
| QueueReaderAgentExists |
Obtém ou define se o trabalho Agente Leitor de Fila foi criado para esse banco de dados de distribuição. |
| QueueReaderAgentName |
Recebe ou define o nome do trabalho Agente Leitor de Fila criado para esse banco de dados de distribuição. |
| QueueReaderAgentProcessSecurity |
Obtém o contexto de segurança do processo do agente para executar o trabalho do Agente Leitor de Fila. |
| 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 aos usuários anexar seus próprios dados ao objeto. (Herdado de ReplicationObject) |
Métodos
| Nome | Description |
|---|---|
| CheckValidCreation() |
Verifica a criação válida da replicação. (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 declarações de alteração de propriedades 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 Agente Leitor de Fila 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 de mudança 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 a partir da replicação. (Herdado de ReplicationObject) |
| Load() |
Carrega as propriedades de um objeto existente a partir do servidor. (Herdado de ReplicationObject) |
| LoadProperties() |
Carrega as propriedades de um objeto existente a partir do servidor. (Herdado de ReplicationObject) |
| Refresh() |
Recarrega as propriedades do objeto. (Herdado de ReplicationObject) |
| RegisterBusinessLogicHandler(BusinessLogicHandler) |
Registra um conjunto de handler 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 gerenciador de lógica de negócios do Distribuidor. |