Agente de registro del LOG de replicación

El Agente de registro del LOG de replicación es un archivo ejecutable que supervisa el registro de transacciones de cada base de datos configurada para la replicación transaccional y copia las transacciones marcadas para ser replicadas desde el registro de transacciones a la base de datos de distribución.

[!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

logread [-?] 
-Publisher server_name[\instance_name] 
-PublisherDB publisher_database 
[-Continuous]
[-DefinitionFile def_path_and_file_name]
[-Distributor server_name[\instance_name]]
[-DistributorLogin distributor_login]
[-DistributorPassword distributor_password]
[-DistributorSecurityMode [0|1]]
[-EncryptionLevel [0|1|2]]
[-ExtendedEventConfigFile configuration_path_and_file_name]
[-HistoryVerboseLevel [0|1|2]]
[-KeepAliveMessageInterval keep_alive_message_interval_seconds]
[-LoginTimeOut login_time_out_seconds]
[-LogScanThreshold scan_threshold]
[-MaxCmdsInTran number_of_commands]
[-MessageInterval message_interval]
[-Output output_path_and_file_name]
[-OutputVerboseLevel [0|1|2|3|4]]
[-PacketSize packet_size]
[-PollingInterval polling_interval]
[-ProfileName profile_name] 
[-PublisherFailoverPartner server_name[\instance_name] ]
[-PublisherSecurityMode [0|1]]
[-PublisherLogin publisher_login]
[-PublisherPassword publisher_password] 
[-QueryTimeOut query_time_out_seconds]
[-ReadBatchSize number_of_transactions] 
[-ReadBatchThreshold read_batch_threshold]
[-RecoverFromDataErrors]

Argumentos

• -?
  Muestra información de uso.

• -Publisher server_name[**\instance_name]
  Es el nombre del publicador. Especifique server_name para conectarse a la instancia predeterminada de Microsoft SQL Server en ese servidor. Especifique server_name\**instance_name para la instancia predeterminada de SQL Server en ese servidor.

• -PublisherDB publisher_database
  Es el nombre de la base de datos del publicador.

• -Continuous
  Especifica si el agente intenta sondear las transacciones replicadas continuamente. Si se especifica, el agente sondea las transacciones replicadas del origen en intervalos de sondeo, aunque no haya ninguna transacción pendiente.

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

• -Distributor server_name[**\instance_name]
  Es el nombre del distribuidor. Especifique server_name para conectarse a la instancia predeterminada de SQL Server en ese servidor. Especifique server_name\**instance_name para la instancia predeterminada de SQL Server en ese servidor.

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

• -DistributorPassword distributor_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 Microsoft Windows.

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

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

• -ExtendedEventConfigFile configuration_path_and_file_name
  Especifica el nombre y la ruta del archivo para el archivo de configuración XML de eventos extendidos. El archivo de configuración de eventos extendidos le permite configurar sesiones y habilitar eventos para su seguimiento.

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

  Valor HistoryVerboseLevel	Descripción
  0
  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 los nuevos registros de historial a menos que el registro sea para mensajes inactivos o mensajes de trabajos de ejecución prolongada, en cuyo caso debe actualizar los registros anteriores.

• -KeepAliveMessageInterval keep_alive_message_interval_seconds
  Es el número de segundos antes de que el subproceso del historial compruebe si cualquiera de las conexiones existentes está esperando una respuesta del servidor. Este valor se puede reducir para evitar que la comprobación del agente marque al agente de registro del LOG como sospechoso al ejecutar un lote de ejecución prolongada. El valor predeterminado es 300 segundos.

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

• -LogScanThreshold scan_threshold
  Solo para uso interno.

• -MaxCmdsInTran number_of_commands
  Especifica el número máximo de instrucciones agrupadas en una transacción cuando el Agente de registro del LOG escribe comandos en la base de datos de distribución. El uso de este parámetro permite al Agente de registro del LOG y al Agente de distribución dividir las transacciones grandes (compuestas por muchos comandos) del publicador en varias transacciones más pequeñas cuando se aplican en el suscriptor. Especificando este parámetro se puede reducir la contención en el distribuidor y la latencia entre el publicador y el suscriptor. Puesto que la transacción original se aplica en unidades más pequeñas, el suscriptor puede obtener acceso a las filas de una transacción lógica del publicador de gran tamaño antes de que finalice la transacción original, lo que interrumpe la estricta atomicidad transaccional. El valor predeterminado es 0, que conserva los límites de la transacción del publicador.

  [!NOTA]

  Este parámetro se omite para las publicaciones que no son de SQL Server. Para obtener más información, vea la sección "Configurar el trabajo del conjunto de transacciones" en Optimizar el rendimiento de publicadores de Oracle.

• -MessageInterval message_interval
  Es el intervalo de tiempo utilizado para el registro del historial. Un evento del historial se registra cuando se alcanza el valor de MessageInterval una vez registrado el último evento de historial.

  Si no hay ninguna transacción replicada disponible en el origen, el agente envía un mensaje de no transacción al distribuidor. Esta opción especifica cuánto tiempo espera el agente para enviar otro mensaje que indica que no hay ninguna transacción. Los agentes siempre envían un mensaje que indica que no hay ninguna transacción cuando detectan que no hay ninguna transacción disponible en el origen después de procesar previamente las transacciones replicadas. El valor predeterminado es 60 segundos.

• -Output output_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 | 3 | 4 ]
  Especifica si el resultado debería ser detallado.

  Valor	Descripción
  0	Solo se imprimen los mensajes de error.
  1	Se imprimen todos los mensajes de informe de progreso de agente.
  2 (predeterminado)	Se imprimen todos los mensajes de error y mensajes de informe de progreso de agente.
  3	Se imprimen los primeros 100 bytes de cada comando replicado.
  4	Se imprimen todos los comandos replicados.

  Valora 2-4 son útiles al depurar.

• -PacketSize packet_size
  Es el tamaño del paquete, en bytes. El valor predeterminado es 4096 (bytes).

• -PollingInterval polling_interval
  Es la frecuencia, en segundos, con la que el registro recibe consultas de transacciones replicadas. El valor predeterminado es 5 segundos.

• -ProfileName profile_name
  Especifica un perfil de agente para utilizar para los parámetros del agente. Si ProfileName es NULL, el perfil de agente se deshabilita. Si no se especifica ProfileName, se utiliza el perfil predeterminado para el tipo de agente. Para obtener información, vea Perfiles del Agente de replicación.

• -PublisherFailoverPartner server_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 (SQL Server).

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

• -PublisherLogin publisher_login
  Es el nombre de inicio de sesión del publicador.

• -PublisherPassword publisher_password
  Es la contraseña del publicador.

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

• -ReadBatchSize number_of_transactions
  Es el número máximo de transacciones leídas del registro de transacciones de la base de datos de publicación por ciclo de procesamiento, con un valor predeterminado de 500. El agente continuará leyendo las transacciones en lotes hasta que se lean todas las transacciones del registro. Este parámetro no se admite en publicadores de Oracle.

• -ReadBatchThreshold number_of_commands
  Es el número de comandos de replicación que se deben leer del registro de transacciones antes de que el Agente de distribución las envíe al Suscriptor. El valor predeterminado es 0. Si no se especifica este parámetro, el Agente de registro del LOG leerá al final del registro o al número especificado en -ReadBatchSize (número de transacciones).

• -RecoverFromDataErrors
  Especifica que el Agente de registro del LOC continúe ejecutándose cuando encuentra errores en datos de columna publicados en un Publicador que no es de SQL Server. De forma predeterminada, tales errores hacen el Agente de registro del LOG devuelva un error. Al utilizar -RecoverFromDataErrors, los datos de columna erróneos se replican como NULL o un valor nonnull adecuado y los mensajes de advertencia se registran en la tabla MSlogreader_history. Este parámetro solamente se admite en publicadores de Oracle.

Comentarios

Importante

Si ha instalado el agente de SQL Server para que se ejecute en una cuenta de sistema local en lugar de debajo de una cuenta de usuario de dominio (el valor predeterminado), el servicio puede tener acceso solamente al equipo local. Si el Agente de registro del LOG que se ejecuta en el agente de SQL Server se configura para utilizar el modo de autenticación de Windows cuando inicia sesión en una instancia de SQL Server, el Agente de registro del LOC devuelve un error. La configuración predeterminada es la autenticación de SQL Server. Para obtener más información acerca de cómo cambiar cuentas de seguridad, vea Ver y modificar la configuración de seguridad de la replicación.

Para iniciar el Agente de registro del LOG, ejecute logread.exe en el símbolo del sistema. Para obtener información, vea Conceptos de los ejecutables del Agente de replicación.

Vea también

Conceptos

Administración del Agente de replicación

Historial de cambios