Replication Queue Reader Agent

O Replication Queue Reader Agent é um executável que lê mensagens armazenadas em uma fila do Microsoft SQL Server ou Microsoft Message Queue e aplica essas mensagens no 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.

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

• -Distributorserver_name[**\**instance_name]
  É o nome do Distribuidor. Especifique server_name para a instância padrão do SQL Server naquele servidor. Especifique server_name\instance_name para uma instância nomeada do SQL Server naquele 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.

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

• -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 de 0 indica Modo (padrão) de Autenticação do SQL Server e um valor de 1 indica Modo de Autenticação do Windows.

• -EncryptionLevel [ 0 | 1 | 2 ]
  É o nível da criptografia SSL (Secure Sockets Layer) usada pelo Queue 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 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.

  Para obter mais informações, consulte Visão geral de segurança (Replicação).

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

• -LoginTimeOutlogin_time_out_seconds
  É o número de segundos antes que o logon expire. O padrão é 15 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]
  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.

• -PollingIntervalpolling_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, 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 que a consulta expire. 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.

Consulte também

Conceitos

Administração do agente de replicação