MySQL 5.1参考手册 :: 8. 客户端和实用工具程序(4)

服务器生成的二进制日志文件写成二进制格式。要想检查这些文本格式的文件，应使用mysqlbinlog实用工具。

应这样调用mysqlbinlog：

shell> mysqlbinlog [options] log-files...

例如，要想显示二进制日志binlog.000003的内容，使用下面的命令：

shell> mysqlbinlog binlog.0000003

输出包括在binlog.000003中包含的所有语句，以及其它信息例如每个语句花费的时间、客户发出的线程ID、发出线程时的时间戳等等。

通常情况，可以使用mysqlbinlog直接读取二进制日志文件并将它们用于本地MySQL服务器。也可以使用--read-from-remote-server选项从远程服务器读取二进制日志。

当读取远程二进制日志时，可以通过连接参数选项来指示如何连接服务器，但它们经常被忽略掉，除非你还指定了--read-from-remote-server选项。这些选项是--host、--password、--port、--protocol、--socket和--user。

还可以使用mysqlbinlog来读取在复制过程中从服务器所写的中继日志文件。中继日志格式与二进制日志文件相同。

在5.11.3节，“二进制日志”中详细讨论了二进制日志。

mysqlbinlog支持下面的选项：

·         ---help，-？

显示帮助消息并退出。

·         ---database=db_name，-d db_name

只列出该数据库的条目(只用本地日志)。

·         --force-read，-f

使用该选项，如果mysqlbinlog读它不能识别的二进制日志事件，它会打印警告，忽略该事件并继续。没有该选项，如果mysqlbinlog读到此类事件则停止。

·         --hexdump，-H

在注释中显示日志的十六进制转储。该输出可以帮助复制过程中的调试。在MySQL 5.1.2中添加了该选项。

·         --host=host_name，-h host_name

获取给定主机上的MySQL服务器的二进制日志。

·         --local-load=path，-l pat

为指定目录中的LOAD DATA INFILE预处理本地临时文件。

·         --offset=N，-o N

跳过前N个条目。

·         --password[=password]，-p[password]

当连接服务器时使用的密码。如果使用短选项形式(-p)，选项和 密码之间不能有空格。如果在命令行中--password或-p选项后面没有 密码值，则提示输入一个密码。

·         --port=port_num，-P port_num

用于连接远程服务器的TCP/IP端口号。

·         --position=N，-j N

不赞成使用，应使用--start-position。

·         --protocol={TCP | SOCKET | PIPE | -position

使用的连接协议。

·         --read-from-remote-server，-R

从MySQL服务器读二进制日志。如果未给出该选项，任何连接参数选项将被忽略。这些选项是--host、--password、--port、--protocol、--socket和--user。

·         --result-file=name, -r name

将输出指向给定的文件。

·         --short-form，-s

只显示日志中包含的语句，不显示其它信息。

·         --socket=path，-S path

用于连接的套接字文件。

·         --start-datetime=datetime

从二进制日志中第1个日期时间等于或晚于datetime参量的事件开始读取。datetime值相对于运行mysqlbinlog的机器上的本地时区。该值格式应符合DATETIME或TIMESTAMP数据类型。例如：

shell> mysqlbinlog --start-datetime="2004-12-25 11:25:56" binlog.000003

该选项可以帮助点对点恢复。

·         --stop-datetime=datetime

从二进制日志中第1个日期时间等于或晚于datetime参量的事件起停止读。关于datetime值的描述参见--start-datetime选项。该选项可以帮助及时恢复。

·         --start-position=N

从二进制日志中第1个位置等于N参量时的事件开始读。

·         --stop-position=N

从二进制日志中第1个位置等于和大于N参量时的事件起停止读。

·         --to-last-logs，-t

在MySQL服务器中请求的二进制日志的结尾处不停止，而是继续打印直到最后一个二进制日志的结尾。如果将输出发送给同一台MySQL服务器，会导致无限循环。该选项要求--read-from-remote-server。

·         --disable-logs-bin，-D

禁用二进制日志。如果使用--to-last-logs选项将输出发送给同一台MySQL服务器，可以避免无限循环。该选项在崩溃恢复时也很有用，可以避免复制已经记录的语句。注释：该选项要求有SUPER权限。

·         --user=user_name，-u user_name

连接远程服务器时使用的MySQL用户名。

·         --version，-V

显示版本信息并退出。

还可以使用--var_name=value选项设置下面的变量：

·         open_files_limit

指定要保留的打开的文件描述符的数量。

可以将mysqlbinlog的输出传到mysql客户端以执行包含在二进制日志中的语句。如果你有一个旧的备份，该选项在崩溃恢复时也很有用(参见5.9.1节，“数据库备份”)：

shell> mysqlbinlog hostname-bin.000001 | mysql

或：

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

如果你需要先修改含语句的日志，还可以将mysqlbinlog的输出重新指向一个文本文件。(例如，想删除由于某种原因而不想执行的语句)。编辑好文件后，将它输入到mysql程序并执行它包含的语句。

mysqlbinlog有一个--position选项，只打印那些在二进制日志中的偏移量大于或等于某个给定位置的语句(给出的位置必须匹配一个事件的开始)。它还有在看见给定日期和时间的事件后停止或启动的选项。这样可以使用--stop-datetime选项进行点对点恢复(例如，能够说“将数据库前滚动到今天10:30 AM的位置”)。

如果MySQL服务器上有多个要执行的二进制日志，安全的方法是在一个连接中处理它们。下面是一个说明什么是不安全的例子：

shell> mysqlbinlog hostname-bin.000001 | mysql # DANGER!!

shell> mysqlbinlog hostname-bin.000002 | mysql # DANGER!!

使用与服务器的不同连接来处理二进制日志时，如果第1个日志文件包含一个CREATE TEMPORARY TABLE语句，第2个日志包含一个使用该临时表的语句，则会造成问题。当第1个mysql进程结束时，服务器撤销临时表。当第2个mysql进程想使用该表时，服务器报告 “不知道该表”。

要想避免此类问题，使用一个连接来执行想要处理的所有二进制日志中的内容。下面提供了一种方法：

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

另一个方法是：

shell> mysqlbinlog hostname-bin.000001 >  /tmp/statements.sql

shell> mysqlbinlog hostname-bin.000002 >> /tmp/statements.sql

shell> mysql -e "source /tmp/statements.sql"

mysqlbinlog产生的输出可以不需要原数据文件即可重新生成一个LOAD DATA INFILE操作。mysqlbinlog将数据复制到一个临时文件并写一个引用该文件的LOAD DATA LOCAL INFILE语句。由系统确定写入这些文件的目录的默认位置。要想显式指定一个目录，使用--local-load选项。

因为mysqlbinlog可以将LOAD DATA INFILE语句转换为LOAD DATA LOCAL INFILE语句(也就是说，它添加了LOCAL)，用于处理语句的客户端和服务器必须配置为允许LOCAL操作。参见5.6.4节，“LOAD DATA LOCAL安全问题”。

警告：为LOAD DATA LOCAL语句创建的临时文件不会自动删除，因为在实际执行完那些语句前需要它们。不再需要语句日志后应自己删除临时文件。文件位于临时文件目录中，文件名类似original_file_name-#-#。

--hexdump选项可以在注释中产生日志内容的十六进制转储：

shell> mysqlbinlog --hexdump master-bin.000001

上述命令的输出应类似：

/*!40019 SET @@session.max_insert_delayed_threads=0*/;

/*!50003 SET @OLD_COMPLETION_TYPE=@@COMPLETION_TYPE,COMPLETION_TYPE=0*/;

# at 4

#051024 17:24:13 server id 1  end_log_pos 98

# Position  Timestamp   Type   Master ID        Size      Master Pos    Flags

# 00000004 9d fc 5c 43   0f   01 00 00 00   5e 00 00 00   62 00 00 00   00 00

# 00000017 04 00 35 2e 30 2e 31 35  2d 64 65 62 75 67 2d 6c |..5.0.15.debug.l|

# 00000027 6f 67 00 00 00 00 00 00  00 00 00 00 00 00 00 00 |og..............|

# 00000037 00 00 00 00 00 00 00 00  00 00 00 00 00 00 00 00 |................|

# 00000047 00 00 00 00 9d fc 5c 43  13 38 0d 00 08 00 12 00 |.......C.8......|

# 00000057 04 04 04 04 12 00 00 4b  00 04 1a                |.......K...|

#       Start: binlog v 4, server v 5.0.15-debug-log created 051024 17:24:13

#       at startup

ROLLBACK;

十六进制转储的输出包含下面的元素：

·         Position: The byte position within the log file.

·         Timestamp: The event timestamp. In the example just shown, '9d fc 5c 43' is the representation of '051024 17:24:13' in hexadecimal.

·         Type: The type of the log event. '0f' means that the example event is a FORMAT_DESCRIPTION_EVENT. The types are:

·                00  UNKNOWN_EVENT

·                    This event should never be present in the log.

·                01  START_EVENT_V3

·                    This indicates the start of a log file written by MySQL 4 or earlier.

·                02  QUERY_EVENT

·                    The most common type of events.  These contain queries executed

·                    on the master.

·                03  STOP_EVENT

·                    Indicates that master has stopped.

·                04  ROTATE_EVENT

·                    Written when the master switches to a new log file.

·                05  INTVAR_EVENT

·                    Used mainly for AUTO_INCREMENT values and if the LAST_INSERT_ID()

·                    function is used in the statement.

·                06  LOAD_EVENT

·                    Used for LOAD DATA INFILE in MySQL 3.23.

·                07  SLAVE_EVENT

·                    Reserved for future use.

·                08  CREATE_FILE_EVENT

·                    Used for LOAD DATA INFILE statements.  This indicates the start

·                    of execution of such a statement.  A temporary file is created

·                    on the slave.  Used in MySQL 4 only.

·                09  APPEND_BLOCK_EVENT

·                    Contains data for use in a LOAD DATA INFILE statement.  The

·                    data is stored in the temporary file on the slave.

·                0a  EXEC_LOAD_EVENT

·                    Used for LOAD DATA INFILE statements.  The contents of the

·                    temporary file is stored in the table on the slave.

·                    Used in MySQL 4 only.

·                0b  DELETE_FILE_EVENT

·                    Rollback of LOAD DATA INFILE statement.  The temporary file

·                    should be deleted on slave.

·                0c  NEW_LOAD_EVENT

·                    Used for LOAD DATA INFILE in MySQL 4 and earlier.

·                0d  RAND_EVENT

·                    Used to send information about random values if the RAND()

·                    function is used in the query.

·                0e  USER_VAR_EVENT

·                    Used to replicate user variables.

·                0f  FORMAT_DESCRIPTION_EVENT

·                    This indicates the start of a log file written by MySQL 5 or later.

·                10  XID_EVENT

·                    Event indicating commit of XA transaction

·                11  BEGIN_LOAD_QUERY_EVENT

·                    Used for LOAD DATA statements in MySQL 5 and later.

·                12  EXECUTE_LOAD_QUERY_EVENT

·                    Used for LOAD DATA statements in MySQL 5 and later.

·                13  TABLE_MAP_EVENT

·                    Reserved for future use

·                14  WRITE_ROWS_EVENT

·                    Reserved for future use

·                15  UPDATE_ROWS_EVENT

·                    Reserved for future use

·                16  DELETE_ROWS_EVENT

·                    Reserved for future use

·         Master ID: The server id of the master that created the event.

·         Size: The size in bytes of the event.

·         Master Pos: The position of the event in the original master log file.

·         Flags: 16 flags.

·                01  LOG_EVENT_BINLOG_IN_USE_F

·                    Log file correctly closed (Used only in FORMAT_DESCRIPTION_EVENT)

·                    If this flag is set (if the flags are e.g. '01 00') in an

·                    FORMAT_DESCRIPTION_EVENT, then the log file has not been

·                    properly closed.  Most probably because of a master crash (for

·                    example, due to power failure).

·                02  Reserved for future use.

·                04  LOG_EVENT_THREAD_SPECIFIC_F

·                    Set if the event is dependent on the connection it was

·                    executed in (example '04 00'), e.g. if the event uses

·                    temporary tables.

·                08  LOG_EVENT_SUPPRESS_USE_F

·                    Set in some circumstances when the event is not dependent on

·                    the current database

其它标志保留用于将来使用。

在以后的版本中十六进制转储输出的格式可能会改变。

mysqlcheck客户端可以检查和修复MyISAM表。它还可以优化和分析表。

mysqlcheck的功能类似myisamchk，但其工作不同。主要差别是当mysqld服务器在运行时必须使用mysqlcheck，而myisamchk应用于服务器没有运行时。使用mysqlcheck的好处是不需要停止服务器来检查或修复表。

Mysqlcheck为用户提供了一种方便的使用SQL语句CHECK TABLE、REPAIR TABLE、ANALYZE TABLE和OPTIMIZE TABLE的方式。它确定在要执行的操作中使用使用哪个语句，然后将语句发送到要执行的服务器上。

有3种方式来调用mysqlcheck：

shell> mysqlcheck[options] db_name [tables]

shell> mysqlcheck[options] ---database DB1 [DB2 DB3...]

shell> mysqlcheck[options] --all--database

如果没有指定任何表或使用---database或--all--database选项，则检查整个数据库。

同其它客户端比较，mysqlcheck有一个特殊特性。重新命名二进制可以更改检查表的默认行为(--check)。如果你想要一个工具默认可以修复表的工具，只需要将mysqlcheck重新复制为mysqlrepair，或者使用一个符号链接mysqlrepair链接mysqlcheck。如果调用mysqlrepair，可按照命令修复表。

下面的名可用来更改mysqlcheck的默认行为：

mysqlcheck支持下面的选项：

·         ---help，-？

显示帮助消息并退出。

·         --all--database，-A

检查所有数据库中的所有表。与使用---database选项相同，在命令行中命名所有数据库。

·         --all-in-1，-1

不是为每个表发出一个语句，而是为命名数据库中待处理的所有表的每个数据库执行一个语句。

·         --analyze，-a

分析表。

·         --auto-repair

如果某个被检查的表破坏了，自动修复它。检查完所有表后自动进行所有需要的修复。

·         --character-sets-dir=path

字符集的安装目录。参见5.10.1节，“数据和排序用字符集”。

·         --check，-c

检查表的错误。

·         --check-only-changed，-C

只检查上次检查以来已经更改的或没有正确关闭的表。

·         --compress

压缩在客户端和服务器之间发送的所有信息（如果二者均支持压缩）。

·         ---database，-B

处理数据库中命名的所有表。使用该选项，所有字名参量被看作数据库名，而不是表名。

·         ---debug[=debug_options]，-# [debug_options]

写调试日志。debug_options字符串通常为'd:t:o,file_name'。

·         --default-character-set=charset

使用charsetas默认字符集。参见5.10.1节，“数据和排序用字符集”。

·         --extended，-e

如果你正使用该选项来检查表，可以确保它们100%地一致，但需要很长的时间。

如果你正使用该选项来修复表，则运行扩展修复，不但执行的时间很长，而且还会产生大量的垃圾行!

·         --fast，-F

只检查没有正确关闭的表。

·         --force，-f

即使出现SQL错误也继续。

·         --host=host_name，-h host_name

连接给定主机上的MySQL服务器。

·         --medium-check，-m

执行比--extended操作更快的检查。只能发现99.99%的错误，在大多数情况下这已经足够了。

·         --optimize，-o

优化表。

·         --password[=password]，-p[password]

当连接服务器时使用的密码。如果使用短选项形式(-p)，选项和 密码之间不能有空格。如果在命令行中--password或-p选项后面没有 密码值，则提示输入一个密码。

·         --port=port_num，-P port_num

用于连接的TCP/IP端口号。

·         --protocol={TCP | SOCKET | PIPE | MEMORY}

使用的连接协议。

·         --quick，-q

如果你正使用该选项在检查表，它防止扫描行以检查错误链接的检查。这是最快的检查方法。

如果你正使用该选项在修复表，它尝试只修复索引树。这是最快的修复方法。

·         --repair，-r

执行可以修复大部分问题的修复，只是唯一值不唯一时不能修复。

·         --silent，-s

沉默模式。只打印错误消息。

·         --socket=path，-S path

用于连接的套接字文件。

·         --tables

覆盖---database或-B选项。选项后面的所有参量被视为表名。

·         --user=user_name，-u user_name

当连接服务器时使用的MySQL用户名。

·         --verbose，-v

冗长模式。打印关于各阶段程序操作的信息。

·         --version，-V

显示版本信息并退出。