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]]
[-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.-Publisherserver_name[**\instance_name]
Es el nombre del publicador. Especifique server_name para conectarse a la instancia predeterminada del MicrosoftSQL Server en ese servidor. Especifique server_name\**instance_name para la instancia predeterminada de SQL Server en ese servidor.-PublisherDBpublisher_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.-Distributorserver_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.-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 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 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]
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.
-KeepAliveMessageIntervalkeep_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.-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.-LogScanThresholdscan_threshold
Sólo para uso interno.-MaxCmdsInTrannumber_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.
-MessageIntervalmessage_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.
-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 | 3 | 4 ]
Especifica si el resultado debería ser detallado.Valor
Descripción
0
Sólo 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.
-PacketSizepacket_size
Es el tamaño del paquete, en bytes. El valor predeterminado es 4096 (bytes).-PollingIntervalpolling_interval
Es la frecuencia, en segundos, con la que el registro recibe consultas de transacciones replicadas. El valor predeterminado es 5 segundos.-ProfileNameprofile_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.-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.-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.-PublisherLoginpublisher_login
Es el nombre de inicio de sesión del publicador.-PublisherPasswordpublisher_password
Es la contraseña del publicador.-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.-ReadBatchSizenumber_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.-ReadBatchThresholdnumber_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 sólo se admite en publicadores de Oracle.
Notas
.gif "Nota importante") 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 sólo 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 Cómo ver y modificar la configuración de seguridad de la publicación (programación de la replicación con Transact-SQL). |
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.