Validar os dados replicados
Aplica-se a:
SQL ServerBanco de Dados SQL do Azure
Este tópico descreve como validar dados no Assinante no SQL Server usando o SQL Server Management Studio, o Transact-SQL ou o RMO (Replication Management Objects).
A replicação transacional e de mesclagem permitem validar os dados no Assinante que correspondem aos dados no Publicador. A validação pode ser executada para assinaturas específicas ou para todas as assinaturas em uma publicação. Especifique um dos seguintes tipos de validação e o Distribution Agent ou o Merge Agent validarão os dados na próxima vez que executarem:
- Somente contagem de linhas. Faz a validação se a tabela no Assinante tem o mesmo número de linhas que a tabela no Publicador, mas não faz a validação da correspondência de conteúdo das linhas. A validação de número de linhas fornece uma abordagem superficial à validação que pode alertá-lo sobre problemas com seus dados.
- Contagem de linhas e soma de verificação binária. Além de contar o número de linhas no Publicador e no Assinante, uma soma de verificação de todos os dados é calculada usando o algoritmo de soma de verificação. Se a contagem de linhas falhar, a soma de verificação não será executada.
Além de validar se esses dados no Assinante e no Publicador são correspondentes, a replicação de mesclagem fornece a capacidade de validar se os dados estão particionados corretamente em cada Assinante. Para obter mais informações, consulte Validate Partition Information for a Merge Subscriber (Validar informações de partição para um assinante de mesclagem).
Observação
A Instância Gerenciada de SQL do Azure pode ser um publicador, um distribuidor e um assinante para a replicação transacional e de instantâneo. Os bancos de dados do Banco de Dados SQL do Azure só podem ser assinantes por push para a replicação transacional e de instantâneo. Para obter mais informações, confira Replicação transacional com o Banco de Dados SQL do Azure e a Instância Gerenciada de SQL do Azure.
Como a validação de dados trabalha
O SQL Server faz a validação dos dados calculando o número de linhas ou uma soma de verificação no Publicador e comparando esses valores com o número de linhas ou a soma de verificação do Assinante. Um valor é calculado para a publicação inteira e um valor é calculado para a tabela de assinatura inteira, mas os dados em text, ntextou as colunas de image não são incluídas nos cálculos.
Enquanto os cálculos estão sendo realizados, são colocados temporariamente bloqueios compartilhados em tabelas, nas quais as contagens de linhas ou as somas de verificações estão sendo executadas, mas são completadas rapidamente e os bloqueios compartilhados removidos, normalmente em questão de segundos.
Quando as somas de verificação binárias são usadas, ocorre uma verificação de redundância (CRC) de 32 bits coluna a coluna, em vez de uma CRC na linha física da página de dados. Isso permite que as colunas da tabela estejam em qualquer ordem física na página de dados, mas sejam calculadas no mesmo CRC da linha. A validação de soma de verificação binária pode ser usada quando há filtros de linha ou de coluna na publicação.
A validação de dados é um processo de três etapas:
Uma única assinatura ou todas as assinaturas para uma publicação são marcadas para validação. Marque as assinaturas para validação nas caixas de diálogo Validar Assinatura, Validar Assinaturas e Validar Todas as Assinaturas, que estão disponíveis na pasta Publicações Locais e na pasta Assinaturas Locais no Microsoft SQL Server Management Studio. Você também pode marcar assinaturas da guia Todas as Assinaturas , a guia Lista de Observação da Assinatura e o nó de publicações no Replication Monitor. Para obter informações sobre como iniciar o Replication Monitor, consulte Start the Replication Monitor (Iniciar o Replication Monitor).
Uma assinatura é validada da próxima vez em que for sincronizada pelo Distribution Agent (para replicação transacional) ou pelo Merge Agent (replicação de mesclagem). O Distribution Agent normalmente é executado continuamente, nesse caso a validação ocorre imediatamente; o Merge Agent normalmente é executado por solicitação, neste caso a validação ocorrerá após você executar o agente.
Exibir os resultados de validação:
- Nas janelas de detalhes do Replication Monitor: na guia Histórico do Distribuidor para o Assinante para replicação transacional e na guia Histórico de Sincronização para replicação de mesclagem.
- Na caixa de diálogo Exibir Status de Sincronização no Management Studio.
Considerações e restrições
Considere os seguintes problemas ao validar dados:
- Você deve cessar todas as atividades nos Assinantes antes de validar os dados (não é necessário parar as atividades do Publicador, enquanto ocorre a validação).
- Como as somas de verificação e as somas de verificações binárias podem requerer recursos extensos do processador ao validar conjuntos de dados muito grandes, você deverá agendar a validação quando houver um mínimo de atividade nos servidores usados na replicação.
- A replicação somente valida tabelas; não realizando a validação se os artigos somente esquema (como os procedimentos armazenados) são os mesmos no Publicador e no Assinante.
- A soma de verificação binária pode ser usada com qualquer tabela publicada. A soma de verificação não pode validar as tabelas com filtros de colunas ou estruturas de tabelas lógicas nas quais os deslocamentos são diferentes (por causa das instruções ALTER TABLE que cancelam ou adicionam colunas).
- A validação de replicação usa as funções checksum e binary_checksum . Para informações sobre seu comportamento, consulte CHECKSUM (Transact-SQL) e BINARY_CHECKSUM (Transact-SQL).
- A validação com o uso de soma de verificação binária ou soma de verificação pode reportar incorretamente uma falha se os tipos de dados forem diferentes no Assinante e no Publicador. Isso poderá acontecer se você fizer o seguinte:
- Definir explicitamente opções de esquema para mapear tipos de dados de versões anteriores do SQL Server.
- Definir o nível de compatibilidade de uma publicação de mesclagem para uma versão anterior do SQL Server e as tabelas publicadas contiverem um ou mais tipos de dados que devem ser mapeados para essa versão.
- Inicialize manualmente uma assinatura que estiver usando tipos de dados diferentes no Assinante.
- As validações da soma de verificação binária e de soma de verificação não oferecem suporte para assinaturas transformáveis na replicação transacional.
- A validação não oferece suporte para os dados replicados em não assinantes do SQL Server.
- Os procedimentos para o Replication Monitor são somente para assinaturas push porque as assinaturas pull não podem ser sincronizadas no Replication Monitor. Porém, você pode marcar uma assinatura para validação e exibir os resultados da validação para assinaturas pull no Replication Monitor.
- Os resultados da validação indicam se a validação obteve êxito ou se falhou, porém não especifica quais linhas falharam a validação caso tenha ocorrido uma falha. Para comparar dados no Publicador e no Assinante, use o tablediff Utility. Para obter informações sobre como usar esse utilitário com os dados replicados, consulte Comparar diferenças em tabelas replicadas (programação de replicação).
Resultados da validação de dados
Quando a validação estiver completa, o Distribution Agent ou o Merge Agent registra mensagens relativas ao êxito ou falha (a replicação não informa quais as linhas que falharam). Essas mensagens podem ser exibidas no SQL Server Management Studio, no Replication Monitor e nas tabelas do sistema de replicação. O tópico de instruções listado acima mostra como executar a validação e exibir os resultados.
Para controlar as falhas de validação, considere o seguinte:
Configure o alerta de replicação chamado Replicação: Falha na validação de dados do assinante para que você seja notificado da falha. Para mais informações, consulte Como configurar alertas de replicação predefinidos (SQL Server Management Studio).
O fato da validação falhar é um problema para o seu aplicativo? Se a falha de validação é um problema, atualize manualmente os dados para serem sincronizados ou reinicialize a assinatura:
Os dados podem ser atualizados usando o utilitário tablediff. Para mais informações sobre como usar esse utilitário, consulte Comparar tabelas replicadas para diferenças (Programação de replicação).
Para mais informações sobre reinicialização, consulte Reinicializar as assinaturas.
Artigos em Replicação Transacional
Como usar o SQL Server Management Studio.
- Conecte-se ao Publicador no SQL Server Management Studio e expanda o nó de servidor.
- Expanda a pasta Replicação e, em seguida, a pasta Publicações Locais .
- Clique com o botão direito do mouse na publicação para a qual você quer validar assinaturas e então clique em Validar Assinaturas.
- Na caixa de diálogo Validar Assinaturas, selecione quais assinatura validar:
- Selecione Validar todas as assinaturas SQL Server
- Selecione Validar estas assinaturase então selecione uma ou mais assinaturas.
- Para especificar o tipo de validação a ser executado (contagem de linha ou contagem de linha e soma de verificação) clique em Opções de Validaçãoe então especifique as opções na caixa de diálogo Opções de Validação de Assinatura .
- Selecione OK.
- Exiba os resultados da validação no Replication Monitor ou a caixa de diálogo Exibir Status da Sincronização . Para cada assinatura:
- Expanda a publicação, clique com o botão direito do mouse na assinatura e então clique em Exibir Status da Sincronização.
- Se o agente não estiver sendo executado clique em Iniciar na caixa de diálogo Exibir Status da Sincronização . A caixa de diálogo exibirá mensagens informativas relacionadas à validação.
Se você não vir nenhuma mensagem relacionada à validação, o agente já registrou uma mensagem subsequente. Neste caso, exiba os resultados de validação no Replication Monitor. Para obter mais informações, consulte os procedimentos de instruções do Replication Monitor neste tópico.
Usando o Transact-SQL
Todos os artigos
No Publicador do banco de dados de publicação, execute sp_publication_validation (Transact-SQL). Especifique
@publicatione um dos valores seguintes para@rowcount_only:- 1 - apenas verifica número de linhas (o padrão)
- 2 - número de linhas e soma de verificação binária.
Observação
Ao executar sp_publication_validation (Transact-SQL), sp_article_validation (Transact-SQL) é executado para cada artigo na publicação. Para executar sp_publication_validation (Transact-SQL) com êxito, é necessário ter permissões SELECT em todas as colunas nas tabelas base publicadas.
(Opcional) Iniciar o Distribution Agent para cada assinatura se já não estiver em execução. Para obter mais informações, consulte Synchronize a Pull Subscription e Synchronize a Push Subscription.
Verifique a saída de agente para o resultado da validação.
Artigo único
No Publicador no banco de dados de publicação, execute sp_article_validation (Transact-SQL). Especifique
@publication, o nome do artigo para@articlee um dos valores seguintes como@rowcount_only:- 1 - apenas verifica número de linhas (o padrão)
- 2 - número de linhas e soma de verificação binária.
Observação
Para executar sp_publication_validation (Transact-SQL) com êxito, é necessário ter permissões SELECT em todas as colunas na tabela base publicada.
(Opcional) Iniciar o Distribution Agent para cada assinatura se já não estiver em execução. Para obter mais informações, consulte Synchronize a Pull Subscription e Synchronize a Push Subscription.
Verifique a saída de agente para o resultado da validação.
Assinante único
No Publicador do banco de dados de publicação, abra uma transação explícita usando BEGIN TRANSACTION (Transact-SQL).
No Publicador no banco de dados de publicação, execute sp_marksubscriptionvalidation (Transact-SQL). Especifique a publicação para
@publication, o nome do Assinante para@subscribere o nome do banco de dados de assinatura para@destination_db.(Opcional) Repita a etapa 2 para cada assinatura que é validada.
No Publicador no banco de dados de publicação, execute sp_article_validation (Transact-SQL). Especifique
@publication, o nome do artigo para@articlee um dos valores seguintes como@rowcount_only:- 1 - apenas verifica número de linhas (o padrão)
- 2 - número de linhas e soma de verificação binária.
Observação
Para executar sp_publication_validation (Transact-SQL) com êxito, é necessário ter permissões SELECT em todas as colunas na tabela base publicada.
No Publicador do banco de dados de publicação, confirme a transação usando COMMIT TRANSACTION (Transact-SQL).
(Opcional) Repita as etapas 1 a 5 para cada artigo que é validado.
(Opcional) Iniciar o Distribution Agent se já não estiver em execução. Para obter mais informações, consulte Synchronize a Pull Subscription e Synchronize a Push Subscription.
Verifique a saída de agente para o resultado da validação. Para obter mais informações, consulte Validate Data at the Subscriber.
Todas as assinaturas push para uma publicação de transação
Usando o Replication Monitor
No Replication Monitor, expanda um Grupo do publicador no painel esquerdo e, depois, expanda um Publicador.
Clique com o botão direito do mouse na publicação para a qual você quer validar assinaturas e então clique em Validar Assinaturas.
Na caixa de diálogo Validar Assinaturas , selecione quais assinatura validar:
- Selecione Validar todas as assinaturas SQL Server
- Selecione Validar estas assinaturase então selecione uma ou mais assinaturas.
Para especificar o tipo de validação a ser executado (contagem de linha ou contagem de linha e soma de verificação) clique em Opções de Validaçãoe então especifique as opções na caixa de diálogo Opções de Validação de Assinatura .
Selecione OK.
Clique na guia Todas as Assinaturas .
Exiba os resultados da validação. Para cada assinatura push:
- Se o agente não estiver sendo executado, clique com o botão direito do mouse na assinatura e então clique em Iniciar Sincronização.
- Clique com o botão direito do mouse na assinatura e, em seguida, clique em Exibir Detalhes.
- Exiba informações na guia Histórico de Distribuidor para o Assinante na área de texto Ações na seção selecionada .
Para uma assinatura única para uma Publicação de Mesclagem
Como usar o SQL Server Management Studio.
Conecte-se ao Publicador no SQL Server Management Studio e expanda o nó de servidor.
Expanda a pasta Replicação e, em seguida, a pasta Publicações Locais .
Expanda a publicação para a qual você quer validar assinaturas, clique com o botão direito do mouse na assinatura e então clique em Validar Assinatura.
Na caixa de diálogo Validar Assinatura , selecione Validar esta assinatura.
Para especificar o tipo de validação a ser executado (contagem de linha ou contagem de linha e soma de verificação) clique em Opçõese então especifique as opções na caixa de diálogo Opções de Validação de Assinatura .
Selecione OK.
Exiba os resultados da validação no Replication Monitor ou a caixa de diálogo Exibir Status da Sincronização :
- Expanda a publicação, clique com o botão direito do mouse na assinatura e então clique em Exibir Status da Sincronização.
- Se o agente não estiver sendo executado clique em Iniciar na caixa de diálogo Exibir Status da Sincronização . A caixa de diálogo exibirá mensagens informativas relacionadas à validação.
Se você não vir nenhuma mensagem relacionada à validação, o agente já registrou uma mensagem subsequente. Neste caso, exiba os resultados de validação no Replication Monitor. Para obter mais informações, consulte os procedimentos de instruções do Replication Monitor neste tópico.
Para todas as assinaturas para uma Publicação de Mesclagem
Como usar o SQL Server Management Studio.
Conecte-se ao Publicador no SQL Server Management Studio e expanda o nó de servidor.
Expanda a pasta Replicação e, em seguida, a pasta Publicações Locais .
Clique com o botão direito do mouse na publicação para a qual você quer validar assinaturas e então clique em Validar Todas as Assinaturas.
Na caixa de diálogo Validar Todas as Assinaturas , especifique o tipo de validação a ser executado (contagem de linha ou contagem de linha e soma de verificação).
Selecione OK.
Exiba os resultados da validação no Replication Monitor ou a caixa de diálogo Exibir Status da Sincronização . Para cada assinatura:
- Expanda a publicação, clique com o botão direito do mouse na assinatura e então clique em Exibir Status da Sincronização.
- Se o agente não estiver sendo executado clique em Iniciar na caixa de diálogo Exibir Status da Sincronização . A caixa de diálogo exibirá mensagens informativas relacionadas à validação.
Se você não vir nenhuma mensagem relacionada à validação, o agente já registrou uma mensagem subsequente. Neste caso, exiba os resultados de validação no Replication Monitor. Para obter mais informações, consulte os procedimentos de instruções do Replication Monitor neste tópico.
Para uma única assinatura push para uma Publicação de Mesclagem
Usando o Replication Monitor
- No Replication Monitor, expanda um Grupo do publicador no painel esquerdo, expanda um Publicador e, depois, clique em uma publicação.
- Clique na guia Todas as Assinaturas .
- Clique com o botão direito do mouse na assinatura que você quer validar, depois clique em Validar Assinatura.
- Na caixa de diálogo Validar Assinatura , selecione Validar esta assinatura.
- Para especificar o tipo de validação a ser executado (contagem de linha ou contagem de linha e soma de verificação) clique em Opçõese então especifique as opções na caixa de diálogo Opções de Validação de Assinatura .
- Selecione OK.
- Clique na guia Todas as Assinaturas .
- Exiba os resultados da validação:
- Se o agente não estiver sendo executado, clique com o botão direito do mouse na assinatura e então clique em Iniciar Sincronização.
- Clique com o botão direito do mouse na assinatura e, em seguida, clique em Exibir Detalhes.
- Exiba informações na guia Histórico de Sincronização na área de texto Última mensagem da sessão selecionada .
Usando o Transact-SQL
No Publicador no banco de dados de publicação, execute sp_validatemergesubscription (Transact-SQL). Especifique
@publication, o nome do Assinante para@subscriber, o nome do banco de dados de assinatura para@subscriber_dbe um dos valores seguintes para@level:- 1 - apenas validação de número de linhas.
- 3 - validação de soma de verificação binária de número de linhas.
Isso marca a assinatura selecionada para validação.
Inicie o agente de mesclagem para cada assinatura. Para obter mais informações, consulte Synchronize a Pull Subscription e Synchronize a Push Subscription.
Verifique a saída de agente para o resultado da validação.
Repita as etapas 1 a 3 para cada assinatura que é validada.
Observação
A assinatura para uma publicação de mesclagem também pode ser validada especificando-se o parâmetro -Validate ao executar o Replication Merge Agent.
Para todas as assinaturas push para uma Publicação de Mesclagem
Usando o Replication Monitor
- No Replication Monitor, expanda um Grupo do publicador no painel esquerdo e, depois, expanda um Publicador.
- Clique com o botão direito do mouse na publicação para a qual você quer validar assinaturas e então clique em Validar Todas as Assinaturas.
- Na caixa de diálogo Validar Todas as Assinaturas , especifique o tipo de validação a ser executado (contagem de linha ou contagem de linha e soma de verificação).
- Selecione OK.
- Clique na guia Todas as Assinaturas .
- Exiba os resultados da validação. Para cada assinatura push:
- Se o agente não estiver sendo executado, clique com o botão direito do mouse na assinatura e então clique em Iniciar Sincronização.
- Clique com o botão direito do mouse na assinatura e, em seguida, clique em Exibir Detalhes.
- Exiba informações na guia Histórico de Sincronização na área de texto Última mensagem da sessão selecionada .
Usando o Transact-SQL
No Publicador do banco de dados de publicação, execute sp_validatemergepublication (Transact-SQL). Especifique
@publicatione um dos valores seguintes para@level:- 1 - apenas validação de número de linhas.
- 3 - validação de soma de verificação binária de número de linhas.
Isso marca todas as assinaturas para validação.
Inicie o agente de mesclagem para cada assinatura. Para obter mais informações, consulte Synchronize a Pull Subscription e Synchronize a Push Subscription.
Verifique a saída de agente para o resultado da validação. Para obter mais informações, consulte Validate Data at the Subscriber.
Validar dados usando parâmetros de Agente de Mesclagem
Inicie o Merge Agent no Assinante (assinatura pull) ou no Distribuidor (assinatura push) do prompt de comando em um dos seguintes modos.
- Especificando o valor de 1 (número de linhas) ou 3 (número de linhas e soma de verificação binária) para o parâmetro -Validate .
- Especificando validação de número de linhas ou validação de número de linhas e de soma de verificação para o parâmetro - ProfileName .
Para obter mais informações, consulte Synchronize a Pull Subscription ou Synchronize a Push Subscription.
Usando o RMO (Replication Management Objects)
A replicação permite que você use RMO (Replication Management Objects) para validar programaticamente os dados que no Assinante correspondam aos dados do Publicador. Os objetos usados dependem do tipo de topologia de replicação. A replicação transacional necessita de validação em todas as assinaturas de uma publicação.
Observação
Para obter um exemplo, consulte Exemplo (RMO)posteriormente nesta seção.
Para validar dados para todos os artigos em uma publicação transacional
Crie uma conexão com o Publicador usando a classe ServerConnection .
Criar uma instância da classe TransPublication. Defina as propriedades Name e DatabaseName para a publicação. Defina a propriedade ConnectionContext para a conexão criada na etapa 1.
Chame o método LoadProperties para obter as propriedades remanescentes do objeto. Se esse método retornar false, as propriedades de publicação na etapa 2 foram definidas incorretamente ou a publicação não existe.
Chame o método ValidatePublication . Passe o seguinte:
Um Booliano que indica se é preciso parar o Distribution Agent depois de completar a validação.
Isso marca os artigos para a validação.
Se ainda não estiver executando, inicie o Distribution Agent para sincronizar cada assinatura. Para obter mais informações, consulte Synchronize a Push Subscription ou Synchronize a Pull Subscription. O resultado da operação de validação é escrito no histórico do agente. Para obter mais informações, consulte Monitoring Replication.
Para validar dados em todas as assinaturas para uma publicação de mesclagem
Crie uma conexão com o Publicador usando a classe ServerConnection .
Criar uma instância da classe MergePublication. Defina as propriedades Name e DatabaseName para a publicação. Defina a propriedade ConnectionContext para a conexão criada na etapa 1.
Chame o método LoadProperties para obter as propriedades remanescentes do objeto. Se esse método retornar false, as propriedades de publicação na etapa 2 foram definidas incorretamente ou a publicação não existe.
Chame o método ValidatePublication . Passe o ValidationOptiondesejado.
Execute o Merge Agent para cada assinatura iniciar a validação ou espere pela próxima execução de agente marcada. Para obter mais informações, consulte Synchronize a Pull Subscription e Synchronize a Push Subscription. O resultado da operação de validação é gravado no histórico de agente que você exibe usando o Replication Monitor. Para obter mais informações, consulte Monitoring Replication.
Para validar os dados em uma única assinatura em uma publicação de mesclagem
Crie uma conexão com o Publicador usando a classe ServerConnection .
Criar uma instância da classe MergePublication. Defina as propriedades Name e DatabaseName para a publicação. Defina a propriedade ConnectionContext para a conexão criada na etapa 1.
Chame o método LoadProperties para obter as propriedades remanescentes do objeto. Se esse método retornar false, as propriedades de publicação na etapa 2 foram definidas incorretamente ou a publicação não existe.
Chame o método ValidateSubscription . Passe o nome do Assinante e banco de dados de assinatura que estão sendo validados e o ValidationOptiondesejado.
Execute o Merge Agent para a assinatura iniciar a validação ou espere pela próxima execução de agente marcada. Para obter mais informações, consulte Synchronize a Pull Subscription e Synchronize a Push Subscription. O resultado da operação de validação é gravado no histórico de agente que você exibe usando o Replication Monitor. Para obter mais informações, consulte Monitoring Replication.
Exemplo (RMO)
Este exemplo marca todas as assinatura em uma publicação transacional para a validação de número de linhas.
// Define the server, database, and publication names
string publisherName = publisherInstance;
string publicationName = "AdvWorksProductTran";
string publicationDbName = "AdventureWorks2022";
TransPublication publication;
// Create a connection to the Publisher.
ServerConnection conn = new ServerConnection(publisherName);
try
{
// Connect to the Publisher.
conn.Connect();
// Set the required properties for the publication.
publication = new TransPublication();
publication.ConnectionContext = conn;
publication.Name = publicationName;
publication.DatabaseName = publicationDbName;
// If we can't get the properties for this publication,
// throw an application exception.
if (publication.LoadProperties())
{
// Initiate validataion for all subscriptions to this publication.
publication.ValidatePublication(ValidationOption.RowCountOnly,
ValidationMethod.ConditionalFast, false);
// If not already running, start the Distribution Agent at each
// Subscriber to synchronize and validate the subscriptions.
}
else
{
throw new ApplicationException(String.Format(
"Settings could not be retrieved for the publication. " +
"Ensure that the publication {0} exists on {1}.",
publicationName, publisherName));
}
}
catch (Exception ex)
{
// Do error handling here.
throw new ApplicationException(
"Subscription validation could not be initiated.", ex);
}
finally
{
conn.Disconnect();
}
' Define the server, database, and publication names
Dim publisherName As String = publisherInstance
Dim publicationName As String = "AdvWorksProductTran"
Dim publicationDbName As String = "AdventureWorks2022"
Dim publication As TransPublication
' Create a connection to the Publisher.
Dim conn As ServerConnection = New ServerConnection(publisherName)
Try
' Connect to the Publisher.
conn.Connect()
' Set the required properties for the publication.
publication = New TransPublication()
publication.ConnectionContext = conn
publication.Name = publicationName
publication.DatabaseName = publicationDbName
' If we can't get the properties for this publication,
' throw an application exception.
If publication.LoadProperties() Then
' Initiate validataion for all subscriptions to this publication.
publication.ValidatePublication(ValidationOption.RowCountOnly, _
ValidationMethod.ConditionalFast, False)
' If not already running, start the Distribution Agent at each
' Subscriber to synchronize and validate the subscriptions.
Else
Throw New ApplicationException(String.Format( _
"Settings could not be retrieved for the publication. " + _
"Ensure that the publication {0} exists on {1}.", _
publicationName, publisherName))
End If
Catch ex As Exception
' Do error handling here.
Throw New ApplicationException( _
"Subscription validation could not be initiated.", ex)
Finally
conn.Disconnect()
End Try
Este exemplo marca uma assinatura específica em uma publicação de mesclagem para validação de número de linhas.
// Define the server, database, and publication names
string publisherName = publisherInstance;
string publicationName = "AdvWorksSalesOrdersMerge";
string publicationDbName = "AdventureWorks2022";
string subscriberName = subscriberInstance;
string subscriptionDbName = "AdventureWorks2022Replica";
MergePublication publication;
// Create a connection to the Publisher.
ServerConnection conn = new ServerConnection(publisherName);
try
{
// Connect to the Publisher.
conn.Connect();
// Set the required properties for the publication.
publication = new MergePublication();
publication.ConnectionContext = conn;
publication.Name = publicationName;
publication.DatabaseName = publicationDbName;
// If we can't get the properties for this merge publication, then throw an application exception.
if (publication.LoadProperties())
{
// Initiate validation of the specified subscription.
publication.ValidateSubscription(subscriberName,
subscriptionDbName, ValidationOption.RowCountOnly);
// Start the Merge Agent to synchronize and validate the subscription.
}
else
{
throw new ApplicationException(String.Format(
"Settings could not be retrieved for the publication. " +
"Ensure that the publication {0} exists on {1}.",
publicationName, publisherName));
}
}
catch (Exception ex)
{
// Do error handling here.
throw new ApplicationException(String.Format(
"The subscription at {0} to the {1} publication could not " +
"be validated.", subscriberName, publicationName), ex);
}
finally
{
conn.Disconnect();
}
' Define the server, database, and publication names
Dim publisherName As String = publisherInstance
Dim publicationName As String = "AdvWorksSalesOrdersMerge"
Dim publicationDbName As String = "AdventureWorks2022"
Dim subscriberName As String = subscriberInstance
Dim subscriptionDbName As String = "AdventureWorks2022Replica"
Dim publication As MergePublication
' Create a connection to the Publisher.
Dim conn As ServerConnection = New ServerConnection(publisherName)
Try
' Connect to the Publisher.
conn.Connect()
' Set the required properties for the publication.
publication = New MergePublication()
publication.ConnectionContext = conn
publication.Name = publicationName
publication.DatabaseName = publicationDbName
' If we can't get the properties for this merge publication, then throw an application exception.
If publication.LoadProperties() Then
' Initiate validation of the specified subscription.
publication.ValidateSubscription(subscriberName, _
subscriptionDbName, ValidationOption.RowCountOnly)
' Start the Merge Agent to synchronize and validate the subscription.
Else
Throw New ApplicationException(String.Format( _
"Settings could not be retrieved for the publication. " + _
"Ensure that the publication {0} exists on {1}.", _
publicationName, publisherName))
End If
Catch ex As Exception
' Do error handling here.
Throw New ApplicationException(String.Format( _
"The subscription at {0} to the {1} publication could not " + _
"be validated.", subscriberName, publicationName), ex)
Finally
conn.Disconnect()
End Try
Confira também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de