Agente de registro del LOG de replicaciónReplication Log Reader Agent

En este tema se aplica a: SíSQL Servernobase de datos de SQL Azurenoalmacenamiento de datos de SQL Azure ningún Almacenamiento de datos paralelosTHIS TOPIC APPLIES TO: yesSQL ServernoAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse 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. The Replication Log Reader Agent is an executable that monitors the transaction log of each database configured for transactional replication and copies the transactions marked for replication from the transaction log into the distribution database.

Nota

Los parámetros se pueden especificar en cualquier orden.Parameters can be specified in any order. Cuando no se especifican parámetros opcionales, se utilizan valores predefinidos basados en el perfil de agente predeterminado.When optional parameters are not specified, predefined values based on the default agent profile are used.

SintaxisSyntax


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]  

ArgumentosArguments

-?-?
Muestra información de uso.Displays usage information.

-Publisher server_name[\instance_name]-Publisher server_name[\instance_name]
Es el nombre del publicador.Is the name of the Publisher. Especifique server_name para conectarse a la instancia predeterminada del MicrosoftMicrosoft SQL ServerSQL Server en ese servidor.Specify server_name for the default instance of MicrosoftMicrosoft SQL ServerSQL Server on that server. Especifique server_name\instance_name para la instancia predeterminada de SQL ServerSQL Server en ese servidor.Specify server_name\instance_name for a named instance of SQL ServerSQL Server on that server.

-PublisherDB publisher_database-PublisherDB publisher_database
Es el nombre de la base de datos del publicador.Is the name of the Publisher database.

-Continuous-Continuous
Especifica si el agente intenta sondear las transacciones replicadas continuamente.Specifies whether the agent tries to poll replicated transactions continually. Si se especifica, el agente sondea las transacciones replicadas del origen en intervalos de sondeo, aunque no haya ninguna transacción pendiente.If specified, the agent polls replicated transactions from the source at polling intervals even if there are no transactions pending.

-DefinitionFile def_path_and_file_name-DefinitionFile def_path_and_file_name
Es la ruta de acceso del archivo de definición de agente.Is the path of the agent definition file. Un archivo de definición de agente contiene los argumentos de línea de comandos para el agente.An agent definition file contains command-line arguments for the agent. El contenido del archivo se analiza como un archivo ejecutable.The content of the file is parsed as an executable file. Utilice las comillas tipográficas (") para especificar valores de argumento que contienen caracteres arbitrarios.Use double quotation marks (") to specify argument values that contain arbitrary characters.

-Distributor server_name[\instance_name]-Distributor server_name[\instance_name]
Es el nombre del distribuidor.Is the Distributor name. Especifique server_name para la instancia predeterminada de SQL ServerSQL Server en ese servidor.Specify server_name for the default instance of SQL ServerSQL Server on that server. Especifique server_name\instance_name para la instancia predeterminada de SQL ServerSQL Server en ese servidor.Specify server_name\instance_name for a named instance of SQL ServerSQL Server on that server.

-DistributorLogin distributor_login-DistributorLogin distributor_login
Es el nombre de inicio de sesión del distribuidor.Is the Distributor login name.

-DistributorPassword distributor_password-DistributorPassword distributor_password
Es la contraseña del distribuidor.Is the Distributor password.

-DistributorSecurityMode [ 0| 1]-DistributorSecurityMode [ 0| 1]
Especifica el modo de seguridad del distribuidor.Specifies the security mode of the Distributor. Un valor de 0 hace referencia a la autenticación de SQL ServerSQL Server (valor predeterminado) y un valor de 1 hace referencia al modo de autenticación de MicrosoftMicrosoft Windows.A value of 0 indicates SQL ServerSQL Server Authentication Mode (default), and a value of 1 indicates MicrosoftMicrosoft Windows Authentication Mode.

-EncryptionLevel [ 0 | 1 | 2 ]-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.Is the level of Secure Sockets Layer (SSL) encryption that is used by the Log Reader Agent when making connections.

Valor de EncryptionLevelEncryptionLevel value DescripciónDescription
00 Especifica que no se utiliza SSL.Specifies that SSL is not used.
11 Especifica que se utiliza SSL, pero el agente no comprueba que un emisor confiable haya firmado el certificado del servidor SSL.Specifies that SSL is used, but the agent does not verify that the SSL server certificate is signed by a trusted issuer.
22 Especifica que se usa SSL y que se ha comprobado el certificado.Specifies that SSL is used, and that the certificate is verified.

Para obtener más información, vea Información general sobre seguridad (replicación).For more information, see Security Overview (Replication).

-ExtendedEventConfigFile configuration_path_and_file_name-ExtendedEventConfigFile configuration_path_and_file_name
Especifica el nombre y la ruta del archivo para el archivo de configuración XML de eventos extendidos.Specifies the path and file name for the extended events XML configuration file. El archivo de configuración de eventos extendidos le permite configurar sesiones y habilitar eventos para su seguimiento.The extended events configuration file allows you to configure sessions and enable events for tracking.

-HistoryVerboseLevel [ 0| 1| 2]-HistoryVerboseLevel [ 0| 1| 2]
Especifica la cantidad de historial registrado durante una operación del lector de registro.Specifies the amount of history logged during a log reader operation. Puede minimizar el efecto sobre el rendimiento del registro del historial seleccionando 1.You can minimize the performance effect of history logging by selecting 1.

Valor HistoryVerboseLevelHistoryVerboseLevel value DescripciónDescription
00
11 Predeterminado:Default. Siempre actualiza un mensaje del historial anterior del mismo estado (inicio, progreso, éxito, etc.).Always update a previous history message of the same status (startup, progress, success, and so on). Si no existe ningún registro anterior con el mismo estado, inserta un nuevo registro.If no previous record with the same status exists, insert a new record.
22 Inserta nuevos registros de historial a menos que el registro sea para mensajes de inactividad o mensajes de trabajos de ejecución prolongada, en cuyo caso actualiza los registros anteriores.Insert new history records unless the record is for such things as idle messages or long-running job messages, in which case update the previous records.

-KeepAliveMessageInterval keep_alive_message_interval_seconds-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.Is the number of seconds before the history thread checks if any of the existing connections is waiting for a response from the server. 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.This value can be decreased to avoid having the checkup agent mark the Log Reader Agent as suspect when executing a long-running batch. El valor predeterminado es 300 segundos.The default is 300 seconds.

-LoginTimeOut login_time_out_seconds-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.Is the number of seconds before the login times out. The default is 15 seconds.

-LogScanThreshold scan_threshold-LogScanThreshold scan_threshold
Exclusivamente para uso interno.Internal use only.

-MaxCmdsInTran number_of_commands-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.Specifies the maximum number of statements grouped into a transaction as the Log Reader writes commands to the distribution database. 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.Using this parameter allows the Log Reader Agent and Distribution Agent to divide large transactions (consisting of many commands) at the Publisher into several smaller transactions when applied at the Subscriber. Especificando este parámetro se puede reducir la contención en el distribuidor y la latencia entre el publicador y el suscriptor.Specifying this parameter can reduce contention at the Distributor and reduce latency between the Publisher and Subscriber. 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.Because the original transaction is applied in smaller units, the Subscriber can access rows of a large logical Publisher transaction prior to the end of the original transaction, breaking strict transactional atomicity. El valor predeterminado es 0, que conserva los límites de la transacción del publicador.The default is 0, which preserves the transaction boundaries of the Publisher.

Nota

Este parámetro se omite para las publicaciones que no son de SQL ServerSQL Server .This parameter is ignored for non- SQL ServerSQL Server publications. Para obtener más información, vea la sección "Configurar el trabajo del conjunto de transacciones" en Performance Tuning for Oracle Publishers.For more information, see the section "Configuring the Transaction Set Job" in Performance Tuning for Oracle Publishers.

-MessageInterval message_interval-MessageInterval message_interval
Es el intervalo de tiempo utilizado para el registro del historial.Is the time interval used for history logging. Un evento del historial se registra cuando se alcanza el valor de MessageInterval una vez registrado el último evento de historial.A history event is logged when the MessageInterval value is reached after the last history event is logged.

Si no hay ninguna transacción replicada disponible en el origen, el agente envía un mensaje de no transacción al distribuidor.If there is no replicated transaction available at the source, the agent reports a no-transaction message to the Distributor. Esta opción especifica cuánto tiempo espera el agente para enviar otro mensaje que indica que no hay ninguna transacción.This option specifies how long the agent waits before reporting another no-transaction message. 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.Agents always report a no-transaction message when they detect that there are no transactions available at the source after previously processing replicated transactions. El valor predeterminado es 60 segundos.The default is 60 seconds.

-Output output_path_and_file_name-Output output_path_and_file_name
Es la ruta de acceso del archivo de salida del agente.Is the path of the agent output file. Si no se proporciona un nombre de archivo, el resultado se envía a la consola.If the file name is not provided, the output is sent to the console. Si el nombre de archivo especificado existe, el resultado se anexa al archivo.If the specified file name exists, the output is appended to the file.

-OutputVerboseLevel [ 0| 1| 2 | 3 | 4 ]-OutputVerboseLevel [ 0| 1| 2 | 3 | 4 ]
Especifica si el resultado debería ser detallado.Specifies whether the output should be verbose.

ValorValue DescripciónDescription
00 Solo se imprimen los mensajes de error.Only error messages are printed.
11 Se imprimen todos los mensajes de informe de progreso de agente.All agent progress report messages are printed.
2 (predeterminado)2 (default) Se imprimen todos los mensajes de error y mensajes de informe de progreso de agente.All error messages and agent progress report messages are printed.
33 Se imprimen los primeros 100 bytes de cada comando replicado.The first 100 bytes of each replicated command are printed.
44 Se imprimen todos los comandos replicados.All replicated commands are printed.

Valora 2-4 son útiles al depurar.Values 2-4 are useful when debugging.

-PacketSize packet_size-PacketSize packet_size
Es el tamaño del paquete, en bytes.Is the packet size, in bytes. El valor predeterminado es 4096 (bytes).The default is 4096 (bytes).

-PollingInterval polling_interval-PollingInterval polling_interval
Es la frecuencia, en segundos, con la que el registro recibe consultas de transacciones replicadas.Is how often, in seconds, the log is queried for replicated transactions. El valor predeterminado es 5 segundos.The default is 5 seconds.

-ProfileName profile_name-ProfileName profile_name
Especifica un perfil de agente para utilizar para los parámetros del agente.Specifies an agent profile to use for agent parameters. Si ProfileName es NULL, el perfil de agente se deshabilita.If ProfileName is NULL, the agent profile is disabled. Si no se especifica ProfileName , se utiliza el perfil predeterminado para el tipo de agente.If ProfileName is not specified, the default profile for the agent type is used. Para obtener información, vea Perfiles del Agente de replicación.For information, see Replication Agent Profiles.

-PublisherFailoverPartner server_name[\instance_name]-PublisherFailoverPartner server_name[\instance_name]
Especifica la instancia del asociado de conmutación por error de SQL ServerSQL 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.Specifies the failover partner instance of SQL ServerSQL Server participating in a database mirroring session with the publication database. Para obtener más información, vea Database Mirroring and Replication (SQL Server).For more information, see Database Mirroring and Replication (SQL Server).

-PublisherSecurityMode [ 0| 1]-PublisherSecurityMode [ 0| 1]
Especifica el modo de seguridad del publicador.Specifies the security mode of the Publisher. Un valor de 0 hace referencia a la autenticación de SQL ServerSQL Server (predeterminado) y un valor de 1 hace referencia al modo de autenticación de Windows.A value of 0 indicates SQL ServerSQL Server Authentication (default), and a value of 1 indicates Windows Authentication Mode.

-PublisherLogin publisher_login-PublisherLogin publisher_login
Es el nombre de inicio de sesión del publicador.Is the Publisher login name.

-PublisherPassword publisher_password-PublisherPassword publisher_password
Es la contraseña del publicador.Is the Publisher password.

-QueryTimeOut query_time_out_seconds-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.Is the number of seconds before the query times out. The default is 1800 seconds.

-ReadBatchSize number_of_transactions-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.Is the maximum number of transactions read out of the transaction log of the publishing database per processing cycle, with a default of 500. El agente continuará leyendo las transacciones en lotes hasta que se lean todas las transacciones del registro.The agent will continue to read transactions in batches until all transactions are read from the log. Este parámetro no se admite en publicadores de Oracle.This parameter is not supported for Oracle Publishers.

-ReadBatchThreshold number_of_commands-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.Is the number of replication commands to be read from the transaction log before being issued to the Subscriber by the Distribution Agent. El valor predeterminado es 0.The default is 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).If this parameter is not specified, the Log Reader Agent will read to the end of the log or to the number specified in -ReadBatchSize (number of transactions).

-RecoverFromDataErrors-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.Specifies that the Log Reader Agent continue to run when it encounters errors in column data published from a non-SQL Server Publisher. De forma predeterminada, tales errores hacen el Agente de registro del LOG devuelva un error.By default, such errors cause the Log Reader Agent to fail. 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 .When you use -RecoverFromDataErrors, erroneous column data is replicated either as NULL or an appropriate nonnull value, and warning messages are logged to the MSlogreader_history table. Este parámetro solamente se admite en publicadores de Oracle.This parameter is only supported for Oracle Publishers.

ComentariosRemarks

Importante

Si ha instalado el agente de SQL ServerSQL 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.If you installed SQL ServerSQL Server Agent to run under a local system account instead of under a domain user account (the default), the service can access only the local computer. Si el Agente de registro del LOG que se ejecuta en el agente de SQL ServerSQL Server se configura para utilizar el modo de autenticación de Windows cuando inicia sesión en una instancia de SQL ServerSQL Server, el Agente de registro del LOC devuelve un error.If the Log Reader Agent that runs under SQL ServerSQL Server Agent is configured to use Windows Authentication Mode when it logs in to SQL ServerSQL Server, the Log Reader Agent fails. La configuración predeterminada es la autenticación de SQL ServerSQL Server .The default setting is SQL ServerSQL Server Authentication. Para obtener más información acerca de cómo cambiar cuentas de seguridad, vea View and Modify Replication Security Settings.For information about changing security accounts, see View and Modify Replication Security Settings.

Para iniciar el Agente de registro del LOG, ejecute logread.exe en el símbolo del sistema.To start the Log Reader Agent, execute logread.exe from the command prompt. Para obtener información, vea Conceptos de los ejecutables del Agente de replicación.For information, see Replication Agent Executables Concepts.

Historial de cambiosChange History

Contenido actualizadoUpdated content
Se ha agregado el parámetro -ExtendedEventConfigFile .Added the -ExtendedEventConfigFile parameter.

Vea tambiénSee Also

Administración del Agente de replicaciónReplication Agent Administration