Los ficheros de log binario que el servidor genera se escriben en formato binario. Para examinar estos ficheros en formato de texto, se utiliza la utilidad mysqlbinlog .

Invoque mysqlbinlog así:

shell> mysqlbinlog [opciones] fichero_de_log ...

Por ejemplo, para mostrar el contenido del log binario binlog.000003, use este comando:

shell> mysqlbinlog binlog.0000003

La salida incluye todos los comandos contenidos en binlog.000003, junto con otra información tal como el tiempo que ha tardado cada comando, el ID del thread del cliente que lo lanzó, la hora en que se ejecutó, etcétera.

Normalmente, mysqlbinlog se utiliza para leer ficheros de log binarios directamente y aplicarlos al servidor MySQL local. También es posible leer logs binarios de un servidor remoto usando la opción --read-from-remote-server .

Cuando se vaya a leer logs binarios remotos, deben darse los parámetros de conexión para indicar cómo conectar con el servidor, pero se ignoran a no ser que también se especifique la opción --read-from-remote-server . Estas opciones son --host, --password, --port, --protocol, --socket y --user.

También puede utilizarse mysqlbinlog para leer ficheros de logs de relay escritos por un servidor esclavo en el arranque de una replicación. Los logs de relay tienen el mismo formato que los ficheros de log binarios.

El log binario se discute en Sección 5.10.3, “El registro binario (Binary Log)”.

mysqlbinlog soporta las siguientes opciones:

Puede cambiar las siguientes variales con las opciones --nombre_de_variable=valor:

Puede enviar la salida (output) de mysqlbinlog a un cliente mysql para que ejecute los comandos contenidos en el log binario. Esto se usa para recuperar de un fallo cuando tiene una copia de seguridad antigua (consulte Sección 5.8.1, “Copias de seguridad de bases de datos”):

shell> mysqlbinlog nombre_de_equipo-bin.000001 | mysql

O:

shell> mysqlbinlog hostname-bin.[0-9]* | mysql

También puede redirigir la salida (output) de mysqlbinlog a un fichero de texto, si necesita modificar el log de comandos primero (por ejemplo, para eliminar comandos que no quiere ejecutar por alguna razón). Tras editar el fichero, ejecute los comandos que contiene usándolo como entrada del programa mysql .

mysqlbinlog tiene la opción --start-position, que muestra sólo aquellos comandos con un desplazamiento en el log binario mayor o igual a una posición dada (la posición dada debe coincidir con el comienzo de un evento). También tiene las opciones de parar o arrancar cuando ve un evento de una fecha y hora dada. Esto permite ejecutar recuperaciones a partir de un punto temporal usando la opción --stop-datetime (que permite decir, por ejemplo, "devuelve mi base de datos al estado en que estaba hoy a las 10:30 AM").

Si tiene más de un log binario para ejecutar en el servidor MySQL, el método seguro es procesarlos todos usando una conexión única con el servidor. El siguiente ejemplo muestra una forma peligrosa de hacerlo:

shell> mysqlbinlog nombre_de_equipo-bin.000001 | mysql # PELIGRO!!
shell> mysqlbinlog nombre_de_equipo-bin.000002 | mysql # PELIGRO!!

Procesar logs binarios de esta manera, utilizando diferentes conexiones con el servidor provoca problemas si el primer fichero de log contiene un comando CREATE TEMPORARY TABLE y el segundo log contiene un comando que usa la tabla temporal. Cuando el primer proceso mysql termina, el servidor elimina la tabla temporal. Cuando el segundo proceso mysql trata de usar la tabla, el servidor devuelve “tabla desconocida”.

Para evitar problemas como éste, utilice una única conexión para ejecutar los contenidos de todos los logs binarios que quiere procesar. Sigue una forma de hacerlo:

shell> mysqlbinlog nombre_de_equipo-bin.000001 nombre_de_equipo-bin.000002 | mysql

Otra forma de hacerlo es escribir todos los logs a un único fichero y luego procesar el fichero:

shell> mysqlbinlog nombre_de_equipo-bin.000001 >  /tmp/statements.sql
shell> mysqlbinlog nombre_de_equipo-bin.000002 >> /tmp/statements.sql
shell> mysql -e "source /tmp/statements.sql"

En MySQL 5.0, mysqlbinlog puede producir la salida (output) que reproduce una operación LOAD DATA INFILE sin el fichero de datos original. mysqlbinlog copia los datos en un fichero temporal y escribe un comando LOAD DATA LOCAL INFILE que se refiere a este fichero. La localización por defecto del directorio donde estos ficheros se escriben es específico del sistema. Para espeficar un directorio explícitamente, use la opción --local-load.

Como mysqlbinlog convierte comandos LOAD DATA INFILE en comandos LOAD DATA LOCAL INFILE (esto es, añade LOCAL). Tanto el cliente como el servidor que se utiliza para procesar los comandos deben estar configurados para permitir LOCAL. Consulte Sección 5.5.4, “Cuestiones relacionadas con la seguridad y LOAD DATA LOCAL”.

Atención: Los ficheros temporales creados por comandos LOAD DATA LOCAL no se borran automáticamente ya que se necesitan hasta que los comandos se ejecutan totalmente. Debe borrar los ficheros temporales cuando no necesite el log de comandos. Los ficheros pueden encontrarse en el directorio de ficheros temporales y tienen nombres como original_file_name-#-#.

En el futuro, eliminaremos este problema permitiendo que mysqlbinlog pueda conectarse directamente a un servidor mysqld. Así será posible eliminar los ficheros de log automáticamente cuando los comandos LOAD DATA INFILE se hayan ejecutado.