Agente de Leitor de Fila de Replicação
Aplica-se a: 
SQL Server
Queue Reader Agent de replicação é um executável que lê mensagens armazenadas em uma fila do Microsoft SQL Server ou do Microsoft Message Queuing e, depois, aplica essas mensagens ao publicador. O Queue Reader Agent é usado com publicações de instantâneo e transacionais que permitem atualização em fila.
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
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]]
Argumentos
-?
Exibe informações de uso.
-Continuous
Especifica se o agente tenta processar transações em fila continuamente. Se especificado, o agente continua a execução, mesmo que não haja transações na fila pendentes de nenhum dos assinantes.
-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 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. Se não for especificado, o nome assumirá o padrão do nome da instância padrão do SQL Server no computador local.
-DistributionDB distribution_database
É o banco de dados de distribuição.
-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 Windows.
-EncryptionLevel [ 0 | 1 | 2 ]
É o nível da criptografia com protocolo TLS, anteriormente conhecido como protocolo SSL, usada pelo Queue Reader Agent ao fazer conexões.
| Valor EncryptionLevel | Descrição |
|---|---|
| 0 | Especifica que o TLS não é usado. |
| 1 | Especifica que o TLS é usado, mas que o agente não verifica se o certificado de servidor TSL/SSL é assinado por um emissor confiável. |
| 2 | Especifica que o TLS é usado e que o certificado é verificado. |
Observação
É definido um certificado TLS/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.
Confira mais informações em Exibir e modificar as configurações de replicação de segurança.
-HistoryVerboseLevel [ 0| 1| 2| 3]
Especifica a quantidade de histórico registrada durante uma operação de leitura de fila. Você pode minimizar o efeito de registro de histórico no desempenho selecionando 1.
| Valor HistoryVerboseLevel | Descrição |
|---|---|
| 0 | Nenhum log de histórico (não recomendado). |
| 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, incluindo mensagens ociosas ou mensagens de trabalho de execução longa. |
| 3 | Insira novos registros de histórico que incluam detalhes adicionais que podem ser úteis na solução de problemas. |
-LoginTimeOut login_time_out_seconds
É o número de segundos antes de o logon atingir o tempo limite. O padrão é 15 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]
Especifica se a saída deve ser detalhada. Se o nível detalhado for 0, só mensagens de erro serão impressas. Se o nível detalhado for 1, todas as mensagens de relatório de progresso serão impressas. Se o nível detalhado for 2 (padrão), todas as mensagens de erro e de relatório de progresso serão impressas, o que é útil na depuração.
-PollingInterval polling_interval
É relevante apenas para assinaturas de atualização que usam filas com base no SQL Server. Especifica com que frequência, em segundos, a fila do SQL Server é sondada para transações em fila pendentes. O valor pode ser entre 0 e 240 segundos. O padrão é 5 segundos.
-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).
-ProfileName agent_profile_name
É o nome de um perfil de agente usado para fornecer um conjunto de valores padrão ao agente. Para obter mais informações, consulte Perfis do agente de replicação.
-QueryTimeOut query_time_out_seconds
É o número de segundos antes do tempo limite da consulta. O padrão é 1800 segundos.
-ResolverState [ 1| 2| 3]
Especifica como conflitos de atualização na fila são resolvidos. Um valor 1 indica que o Publicador ganha o conflito, a transação na fila conflitante será revertida no Publicador e no Assinante de atualização de origem e o processo de transações subsequentes em fila continuará. Um valor 2 indica que o Assinante ganha o conflito e a transação na fila substituirá os valores no Publicador. Um valor 3 indica que qualquer conflito resultará na reinicialização do Assinante; o Publicador ganha o conflito, o processamento de transações subsequentes na fila será interrompido e a assinatura será reiniciada. A configuração padrão é 1 para publicações transacionais e 3 para publicações de instantâneo.
Comentários
Para iniciar o Queue Reader Agent, execute qrdrsvc.exe no prompt de comando. Para obter informações, consulte Executáveis do agente de replicação.