Agente de mesclagem de replicação

Aplica-se a:SQL Server

O Replication Merge Agent é um executável utilitário que aplica o instantâneo inicial mantido nas tabelas do banco de dados aos assinantes. Ele também mescla alterações incrementais de dados que ocorreram no Publisher depois que o instantâneo inicial foi criado e reconcilia conflitos de acordo com as regras configuradas ou usando um resolvedor personalizado criado.

Sintaxe

  
replmerg [-?]   
-Publisher server_name[\instance_name]  
-PublisherDB publisher_database  
-Publication publication  
-Subscriber server_name[\instance_name]  
-SubscriberDB subscriber_database  
[-AltSnapshotFolder alt_snapshot_folder_path]  
[-Continuous]  
[-DefinitionFile def_path_and_file_name]  
[-DestThreads number_of_destination_threads]  
[-Distributor server_name[\instance_name]]  
[-DistributorLogin distributor_login]  
[-DistributorPassword distributor_password]  
[-DistributorSecurityMode [0|1]]  
[-DownloadGenerationsPerBatch download_generations_per_batch]  
[-DownloadReadChangesPerBatch download_read_changes_per_batch]  
[-DownloadWriteChangesPerBatch download_write_changes_per_batch]  
[-DynamicSnapshotLocation dynamic_snapshot_location]  
[-EncryptionLevel [0|1|2]]  
[-ExchangeType [1|2|3]]  
[-FastRowCount [0|1]]  
[-FileTransferType [0|1]]  
[-ForceConvergenceLevel [0|1|2 (Publisher|Subscriber|Both)]]  
[-FtpAddress ftp_address]  
[-FtpPassword ftp_password]  
[-FtpPort ftp_port]  
[-FtpUserNameftp_user_name]  
[-HistoryVerboseLevel [0|1|2|3]]  
[-Hostname host_name]  
[-InteractiveResolution [0|1]]  
[-InternetLogin internet_login]  
[-InternetPassword internet_password]  
[-InternetProxyLogin internet_proxy_login]  
[–InternetProxyPassword internet_proxy_password]  
[-InternetProxyServer internet_proxy_server]  
[-InternetSecurityMode [0|1]]  
[-InternetTimeout internet_timeout]  
[-InternetURL internet_url]  
[-KeepAliveMessageInterval keep_alive_message_interval_seconds]  
[-LoginTimeOut login_time_out_seconds]  
[-MakeGenerationInterval make_generation_interval_seconds]  
[-MaxBcpThreads number_of_threads]  
[-MaxDownloadChanges number_of_download_changes]  
[-MaxUploadChanges number_of_upload_changes]  
[-MetadataRetentionCleanup [0|1]]  
[-Output]  
[-OutputVerboseLevel [0|1|2]]  
[-ParallelUploadDownload [0|1]]  
[-PacketSize packet_size]   
[-PollingInterval polling_interval]  
[-ProfileName profile_name]  
[-PublisherFailoverPartner server_name[\instance_name] ]  
[-PublisherLogin publisher_login]  
[-PublisherPassword publisher_password]  
[-PublisherSecurityMode [0|1]]  
[-QueryTimeOut query_time_out_seconds]  
[-SrcThreads number_of_source_threads]  
[-StartQueueTimeout start_queue_timeout_seconds]  
[-SubscriberConflictClean [0|1]]  
[-SubscriberDatabasePath subscriber_path]  
[-SubscriberDBAddOption [0|1|2|3]]  
[-SubscriberLogin subscriber_login]  
[-SubscriberPassword subscriber_password   
[-SubscriberSecurityMode [0|1]]  
[-SubscriberType [0|1|2|3|4|5|6|7|8|9]]  
[-SubscriptionType [0|1|2]]  
[-SyncToAlternate [0|1]]  
[-T [101|102]]  
[-UploadGenerationsPerBatch upload_generations_per_batch]  
[-UploadReadChangesPerBatch upload_read_changes_per_batch]  
[-UploadWriteChangesPerBatch upload_write_changes_per_batch]  
[-UseInprocLoader]  
[-Validate [0|1|2|3]]  
[-ValidateInterval validate_interval]  

Arguments

-?
Imprime todos os parâmetros disponíveis.

-Editoraserver_name[\instance_name]
É o nome do Editor. Especifique server_name para a instância padrão do Microsoft SQL Server nesse servidor. Especifique server_name\instance_name para uma instância nomeada do SQL Server nesse servidor.

-PublisherDBpublisher_database
É o nome do banco de dados do Publisher.

-Publicação
É o nome da publicação. Esse parâmetro só é válido se a publicação estiver definida para ter sempre um instantâneo disponível para assinaturas novas ou reinicializadas.

-Assinanteserver_name[\instance_name]
É o nome do Assinante. Especifique server_name para a instância padrão do SQL Server nesse servidor. Especifique server_name\instance_name para uma instância nomeada do SQL Server nesse servidor.

-SubscriberDBsubscriber_database
É o nome do banco de dados de assinantes.

-AltSnapshotFolderalt_snapshot_folder_path
É o caminho para a pasta que contém o instantâneo inicial de uma assinatura.

-Em contínuo
Especifica se o agente tenta sondar transações replicadas continuamente. Se especificado, o agente sonda transações replicadas da origem em intervalos de sondagem, mesmo que não haja transações pendentes.

-DestThreadsnumber_of_destination_threads
Especifica o número de threads de destino que o Merge Agent usa para aplicar alterações no destino. O destino é o Editor durante o upload e o Assinante durante o download. A predefinição é 4.

-DefinitionFiledef_path_and_file_name
É o caminho do arquivo de definição do agente. Um arquivo de definição de agente contém argumentos de prompt de comando para o agente. O conteúdo do arquivo é analisado como um arquivo executável. Use aspas duplas (") para especificar valores de argumento contendo caracteres arbitrários.

-Distribuidorserver_name[\instance_name]
É o nome do distribuidor. Especifique server_name para a instância padrão do SQL Server nesse servidor. Especifique server_name\instance_name para uma instância nomeada do SQL Server nesse servidor. Para distribuição de Distribuidor (push), o nome assume como padrão o nome da instância padrão do SQL Server no computador local.

-DistribuidorLogindistributor_login
É o nome de login do Distribuidor.

-DistributorPassworddistributor_password
É a senha do distribuidor.

-DistribuidorSecurityMode [ 0| 1]
Especifica o modo de segurança do Distribuidor. Um valor 0 indica o Modo de Autenticação do SQL Server (padrão) e um valor 1 indica o Modo de Autenticação do Windows.

-DownloadGenerationsPerBatchdownload_generations_per_batch
É o número de gerações a serem processadas em um único lote durante o download de alterações do Editor para o Assinante. Uma geração é definida como um grupo lógico de alterações por artigo. O padrão para um link de comunicação confiável é 100. O padrão para um link de comunicação não confiável é 10.

-DownloadReadChangesPerBatchdownload_read_changes_per_batch
É o número de alterações a serem lidas em um único lote durante o download de alterações do Editor para o Assinante. O padrão é 100.

-DownloadWriteChangesPerBatchdownload_write_changes_per_batch
É o número de alterações a serem aplicadas em um único lote durante o download de alterações do Editor para o Assinante. O padrão é 100.

-DynamicSnapshotLocationdynamic_snapshot_location
É o local dos arquivos de instantâneo de dados filtrados quando a publicação usa filtros de linha parametrizados.

-Nível de Encriptação [ 0 | 1 | 2 | 4]
É o nível de Transport Layer Security (TLS), anteriormente conhecido como Secure Sockets Layer (SSL), criptografia usada pelo Merge Agent ao fazer conexões.

Um certificado TLS/SSL válido é definido com um nome de domínio totalmente qualificado do SQL Server. Para que o agente se conecte com êxito ao definir -EncryptionLevel para 2, crie um alias no SQL Server local. O parâmetro 'Alias Name' deve ser o nome do servidor e o parâmetro 'Server' deve ser definido como o nome totalmente qualificado do SQL Server.

Para obter mais informações, consulte Exibir e modificar configurações de segurança de replicação.

-Tipo de Troca [ 1| 2| 3]

Especifica o tipo de troca de dados durante a sincronização, que pode ser uma das seguintes:

Os artigos somente para download permitem controlar o comportamento de sincronização de artigos individuais em uma publicação e podem fornecer um benefício de desempenho. Para obter mais informações, consulte Otimizar o desempenho da replicação de mesclagem com Download-Only artigos.

Se estiver usando ExchangeType para separar a fase de upload e download da replicação de mesclagem em sessões separadas, você deverá executar o agente de mesclagem com ExchangeType definido como 1 primeiro e, em seguida, executar o agente de mesclagem novamente com o valor 2. A falha ao executar o agente de mesclagem com ambos os parâmetros fará com que os metadados sejam excluídos e exigirá que você reinicialize a assinatura (sem upload).

-ContagemRápidoRowCount [0|1]
Especifica que tipo de método de cálculo de contagem de linhas deve ser usado para validação de contagem de linhas. Um valor de 1 (padrão) indica o método fast. Um valor de 0 indica o método de contagem de linhas completa.

-FileTransferType [0|1]
Especifica o tipo de transferência de arquivo. Um valor de 0 indica UNC (convenção de nomenclatura universal) e um valor de 1 indica FTP (protocolo de transferência de arquivos).

-ForceConvergenceLevel [0|,1|,2 (Assinante| do Editor| ,Ambos)]
Especifica o nível de convergência que o Merge Agent deve usar e pode ser um dos seguintes:

-FtpAddressftp_address
É o endereço de rede do serviço FTP para o Distribuidor. Quando não especificado, o Distribuidor é usado.

-FtpPasswordftp_password
É a senha de usuário usada para se conectar ao serviço FTP.

-FtpPortftp_port
É o número da porta do serviço FTP para o Distribuidor. Quando não especificado, o número de porta padrão para o serviço FTP (21) é usado.

-FtpUserNameftp_user_name
É o nome de usuário usado para se conectar ao serviço FTP. Quando não especificado, o anônimo é usado.

-HistóriaVerboseLevel [1|,2|,3]
Especifica a quantidade de histórico registrado durante uma operação de mesclagem. Você pode minimizar o efeito do registro de histórico no desempenho selecionando 1.

-Nomedo anfitrião host_name
É o nome da rede do computador local. O padrão é o nome do computador local.

-Resolução Interativa [0|1]
Especifica se a resolução interativa de conflitos é usada quando ocorre um conflito durante a sincronização. O padrão é 0, indicando que a resolução interativa de conflitos não é usada.

-InternetLogininternet_login
Especifica o nome de logon usado ao se conectar a uma DLL ISAPI de ouvinte de replicação do SQL Server que requer autenticação.

-InternetPasswordinternet_password
Especifica a senha usada ao se conectar a uma DLL ISAPI de ouvinte de replicação do SQL Server que requer autenticação.

-InternetProxyLogininternet_proxy_login
Especifica o nome de logon usado ao se conectar a um servidor proxy, definido em internet_proxy_server, que requer autenticação.

–InternetProxyPasswordinternet_proxy_password
Especifica a senha usada ao se conectar a um servidor proxy, definido em internet_proxy_server, que requer autenticação.

-InternetProxyServerinternet_proxy_server
Especifica o servidor proxy a ser usado ao acessar o recurso HTTP especificado em internet_url.

-ModoSegurança da Internet [0|1]
Especifica o modo de segurança do IIS usado ao se conectar ao servidor Web durante a sincronização da Web. Um valor de 0 indica Autenticação Básica e um valor de 1 indica Autenticação Integrada do Windows (padrão).

-InternetTimeoutinternet_timeout
É o número de segundos antes que uma conexão com a DLL ISAPI do ouvinte de replicação do SQL Server atinja o tempo limite.

-InternetURLinternet_url
Especifica a URL usada para se conectar à DLL ISAPI do ouvinte de replicação do SQL Server. Esta propriedade deve ser especificada.

-KeepAliveMessageIntervalkeep_alive_message_interval_seconds
É o número de segundos antes de o thread de histórico verificar se alguma das conexões existentes está aguardando uma resposta do servidor. Esse valor pode ser reduzido para evitar que o agente de verificação marque o Merge Agent como suspeito ao executar um lote de longa execução. O padrão é 300 segundos.

-LoginTimeOutlogin_time_out_seconds
É o número de segundos antes do tempo limite de início de sessão. O padrão é 15 segundos.

-MakeGenerationIntervalmake_generation_interval_seconds
É o número de segundos a aguardar entre a criação de gerações, ou lotes de alterações, para transferir para o cliente. O padrão é 1 segundo.

Makegeneration é o processo que prepara as alterações do Publisher para serem baixadas para Assinantes, e pode ser um gargalo de desempenho durante os downloads. Se o processo makegeneration já tiver sido executado dentro do intervalo especificado por -MakeGenerationInterval, o processo será ignorado para a sessão de sincronização atual. Isso pode beneficiar a simultaneidade de sincronização e é especialmente útil se os assinantes não esperam baixar alterações.

-MaxBcpThreadsnumber_of_threads
Especifica o número de operações de cópia em massa que podem ser executadas em paralelo. O número máximo de threads e conexões ODBC que existem simultaneamente é o menor de MaxBcpThreads ou o número de solicitações de cópia em massa que aparecem na tabela do sistema sysmergeschemachange no banco de dados de publicação. MaxBcpThreads deve ter um valor maior que 0 e não tem limite superior codificado. O padrão é 1.

-MaxDownloadChangesnumber_of_download_changes
Especifica o número máximo de linhas alteradas que devem ser baixadas do Editor para o Assinante. O número de linhas descarregadas pode ser superior ao máximo especificado porque: são processadas gerações completas; e threads de destino paralelos podem ser executados, cada um dos quais processa pelo menos 100 alterações em sua primeira passagem. Por padrão, todas as alterações que estão prontas para serem baixadas são enviadas.

-MaxUploadChangesnumber_of_upload_changes
Especifica o número máximo de linhas alteradas que devem ser carregadas do Assinante para o Editor. O número de linhas carregadas pode ser maior do que o máximo especificado porque: gerações completas são processadas; e threads de destino paralelos podem ser executados, cada um dos quais processa pelo menos 100 alterações em sua primeira passagem. Por padrão, todas as alterações que estão prontas para serem carregadas são enviadas.

-MetadadosRetentionCleanup [0|1]
Especifica se os metadados são removidos de MSmerge_genhistory, MSmerge_contents, MSmerge_tombstone, MSmerge_past_partition_mappings e MSmerge_current_partition_mappings com base no período de retenção de publicação. O padrão é 1, indicando que a limpeza deve ocorrer. Um valor 0 indica que a limpeza não deve ocorrer automaticamente.

-Saídaoutput_path_and_file_name
É o caminho do arquivo de saída do agente. Se o nome do arquivo não for fornecido, a saída será enviada para o console. Se o nome de arquivo especificado existir, a saída será anexada ao arquivo.

-SaídaVerboseLevel [0|1|2]
Especifica se a saída deve ser detalhada. Se o nível detalhado for 0, apenas mensagens de erro serão impressas. Se o nível detalhado for 1, todas as mensagens do relatório de progresso serão impressas. Se o nível detalhado for 2 (padrão), todas as mensagens de erro e mensagens de relatório de progresso serão impressas, o que é útil para depuração.

-ParallelUploadDownload [0|1]
Especifica se o Merge Agent deve processar em paralelo as alterações carregadas no Publisher e as baixadas para o Assinante, o que pode ser útil em ambientes de alto volume com alta largura de banda de rede. No entanto, observe o aviso abaixo para casos em que ParallelUploadDownload está definido como 1.

Este parâmetro está na lista para possível descontinuação em breve. Recomendamos definir o parâmetro ParallelUploadDownload como 0 e evitar o uso do perfil do agente de mesclagem "High Volume Server-to-Server", pois ParallelUploadDownload está definido como 1 neste perfil.

-Tamanho do Pacote
É o tamanho do pacote, em bytes. O padrão é 4096 (bytes).

-PollingIntervalpolling_interval
É a frequência com que, em segundos, o Editor ou Assinante é consultado para alterações de dados. O padrão é 60 segundos.

-ProfileNameprofile_name
Especifica um perfil de agente a ser usado para parâmetros de agente. Se ProfileName for NULL, o perfil do agente será desativado. Se ProfileName não for especificado, o perfil padrão para o tipo de agente será usado. Para obter informações, consulte Perfis do agente de replicação.

-PublisherFailoverPartnerserver_name[\instance_name]
Especifica a instância de parceiro de failover do SQL Server que participa de uma sessão de espelhamento de banco de dados com o banco de dados de publicação. Para obter mais informações, consulte Espelhamento e replicação de banco de dados (SQL Server).

-PublisherLoginpublisher_login
É o nome de login do Editor. Se PublisherSecurityMode for 0 (para Autenticação do SQL Server), esse parâmetro deverá ser especificado.

-PublisherPasswordpublisher_password
É a senha do Editor. Se PublisherSecurityMode for 0 (para Autenticação do SQL Server), esse parâmetro deverá ser especificado.

-Modo de Segurança do Editor [0|1]
Especifica o modo de segurança do Editor. Um valor 0 indica a Autenticação do SQL Server (padrão) e um valor 1 indica o Modo de Autenticação do Windows.

-QueryTimeOutquery_time_out_seconds
É o número de segundos antes do tempo limite da consulta. O padrão é 300 segundos. O Merge Agent também usa o valor de QueryTimeout para determinar quanto tempo esperar pela geração de um instantâneo particionado quando esse valor for maior que 1800.

-SrcThreadsnumber_of_source_threads
Especifica o número de threads de origem que o Merge Agent usa para enumerar as alterações da origem. A fonte é o Subscritor durante o carregamento e o Editor durante o download. O padrão é 3.

-StartQueueTimeoutstart_queue_timeout_seconds
É o número máximo de segundos que o Merge Agent aguarda quando o número de processos de mesclagem simultâneos em execução está no limite definido pela propriedade @max_concurrent_merge de sp_addmergepublication. Se o número máximo de segundos for atingido e o Merge Agent ainda estiver aguardando, ele será encerrado. Um valor de 0 significa que o agente aguarda indefinidamente, embora possa ser cancelado.

-SubscriberDatabasePathsubscriber_database_path
É o caminho para o banco de dados Jet (arquivo .mdb) se SubscriberType for 2 (permite uma conexão com um banco de dados Jet sem um nome de fonte de dados ODBC (DSN)).

-SubscriberDBAddOption [0| 1| 2| 3]
Especifica se há um banco de dados de Assinante existente.

-SubscriberLoginsubscriber_login
É o nome de login do Assinante. Se SubscriberSecurityMode for 0 (para Autenticação do SQL Server), esse parâmetro deverá ser especificado.

-SubscriberPasswordsubscriber_password
É a palavra-passe do Subscritor. Se SubscriberSecurityMode for 0 (para Autenticação do SQL Server), esse parâmetro deverá ser especificado.

-Modo de Segurança para Assinantes [ 0| 1]
Especifica o modo de segurança do Assinante. Um valor 0 indica a Autenticação do SQL Server (padrão) e um valor 1 indica o Modo de Autenticação do Windows.

-SubscritorConflitoLimpo [ 0| 1]
É se as tabelas de conflito forem limpas no Assinante durante o processo de sincronização, onde um valor de 1 indica que as tabelas de conflito no Assinante estão limpas. Este parâmetro é usado apenas para assinaturas de publicações com registro de conflitos descentralizado.

-Subscritor Tipo [ 0| 1| 3| 4| 5| 6| 7| 8]
Especifica o tipo de conexão de assinante usado pelo agente de mesclagem. Somente o valor padrão de 0 é suportado para esse parâmetro.

-Tipo de Subscrição[ 0| 1| 2]
Especifica o tipo de assinatura para distribuição. Um valor 0 indica uma subscrição push (predefinição), um valor de 1 indica uma subscrição pull e um valor de 2 indica uma subscrição anónima.

-SyncToAlternate [ 0|1]
Especifica se o Merge Agent está sincronizando entre um Assinante e um Publicador alternativo. Um valor de 1 indica que é um Editor alternativo. O padrão é 0.

-T [101|102]
Sinalizadores de rastreamento que habilitam funcionalidades adicionais para o Merge Agent. Um valor de 101 permite informações de log detalhadas adicionais para ajudar a determinar quanto tempo leva cada etapa do processo de sincronização de replicação de mesclagem. Um valor de 102 grava as mesmas estatísticas que o sinalizador de rastreamento 101 , mas no <servidor> de distribuição.. msmerge_history mesa em vez disso. Habilite o log do agente de mesclagem ao usar o sinalizador de rastreamento 101 usando os -output parâmetros e -outputverboselevel . Por exemplo, adicione os seguintes parâmetros ao agente de mesclagem e reinicie o agente: -T 101, -output, -outputverboselevel.

-UploadGenerationsPerBatchupload_generations_per_batch
É o número de gerações a serem processadas em um único lote durante o upload de alterações do Assinante para o Editor. Uma geração é definida como um grupo lógico de alterações por artigo. O padrão para um link de comunicação confiável é 100. O padrão para um link de comunicação não confiável é 1.

-UploadReadChangesPerBatchupload_read_changes_per_batch
É o número de alterações a serem lidas em um único lote durante o upload de alterações do Assinante para o Editor. O padrão é 100.

-UploadWriteChangesPerBatchupload_write_changes_per_batch
É o número de alterações a serem aplicadas em um único lote durante o upload de alterações do Assinante para o Editor. O padrão é 100.

-UseInprocLoader
Melhora o desempenho do snapshot inicial, fazendo com que o Merge Agent use o comando BULK INSERT ao aplicar arquivos de snapshot ao Assinante. Este parâmetro foi preterido porque não é compatível com o tipo de dados XML. Se você não estiver replicando dados XML, esse parâmetro poderá ser usado. Este parâmetro não pode ser usado com instantâneos de modo de caractere. Se você usar esse parâmetro, a conta de serviço do SQL Server no Assinante deverá ter permissões de leitura no diretório onde os arquivos de dados .bcp de instantâneo estão localizados. Quando esse parâmetro não é usado, o driver ODBC carregado pelo agente lê dos arquivos, portanto, o contexto de segurança da conta de serviço do SQL Server não é usado.

-Validar [0|1|2|3]
Especifica se a validação deve ser feita no final da sessão de mesclagem e, em caso afirmativo, que tipo de validação. O valor de 3 é o valor recomendado.

-ValidateIntervalvalidate_interval
É a frequência com que, em minutos, a subscrição é validada em modo contínuo. O padrão é 60 minutos.

Observações

Para iniciar o Merge Agent, execute replmerg.exe no prompt de comando. Para obter informações, consulte Executáveis do Replication Agent.

Solução de problemas de desempenho do Merge Agent

O histórico do agente de mesclagem da sessão atual não é removido durante a execução no modo contínuo. Um agente de longa duração pode resultar em um grande número de entradas nas tabelas de histórico de mesclagem que podem afetar o desempenho. Para resolver esse problema, alterne para o modo agendado ou continue a usar o modo contínuo, mas crie um trabalho dedicado para reiniciar periodicamente o agente de mesclagem ou reduza a detalhamento do nível de histórico para reduzir o número de linhas e, portanto, reduzir o impacto no desempenho.

Em alguns casos, o Replication Merge Agent pode levar muito tempo para replicar as alterações. Para determinar qual etapa do processo de sincronização de replicação de mesclagem leva mais tempo, use o sinalizador de rastreamento 101 juntamente com o log do agente de mesclagem. Para fazer isso, use os seguintes parâmetros para os parâmetros do agente de mesclagem e, em seguida, reinicie o agente:
-T 101
-realização
-outputverboselevel

Além disso, se você tiver que escrever estatísticas para o <servidor> de distribuição.. msmerge_history tabela, use o sinalizador de rastreamento -T 102.

Conteúdo relacionado

• Administração do agente de replicação