Agente de lectura de cola de replicación

El Agente de lectura de cola de replicación es una aplicación ejecutable que lee los mensajes almacenados en una cola de Microsoft SQL Server o Microsoft Message Queue y, a continuación, aplica esos mensajes al Publicador. El Agente de lectura de cola se utiliza con la instantánea y las publicaciones transaccionales que permiten la actualización en cola.

Nota

Los parámetros se pueden especificar en cualquier orden. Cuando no se especifican parámetros opcionales, se utilizan valores predefinidos basados en el perfil de agente predeterminado.

Sintaxis

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

  • -?
    Muestra información de uso.

  • -Continuous
    Especifica si el agente intenta procesar continuamente las transacciones en cola. Si se especifica, el agente continúa la ejecución incluso si no hay transacciones en cola pendientes de cualquiera de los suscriptores.

  • -DefinitionFiledef_path_and_file_name
    Es la ruta de acceso del archivo de definición de agente. Un archivo de definición de agente contiene los argumentos de línea de comandos para el agente. El contenido del archivo se analiza como un archivo ejecutable. Utilice las comillas tipográficas (") para especificar valores de argumento que contienen caracteres arbitrarios.

  • -Distributorserver_name[**\**instance_name]
    Es el nombre del distribuidor. Especifique server_name para la instancia predeterminada de SQL Server en ese servidor. Especifique server_name\instance_name para una instancia con nombre de SQL Server en ese servidor. Si no se especifica, el nombre tiene como valor predeterminado el nombre de la instancia predeterminada de SQL Server en el equipo local.

  • -DistributionDBdistribution_database
    Es la base de datos de distribución.

  • -DistributorLogindistributor_login
    Es el nombre de inicio de sesión del distribuidor.

  • -DistributorPassworddistributor_password
    Es la contraseña del distribuidor.

  • -DistributorSecurityMode [ 0| 1]
    Especifica el modo de seguridad del distribuidor. Un valor de 0 hace referencia a la autenticación de SQL Server (valor predeterminado) y un valor de 1 hace referencia al modo de autenticación de Windows.

  • -EncryptionLevel [ 0 | 1 | 2 ]
    Es el nivel de cifrado de Capa de sockets seguros (SSL) utilizado por el Agente de lectura de cola cuando realiza conexiones.

    Valor EncryptionLevel

    Descripción

    0

    Especifica que no se utiliza SSL.

    1

    Especifica que se utiliza SSL, pero el agente no comprueba que un emisor confiable haya firmado el certificado del servidor SSL.

    2

    Especifica que se utiliza SSL, y que se ha comprobado el certificado.

    Para obtener más información, vea Información general sobre seguridad (replicación).

  • -HistoryVerboseLevel [ 0| 1| 2| 3]
    Especifica la cantidad de historial registrado durante una operación del lector de cola. Puede minimizar el efecto sobre el rendimiento del registro del historial seleccionando 1.

    Valor HistoryVerboseLevel

    Descripción

    0

    Ningún registro del historial (no se recomienda).

    1

    Predeterminado. Siempre actualiza un mensaje del historial anterior del mismo estado (inicio, progreso, éxito, etc.). Si no existe ningún registro anterior con el mismo estado, inserte un nuevo registro.

    2

    Inserte nuevos registros del historial, incluso mensajes inactivos o mensajes del trabajo de ejecución prolongada.

    3

    Inserte nuevos registros de historial que incluyen detalles adicionales que pueden ser útiles para solucionar problemas.

  • -LoginTimeOutlogin_time_out_seconds
    Es el número de segundos antes de que el inicio de sesión exceda el tiempo de espera. El valor predeterminado es 15 segundos.

  • -Outputoutput_path_and_file_name
    Es la ruta de acceso del archivo de salida del agente. Si no se proporciona un nombre de archivo, el resultado se envía a la consola. Si el nombre de archivo especificado existe, el resultado se anexa al archivo.

  • -OutputVerboseLevel [ 0| 1| 2]
    Especifica si el resultado debería ser detallado. Si el nivel detallado es 0, sólo se imprimen los mensajes de error. Si el nivel detallado es 1, se imprimen todos los mensajes del informe de progreso. Si el nivel detallado es 2 (valor predeterminado), se imprimen todos los mensajes de error y mensajes del informe de progreso, lo que es útil para la depuración.

  • -PollingIntervalpolling_interval
    Sólo es pertinente para actualizar las suscripciones que utilizan colas basadas en SQL Server. Especifica la frecuencia, en segundos, con la que se sondea la cola SQL Server las transacciones en cola pendientes. El valor puede estar comprendido entre 0 y 240 segundos. El valor predeterminado es 5 segundos.

  • -PublisherFailoverPartnerserver_name[**\**instance_name]
    Especifica la instancia del asociado de conmutación por error de SQL Server que participa en una sesión de creación de reflejo de la base de datos con la base de datos de publicación. Para obtener más información, vea Replicación y creación de reflejo de la base de datos.

  • -ProfileNameagent_profile_name
    Es el nombre de un perfil de agente utilizado para proporcionar un conjunto de valores predeterminados al agente. Para obtener información, vea Perfiles del Agente de replicación.

  • -QueryTimeOutquery_time_out_seconds
    Es el número de segundos antes de que la consulta exceda el tiempo de espera. El valor predeterminado es 1800 segundos.

  • -ResolverState [ 1| 2| 3]
    Especifica cómo se resuelven los conflictos de actualización en cola. Un valor de 1 indica que el Publicador gana el conflicto, y la transacción en cola actual que está en conflicto se revertirá en el Publicador y el Suscriptor que originó la actualización; el procesamiento de las transacciones en cola posteriores continuará. Un valor de 2 indica que el Suscriptor gana el conflicto, y la transacción en cola invalidará los valores en el Publicador. Un valor de 3 indica que cualquier conflicto provocará la reinicialización del Suscriptor; el Publicador gana el conflicto, se finalizará el proceso de las transacciones en cola subsiguientes y se reinicializará la suscripción. La configuración predeterminada es 1 para las publicaciones transaccionales y 3 para las publicaciones de instantáneas.

Comentarios

Para iniciar el Agente de lectura de cola, ejecute qrdrsvc.exe en el símbolo del sistema. Para obtener información, vea Aplicaciones ejecutables del Agente de replicación.

Vea también

Conceptos