Partilhar via


Agente do leitor de filas de replicação

Aplica-se a:SQL Server

O Replication Queue Reader Agent é um executável que lê mensagens armazenadas em uma fila do Microsoft SQL Server ou em uma fila de mensagens da Microsoft e, em seguida, aplica essas mensagens ao Publicador. O Queue Reader Agent é utilizado com publicações instantâneas e transacionais que permitem atualizações em fila.

Observação

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

Sintaxe

  
qrdrsvc [-?]  
[-Continuous]  
[-DefinitionFile definition_file]  
[-Distributor server_name[\instance_name]]  
[-DistributionDB distribution_database]  
[-DistributorLogin distributor_login]  
[-DistributorPassword distributor_password]  
[-DistributorSecurityMode [0|1]]  
[-EncryptionLevel [0|1|2]]  
[-HistoryVerboseLevel [0|1|2|3]]  
[-LoginTimeOut login_time_out_seconds]  
[-Output output_path_and_file_name]  
[-OutputVerboseLevel [0|1|2]]  
[-PollingInterval polling_interval]  
[-PublisherFailoverPartner server_name[\instance_name] ]  
[-ProfileName agent_profile_name]  
[-QueryTimeOut query_time_out_seconds]  
[-ResolverState [1|2|3]]  

Arguments

-?
Exibe informações de uso.

-Em contínuo
Especifica se o agente tenta processar transações enfileiradas continuamente. Se especificado, o agente continua a execução mesmo se não houver transações em fila pendentes de qualquer um dos assinantes.

-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 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. Se não for especificado, o nome assume como padrão o nome da instância padrão do SQL Server no computador local.

-DistributionDBdistribution_database
É o banco de dados de distribuição.

-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.

-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 Queue Reader Agent ao fazer conexões.

EncryptionLevel valor Description
0 Especifica que o TLS não é usado.
1 Especifica que o TLS é usado, mas o agente não verifica se o certificado do servidor TLS/SSL está assinado por um emissor confiável.
2 Especifica que o TLS é usado e que o certificado é verificado.
3 Não há suporte, porque a opção 3 é específica para conexões com a Instância Gerenciada SQL do Azure e o agente leitor de filas não é suportado com a Instância Gerenciada SQL do Azure.
4 Especifica que, para conexões do SQL Server 2025 e versões posteriores com o SQL Server (qualquer versão com suporte), o TLS 1.3 é usado e o certificado é verificado. Requer a instalação do certificado em hosts do SQL Server que estão recebendo conexões com EncryptionLevel set como 4.

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 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 Exibir e modificar configurações de segurança de replicação.

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

HistoryVerboseLevel valor Description
0 Nenhum registro de histórico (não recomendado).
1 Default. Sempre atualize uma mensagem de histórico anterior do mesmo status (inicialização, progresso, sucesso e assim por diante). Se não existir nenhum registo anterior com o mesmo estado, insira um novo registo.
2 Insira novos registros de histórico, incluindo mensagens ociosas ou mensagens de trabalho de longa duração.
3 Insira novos registros de histórico que incluam detalhes adicionais que podem ser úteis para a solução de problemas.

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

-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.

-PollingIntervalpolling_interval
É relevante apenas para atualizar assinaturas que usam filas baseadas no SQL Server. Especifica com que frequência, em segundos, a fila do SQL Server é pesquisada para transações pendentes na fila. O valor pode ser entre 0 e 240 segundos. O padrão é 5 segundos.

-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).

-ProfileNameagent_profile_name
É o nome de um perfil de agente usado para fornecer um conjunto de valores padrão ao agente. Para obter informações, consulte Perfis do agente de replicação.

-QueryTimeOutquery_time_out_seconds
É o número de segundos antes do tempo limite da consulta. O padrão é 1800 segundos.

-Estado do Resolvedor [ 1| 2| 3]
Especifica como os conflitos de atualização em fila são resolvidos. Um valor de 1 indica que o Editor vence o conflito e a transação em fila conflitante atual será revertida no Editor e no Assinante de atualização de origem; O processamento das transações subsequentes em fila continuará. Um valor de 2 indica que o Assinante vence o conflito e a transação enfileirada substituirá os valores no Editor. Um valor de 3 indica que qualquer conflito resultará na reinicialização do Assinante; o Editor vence o conflito, o processamento das transações subsequentes em fila será encerrado e a assinatura será reinicializada. A configuração padrão é 1 para publicações transacionais e 3 para publicações instantâneas.

Observações

Para iniciar o Queue Reader Agent, execute qrdrsvc.exe a partir do prompt de comando. Para obter informações, consulte Executáveis do Replication Agent.