Partilhar via


Replication Log Reader Agent

O Replication Log Reader Agent é um executável que monitora o log de transações de cada banco de dados configurado para replicação transacional e copia as transações marcadas para replicação do log de transações no banco de dados de distribuição.

ObservaçãoObservação

Os parâmetros podem ser especificados em qualquer ordem. Quando não são especificados parâmetros opcionais, valores predefinidos com base no perfil de agente padrão são usados.

Sintaxe

logread [-?] 
-Publisher server_name[\instance_name] 
-PublisherDB publisher_database 
[-Continuous]
[-DefinitionFile def_path_and_file_name]
[-Distributor server_name[\instance_name]]
[-DistributorLogin distributor_login]
[-DistributorPassword distributor_password]
[-DistributorSecurityMode [0|1]]
[-EncryptionLevel [0|1|2]]
[-HistoryVerboseLevel [0|1|2]]
[-KeepAliveMessageInterval keep_alive_message_interval_seconds]
[-LoginTimeOut login_time_out_seconds]
[-LogScanThreshold scan_threshold]
[-MaxCmdsInTran number_of_commands]
[-MessageInterval message_interval]
[-Output output_path_and_file_name]
[-OutputVerboseLevel [0|1|2|3|4]]
[-PacketSize packet_size]
[-PollingInterval polling_interval]
[-ProfileName profile_name] 
[-PublisherFailoverPartner server_name[\instance_name] ]
[-PublisherSecurityMode [0|1]]
[-PublisherLogin publisher_login]
[-PublisherPassword publisher_password] 
[-QueryTimeOut query_time_out_seconds]
[-ReadBatchSize number_of_transactions] 
[-ReadBatchThreshold read_batch_threshold]
[-RecoverFromDataErrors]

Argumentos

  • -?
    Exibe informações de uso.

  • -Publisherserver_name[**\instance_name]
    É o nome do Publicador. Especifica o server_name para a instância padrão do Microsoft SQL Server naquele servidor. Especifica o server_name
    \**instance_name para uma instância nomeada do SQL Server naquele servidor.

  • -PublisherDBpublisher_database
    É o nome do banco de dados Publicador.

  • -Continuous
    Especifica se o agente tenta ou não sondar transações replicadas continuamente. Se especificado, o agente sondará as transações replicadas da origem em intervalos de sondagem, mesmo que não haja transações pendentes.

  • -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 linha de comando para o agente. O conteúdo do arquivo é analisado como um arquivo executável. Use aspas duplas (") para especificar os valores de argumentos que contêm caracteres arbitrários.

  • -Distributorserver_name[**\instance_name]
    É o nome do Distribuidor. Especifica o server_name para a instância padrão do SQL Server naquele servidor. Especifica o server_name
    \**instance_name para uma instância nomeada do SQL Server nesse servidor.

  • -DistributorLogindistributor_login
    É o nome de logon do Distribuidor.

  • -DistributorPassworddistributor_password
    É a senha do Distribuidor.

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

  • -EncryptionLevel [ 0 | 1 | 2 ]
    É o nível da criptografia SSL (Secure Sockets Layer) usada pelo Log Reader Agent ao fazer conexões.

    Valor EncryptionLevel

    Descrição

    0

    Especifica que o SSL não é usado.

    1

    Especifica que o SSL é usado, mas o agente não verifica se o certificado de servidor SSL é assinado por um emissor confiável.

    2

    Especifica que o SSL é usado e que o certificado é verificado.

    Para obter mais informações, consulte Visão geral de segurança (Replicação).

  • -HistoryVerboseLevel [ 0| 1| 2]
    Especifica a quantidade de histórico registrada durante uma operação de leitura de log. Você pode minimizar o efeito de desempenho do registro de histórico selecionando 1.

    Valor HistoryVerboseLevel

    Descrição

    0

     

    1

    Padrão. Sempre atualize uma mensagem de histórico anterior do mesmo status (inicialização, progresso, sucesso e assim por diante). Se não existir registro anterior com o mesmo status, insira um registro novo.

    2

    Insira novos registros de histórico, exceto se o registro for para itens como mensagens ociosas ou mensagens de trabalho de execução longa; nesse caso, atualize os registros anteriores.

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

  • -LoginTimeOutlogin_time_out_seconds
    É o número de segundos antes que o logon expire. O padrão é 15 segundos.

  • -LogScanThresholdscan_threshold
    Somente para uso interno.

  • -MaxCmdsInTrannumber_of_commands
    Especifica o número máximo de instruções agrupadas em uma transação à medida que o Log Reader grava comandos no banco de dados de distribuição. O uso desse parâmetro permite que o Log Reader Agent e o Distribution Agent divida grandes transações (consistindo em muitos comandos) no Publicador em várias transações menores quando aplicadas no Assinante. A especificação desse parâmetro pode reduzir a contenção no Distribuidor e pode reduzir a latência entre o Publicador e o Assinante. Como a transação original é aplicada em unidades menores, o Assinante pode acessar linhas de uma transação lógica de Publicador antes do fim da transação original, O padrão é 0, que preserva os limites de transação do Publicador.

    ObservaçãoObservação

    Esse parâmetro é ignorado para publicações que não são do SQL Server. Para obter mais informações, consulte a seção que "Configurando o trabalho de conjunto das transações" em Ajuste de desempenho para Editores Oracle.

  • -MessageIntervalmessage_interval
    É o intervalo de tempo usado para registro de histórico. Um evento de histórico é registrado quando o valor MessageInterval é alcançado depois que o ultimo evento de histórico é registrado.

    Se não houver nenhuma transação replicada disponível na origem, o agente informará uma mensagem de não-transação ao Distribuidor. Essa opção especifica o tempo de espera do agente, antes de informar outra mensagem de não-transação. O agente sempre informa uma mensagem de não-transação quando detecta que não há transações disponíveis na origem após transações replicadas de processamento anterior. O padrão é 60 segundos.

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

  • -OutputVerboseLevel [ 0| 1| 2 | 3 | 4 ]
    Especifica se a saída deve ser detalhada.

    Valor

    Descrição

    0

    Somente mensagens de erro são impressas.

    1

    Todas as mensagens de relatório de progresso do agente são impressas.

    2 (padrão)

    Todas as mensagens de relatório de progresso do agente e de erro são impressas.

    3

    Os primeiros 100 bytes de cada comando replicado são impressos.

    4

    Todos os comandos replicados são impressos.

    Os valores 2-4 são úteis na depuração.

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

  • -PollingIntervalpolling_interval
    É a freqüência, em segundos, que o log é consultado para transações replicadas. O padrão é 5 segundos.

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

  • -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 Replicação e espelhamento do banco de dados.

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

  • -PublisherLoginpublisher_login
    É o nome de logon do Publicador.

  • -PublisherPasswordpublisher_password
    É a senha do Publicador.

  • -QueryTimeOutquery_time_out_seconds
    É o número de segundos antes que a consulta expire. O padrão é 1800 segundos.

  • -ReadBatchSizenumber_of_transactions
    É o número máximo de transações lidas de um log de transações do banco de dados de publicação por ciclo de processamento, com um padrão de 500. O agente continuará lendo transações em lotes até que todas as transações tenham sido lidas do log. Esse parâmetro não tem suporte para Editores Oracle .

  • -ReadBatchThresholdnumber_of_commands
    É o número de comandos de replicação a serem lidos no log de transações, antes de ser emitido para o Assinante pelo Distribution Agent. O padrão é 0. Se o parâmetro não for especificado, o Log Reader Agent lerá até a parte final do log ou até o número especificado em -ReadBatchSize (número de transações).

  • -RecoverFromDataErrors
    Especifica que o Log Reader Agent continuará a executar, quando encontrar erros em dados de colunas publicados de um Publicador não-SQL Server. Por padrão, tais erros fazem o Log Reader Agent falhar. Quando você usa -RecoverFromDataErrors, dados de coluna são replicados erroneamente como NULL ou como um valor não nulo apropriado e as mensagens de aviso são registradas na tabela MSlogreader_history. Esse parâmetro só tem suporte para Editores Oracle .

Comentários

Observação importanteImportante

Se você instalou o SQL Server Agent para executar em uma conta de sistema local em vez de em uma conta de usuário de domínio (o padrão), o serviço só poderá acessar o computador local. Se o Log Reader Agent executado no SQL Server Agent for configurado para usar o Modo de Autenticação do Windows ao fazer logon noSQL Server, o Log Reader Agent falhará. A configuração padrão é Autenticação do SQL Server. Para obter informações em como alterar contas de segurança, consulte Como exibir e modificar propriedades de segurança de replicação (Programação Transact-SQL de replicação).

Para iniciar o Log Reader Agent, execute logread.exe no prompt de comando. Para obter informações, consulte Conceitos dos executáveis do Replication Agent.

Consulte também

Conceitos