Agente do Leitor de Log de Replicação
O Agente de Leitor de Log de Replicação é 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ção
Os parâmetros podem ser especificados em qualquer ordem. Quando não são especificados parâmetros opcionais, são usados valores predefinidos com base no perfil de agente padrão.
Sintaxe
logread [-?]
-Publisherserver_name[\instance_name]
-PublisherDBpublisher_database
[-Continuous]
[-DefinitionFiledef_path_and_file_name]
[-Distributorserver_name[\instance_name]]
[-DistributorLogindistributor_login]
[-DistributorPassworddistributor_password]
[-DistributorSecurityMode [0|1]]
[-EncryptionLevel [0|1|2]]
[-ExtendedEventConfigFileconfiguration_path_and_file_name]
[-HistoryVerboseLevel [0|1|2]]
[-KeepAliveMessageIntervalkeep_alive_message_interval_seconds]
[-LoginTimeOutlogin_time_out_seconds]
[-LogScanThresholdscan_threshold]
[-MaxCmdsInTrannumber_of_commands]
[-MessageIntervalmessage_interval]
[-Outputoutput_path_and_file_name]
[-OutputVerboseLevel [0|1|2|3|4]]
[-PacketSizepacket_size]
[-PollingIntervalpolling_interval]
[-ProfileNameprofile_name]
[-PublisherFailoverPartnerserver_name[\instance_name] ]
[-PublisherSecurityMode [0|1]]
[-PublisherLoginpublisher_login]
[-PublisherPasswordpublisher_password]
[-QueryTimeOutquery_time_out_seconds]
[-ReadBatchSizenumber_of_transactions]
[-ReadBatchThresholdread_batch_threshold]
[-RecoverFromDataErrors]
Argumentos
-?
Exibe informações de uso.
-Publisher server_name[\instance_name]
É o nome do Publicador. Especifique server_name para a instância padrão do Microsoft SQL Server nesse servidor. Especifique server_name\instance_name para conectar-se a uma instância nomeada do SQL Server nesse servidor.
-PublisherDB publisher_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.
-DefinitionFile def_path_and_file_name
É o caminho do arquivo de definição de 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.
-Distributor server_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 conectar-se a uma instância nomeada do SQL Server nesse servidor.
-DistributorLogin distributor_login
É o nome de logon do Distribuidor.
-DistributorPassword distributor_password
É a senha do Distribuidor.
-DistributorSecurityMode [ 0| 1]
Especifica o modo de segurança do Distribuidor. Um valor de 0 indica o Modo de Autenticação do SQL Server (padrão) e um valor de 1 indica o Modo de Autenticação do Microsoft Windows.
-EncryptionLevel [ 0 | 1 | 2 ]
É o nível da criptografia SSL (Secure Sockets Layer) usada pelo Agente de Leitor de Log ao fazer conexões.
| Valor EncryptionLevel | Descrição |
|---|---|
| 0 | Especifica que o SSL não é usado. |
| 1 | Especifica que o SSL é usado, mas que +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. |
Observação
É definido um certificado SSL válido com um nome de domínio totalmente qualificado do SQL Server. Para que o agente seja conectado com êxito ao definir -EncryptionLevel como 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 Segurança de replicação do SQL Server.
-ExtendedEventConfigFile configuration_path_and_file_name
Especifica o caminho e o nome do arquivo de configuração XML de eventos estendidos. O arquivo de configuração de eventos estendidos permite configurar sessões e habilitar eventos para acompanhamento.
-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 atualiza uma mensagem de histórico anterior do mesmo status (inicialização, andamento, êxito, etc.). Se nenhum registro anterior com o mesmo status existir, insira um registro novo. |
| 2 | Insira novos registros de histórico, a menos que o registro seja para coisas como mensagens ociosas ou mensagens de trabalho de execução longa; em tal caso, atualize os registros anteriores. |
-KeepAliveMessageInterval keep_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 Agente de Leitor de Log como suspeito ao executar um lote de execução longa. O padrão é 300 segundos.
-LoginTimeOut login_time_out_seconds
É o número de segundos antes de o logon atingir o tempo limite. O padrão é 15 segundos.
-LogScanThreshold scan_threshold
Somente para uso interno.
-MaxCmdsInTran number_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 Agente de Leitor de Log e o Agente de Distribuição 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 Performance Tuning for Oracle Publishers.
-MessageInterval message_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 Distributor. Essa opção especifica quanto tempo o agente espera antes de informar outro 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.
-Output output_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.
-PacketSize packet_size
É o tamanho do pacote, em bytes. O padrão é 4096 (bytes).
-PollingInterval polling_interval
É a frequência, em segundos, que o log é consultado para transações replicadas. O padrão é 5 segundos.
-ProfileName profile_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 mais informações, consulte Perfis do agente de replicação.
-PublisherFailoverPartner server_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, confira Espelhamento e replicação de banco de dados (SQL Server).
-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 o Modo de Autenticação do Windows.
-PublisherLogin publisher_login
É o nome de logon do Publicador.
-PublisherPassword publisher_password
É a senha do Publicador.
-QueryTimeOut query_time_out_seconds
É o número de segundos antes do tempo limite da consulta. O padrão é 1800 segundos.
-ReadBatchSize number_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.
-ReadBatchThreshold number_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 Agente de Distribuição. O padrão é 0. Se o parâmetro não for especificado, o Agente de Leitor de Log lerá até a parte final do log ou até o número especificado em -ReadBatchSize (número de transações).
-RecoverFromDataErrors
Especifica que o Agente de Leitor de Log 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 Agente de Leitor de Log 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 com uma conta Sistema Local em vez de uma conta de usuário de domínio (o padrão), o serviço só poderá acessar o computador local. Se o Agente de Leitor de Log executado no SQL Server Agent estiver configurado para usar o modo de autenticação do Windows ao fazer logon no SQL Server, o Agente de Leitor de Log falhará. A configuração padrão é Autenticação do SQL Server. Para obter informações em como alterar contas de segurança, consulte View and Modify Replication Security Settings.
Para iniciar o Agente de Leitor de Log, execute logread.exe no prompt de comando. Para obter informações, consulte Conceitos dos executáveis do agente de replicação.
Histórico de alterações
| Conteúdo atualizado |
|---|
| Adicionado o parâmetro -ExtendedEventConfigFile . |