Replication Log Reader Agent

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çã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

Importante

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