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.
.gif "Observação") Observaçã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çãoEsse 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
.gif "Observação importante") 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.