--help, -?

显示帮助信息并退出。

--base64-output=value

此选项确定何时应使用 BINLOG语句将事件编码为 base-64 字符串。该选项具有以下允许值（不区分大小写）：

有关显示 行事件输出的影响的示例，请参阅--base64-output第 4.6.7.2 节，“mysqlbinlog 行事件显示”。 --verbose

--bind-address=ip_address

在具有多个网络接口的计算机上，使用此选项来选择用于连接到 MySQL 服务器的接口。

--binlog-row-event-max-size=N

指定基于行的二进制日志事件的最大大小（以字节为单位）。如果可能，行被分组为小于此大小的事件。该值应为 256 的倍数。默认值为 4GB。

--character-sets-dir=dir_name

安装字符集的目录。请参阅 第 10.15 节，“字符集配置”。

--connection-server-id=server_id

此选项用于测试 MySQL 服务器是否支持BINLOG_DUMP_NON_BLOCK连接标志。正常操作不需要它。

此选项的有效默认值和最小值取决于mysqlbinlog是在阻塞模式还是非阻塞模式下运行。当 mysqlbinlog以阻塞模式运行时，默认（和最小）值为 1；在非阻塞模式下运行时，默认（和最小）值为 0。

--database=db_name, -d db_name

此选项导致mysqlbinlog从二进制日志（仅限本地日志）输出条目，这些条目在db_name被选为默认数据库时发生USE。

mysqlbinlog 的--database选项类似于 mysqld的选项 ，但只能用于指定一个数据库。如果 多次给出，则仅使用最后一个实例。 --binlog-do-db--database

此选项的效果取决于使用的是基于语句的还是基于行的日志记录格式，就像 的效果 --binlog-do-db取决于使用的是基于语句还是基于行的日志记录一样。

基于语句的日志记录。  该--database选项的工作原理如下：

假设二进制日志是通过使用基于语句的日志记录执行这些语句创建的：

INSERT INTO test.t1 (i) VALUES(100);
INSERT INTO db2.t2 (j)  VALUES(200);
USE test;
INSERT INTO test.t1 (i) VALUES(101);
INSERT INTO t1 (i)      VALUES(102);
INSERT INTO db2.t2 (j)  VALUES(201);
USE db2;
INSERT INTO test.t1 (i) VALUES(103);
INSERT INTO db2.t2 (j)  VALUES(202);
INSERT INTO t2 (j)      VALUES(203);

mysqlbinlog --database=test没有输出前两条INSERT 语句，因为没有默认的数据库。它输出INSERT后面的三个语句USE test，但不输出后面的三个 INSERT语句 USE db2。

mysqlbinlog --database=db2没有输出前两条INSERT 语句，因为没有默认数据库。它不输出后面的三个INSERT 语句 USE test，但是输出INSERT 后面的三个语句 USE db2。

基于行的日志记录。  mysqlbinlog仅输出更改属于 db_name. 默认数据库对此没有影响。假设刚刚描述的二进制日志是使用基于行的日志记录而不是基于语句的日志记录创建的。mysqlbinlog --database=test仅输出那些t1在测试数据库中修改的条目，无论是否USE 发布或默认数据库是什么。

如果服务器运行时 binlog_format设置为 MIXED并且您希望它可以使用带有该 选项的mysqlbinlog--database ，则必须确保修改的表位于 . 选择的数据库中USE。（特别是，不应使用跨数据库更新。）

--rewrite-db与选项 一起使用时 ，--rewrite-db优先应用选项；然后--database应用该选项，使用重写的数据库名称。提供选项的顺序在这方面没有区别。

--debug[=debug_options], -# [debug_options]

写调试日志。典型的 debug_options字符串是 . 默认值为 。 d:t:o,file_named:t:o,/tmp/mysqlbinlog.trace

仅当 MySQL 是使用 WITH_DEBUG. Oracle 提供的 MySQL 发布二进制文件不是 使用此选项构建的。

--debug-check

程序退出时打印一些调试信息。

仅当 MySQL 是使用 WITH_DEBUG. Oracle 提供的 MySQL 发布二进制文件不是 使用此选项构建的。

--debug-info

程序退出时打印调试信息以及内存和 CPU 使用统计信息。

仅当 MySQL 是使用 WITH_DEBUG. Oracle 提供的 MySQL 发布二进制文件不是 使用此选项构建的。

--default-auth=plugin

关于使用哪个客户端身份验证插件的提示。请参阅第 6.2.13 节，“可插入身份验证”。

--defaults-extra-file=file_name

在全局选项文件之后但（在 Unix 上）在用户选项文件之前读取此选项文件。如果该文件不存在或无法访问，则会发生错误。如果 file_name不是绝对路径名，则将其解释为相对于当前目录。

有关此选项和其他选项文件选项的其他信息，请参阅第 4.2.2.3 节，“影响选项文件处理的命令行选项”。

--defaults-file=file_name

仅使用给定的选项文件。如果该文件不存在或无法访问，则会发生错误。如果 file_name不是绝对路径名，则将其解释为相对于当前目录。

例外：即使有 --defaults-file，客户端程序也会读取.mylogin.cnf.

有关此选项和其他选项文件选项的其他信息，请参阅第 4.2.2.3 节，“影响选项文件处理的命令行选项”。

--defaults-group-suffix=str

不仅要阅读通常的选项组，还要阅读具有通常名称和后缀 str. 例如， mysqlbinlog通常会读取 [client]和 [mysqlbinlog]组。如果此选项作为 给出 --defaults-group-suffix=_other， 则mysqlbinlog还会读取 [client_other]和 [mysqlbinlog_other]组。

有关此选项和其他选项文件选项的其他信息，请参阅第 4.2.2.3 节，“影响选项文件处理的命令行选项”。

--disable-log-bin, -D

禁用二进制日志记录。--to-last-log如果您使用该选项并将输出发送到同一个 MySQL 服务器，这对于避免无限循环很有用 。在意外退出后恢复时，此选项也很有用，以避免重复您记录的语句。

此选项导致mysqlbinlog在其输出中包含一条SET sql_log_bin = 0语句以禁用剩余输出的二进制日志记录。操作系统变量的会话值 sql_log_bin是受限制的操作，因此此选项要求您具有足够的权限来设置受限制的会话变量。请参阅第 5.1.8.1 节，“系统变量权限”。

--exclude-gtids=gtid_set

不要显示 中列出的任何组 gtid_set。

--force-if-open, -F

读取二进制日志文件，即使它们已打开或未正确关闭。

--force-read, -f

使用此选项，如果mysqlbinlog读取了一个它无法识别的二进制日志事件，它会打印一条警告，忽略该事件并继续。如果没有此选项，mysqlbinlog会在读取此类事件时停止。

--get-server-public-key

从服务器请求基于 RSA 密钥对的密码交换所需的公钥。此选项适用于使用 caching_sha2_password身份验证插件进行身份验证的客户端。对于该插件，除非请求，否则服务器不会发送公钥。对于未使用该插件进行身份验证的帐户，将忽略此选项。如果不使用基于 RSA 的密码交换，它也会被忽略，就像客户端使用安全连接连接到服务器时的情况一样。

如果 给出并指定一个有效的公钥文件，它优先于 . --server-public-key-path=file_name--get-server-public-key

有关 caching_sha2_password插件的信息，请参阅 第 6.4.1.4 节，“缓存 SHA-2 可插入身份验证”。

该 --get-server-public-key 选项是在 MySQL 5.7.23 中添加的。

--hexdump, -H

在注释中显示日志的十六进制转储，如 第 4.6.7.1 节“mysqlbinlog 十六进制转储格式”中所述。十六进制输出有助于复制调试。

--host=host_name, -h host_name

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

--idempotent

告诉 MySQL 服务器在处理更新时使用幂等模式；这会抑制服务器在处理更新时在当前会话中遇到的任何重复键或键未找到错误。每当需要或有必要将一个或多个二进制日志重播到 MySQL 服务器时，此选项可能会证明是有用的，而该服务器可能不包含日志所引用的所有数据。

此选项的影响范围仅包括当前的 mysqlbinlog客户端和会话。

--include-gtids=gtid_set

仅显示 中列出的组 gtid_set。

--local-load=dir_name, -l dir_name

对于 LOAD DATA语句对应的数据加载操作， mysqlbinlog从二进制日志事件中提取文件，将其作为临时文件写入本地文件系统，并写入 LOAD DATA LOCAL语句使文件加载。默认情况下，mysqlbinlog将这些临时文件写入特定于操作系统的目录。该--local-load选项可用于明确指定 mysqlbinlog应该准备本地临时文件的目录。

--login-path=name

从登录路径文件中指定的登录路径读取选项 .mylogin.cnf。“ 登录路径”是一个选项组，其中包含指定要连接到哪个 MySQL 服务器以及要以哪个帐户进行身份验证的选项。要创建或修改登录路径文件，请使用 mysql_config_editor实用程序。请参阅 第 4.6.6 节，“mysql_config_editor — MySQL 配置实用程序”。

有关此选项和其他选项文件选项的其他信息，请参阅第 4.2.2.3 节，“影响选项文件处理的命令行选项”。

--no-defaults

不要读取任何选项文件。如果程序启动因从选项文件中读取未知选项而失败， --no-defaults可用于防止它们被读取。

例外情况是.mylogin.cnf 文件在所有情况下都会被读取（如果存在）。这允许以比在命令行上更安全的方式指定密码，即使在 --no-defaults使用 时也是如此。要创建.mylogin.cnf，请使用 mysql_config_editor实用程序。请参阅 第 4.6.6 节，“mysql_config_editor — MySQL 配置实用程序”。

有关此选项和其他选项文件选项的其他信息，请参阅第 4.2.2.3 节，“影响选项文件处理的命令行选项”。

--offset=N, -o N

跳过N日志中的第一个条目。

--open-files-limit=N

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

--password[=password], -p[password]

用于连接到服务器的 MySQL 帐户的密码。密码值是可选的。如果没有给出， mysqlbinlog会提示输入一个。如果给定，则后面 的密码之间 不能有空格。如果未指定密码选项，则默认为不发送密码。 --password=-p

在命令行上指定密码应该被认为是不安全的。为避免在命令行中提供密码，请使用选项文件。请参阅 第 6.1.2.1 节，“密码安全的最终用户指南”。

要明确指定没有密码并且 mysqlbinlog不应提示输入密码，请使用该 --skip-password 选项。

--plugin-dir=dir_name

在其中查找插件的目录。如果该 --default-auth选项用于指定身份验证插件但 mysqlbinlog未找到它，请指定此选项。请参阅 第 6.2.13 节，“可插入身份验证”。

--port=port_num, -P port_num

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

--print-defaults

打印程序名称和它从选项文件中获取的所有选项。

有关此选项和其他选项文件选项的其他信息，请参阅第 4.2.2.3 节，“影响选项文件处理的命令行选项”。

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

用于连接到服务器的传输协议。当其他连接参数通常导致使用您想要的协议以外的协议时，它很有用。有关允许值的详细信息，请参阅 第 4.2.5 节“连接传输协议”。

--raw

默认情况下，mysqlbinlog读取二进制日志文件并以文本格式写入事件。该 --raw选项告诉 mysqlbinlog以其原始二进制格式写入它们。它的使用要求 --read-from-remote-server 也被使用，因为文件是从服务器请求的。 mysqlbinlog为从服务器读取的每个文件写入一个输出文件。该 --raw选项可用于备份服务器的二进制日志。使用该 --stop-never选项，备份是“实时”的，因为 mysqlbinlog保持与服务器的连接。默认情况下，输出文件以与原始日志文件相同的名称写入当前目录。可以使用该 --result-file选项修改输出文件名。有关详细信息，请参阅 第 4.6.7.3 节，“使用 mysqlbinlog 备份二进制日志文件”。

--read-from-remote-master=type

通过将选项值 分别设置为或 ，使用COM_BINLOG_DUMP或 命令 从 MySQL 服务器读取二进制日志 。如果 与 结合使用 ，可以在源上过滤掉事务，避免不必要的网络流量。 COM_BINLOG_DUMP_GTIDBINLOG-DUMP-NON-GTIDSBINLOG-DUMP-GTIDS--read-from-remote-master=BINLOG-DUMP-GTIDS--exclude-gtids

连接参数选项与此选项或 --read-from-remote-server 选项一起使用。这些选项是 --host、 --password、 --port、 --protocol、 --socket和 --user。如果未指定任何远程选项，则忽略连接参数选项。

使用REPLICATION SLAVE 此选项需要权限。

--read-from-remote-server, -R

从 MySQL 服务器读取二进制日志，而不是读取本地日志文件。此选项要求远程服务器正在运行。它仅适用于远程服务器上的二进制日志文件，不适用于中继日志文件。

连接参数选项与此选项或 --read-from-remote-master 选项一起使用。这些选项是 --host、 --password、 --port、 --protocol、 --socket和 --user。如果未指定任何远程选项，则忽略连接参数选项。

使用REPLICATION SLAVE 此选项需要权限。

这个选项就像 --read-from-remote-master=BINLOG-DUMP-NON-GTIDS.

--result-file=name, -r name

如果没有该--raw 选项，该选项指示 mysqlbinlog将文本输出写入到的文件。使用 --raw， mysqlbinlog为从服务器传输的每个日志文件写入一个二进制输出文件，默认情况下将它们写入当前目录，使用与原始日志文件相同的名称。在这种情况下， --result-file选项值被视为修改输出文件名的前缀。

--rewrite-db='from_name->to_name'

从基于行或基于语句的日志中读取时，重写所有出现的 from_nameto to_name。对于基于行的日志，重写是在行上完成的，对于基于 USE语句的日志，重写是在子句上完成的。在 5.7.8 之前的 MySQL 版本中，此选项仅在恢复使用基于行的格式记录的表时使用。

用作此选项值的重写规则是一个具有形式的字符串 ，如前所示，因此必须用引号括起来。 'from_name->to_name'

要使用多个重写规则，请多次指定该选项，如下所示：

mysqlbinlog --rewrite-db='dbcurrent->dbold' --rewrite-db='dbtest->dbcurrent' \
    binlog.00001 > /tmp/statements.sql

--database与选项 一起使用时 ，--rewrite-db优先应用选项；然后 --database应用选项，使用重写的数据库名称。提供选项的顺序在这方面没有区别。

这意味着，例如，如果 mysqlbinlog以 开头 ，则对数据库中 --rewrite-db='mydb->yourdb' --database=yourdb任何表的所有更新都包含在输出中。另一方面，如果它以 开始 ，则 mysqlbinlog根本不输出任何语句：因为在应用该选项之前，首先将对的所有更新重写为对的更新，因此没有匹配 的更新。 mydbyourdb--rewrite-db='mydb->yourdb' --database=mydbmydbyourdb--database--database=mydb

--secure-auth

不要以旧的（pre-4.1）格式向服务器发送密码。这会阻止除使用较新密码格式的服务器之外的连接。

从 MySQL 5.7.5 开始，此选项已弃用；希望在未来的 MySQL 版本中将其删除。它始终处于启用状态，尝试禁用它 ( --skip-secure-auth, --secure-auth=0) 会产生错误。在 MySQL 5.7.5 之前，此选项默认启用，但可以禁用。

--server-id=id

仅显示由具有给定服务器 ID 的服务器创建的那些事件。

--server-id-bits=N

仅使用 的前N几位 server_id来标识服务器。如果二进制日志是由 mysqld写入的，其server-id-bits 设置为小于 32，并且用户数据存储在最高有效位中，则运行设置 为 32 的mysqlbinlog--server-id-bits可以看到此数据。

此选项仅受 NDB Cluster 发行版提供的 mysqlbinlog版本支持，或从 NDB Cluster 源构建。

--server-public-key-path=file_name

PEM 格式文件的路径名，其中包含服务器所需的公钥客户端副本，用于基于 RSA 密钥对的密码交换。此选项适用于使用 sha256_password或 caching_sha2_password身份验证插件进行身份验证的客户端。对于未使用其中一个插件进行身份验证的帐户，将忽略此选项。如果不使用基于 RSA 的密码交换，它也会被忽略，就像客户端使用安全连接连接到服务器时的情况一样。

如果 给出并指定一个有效的公钥文件，它优先于 . --server-public-key-path=file_name--get-server-public-key

对于sha256_password，此选项仅适用于使用 OpenSSL 构建 MySQL 的情况。

有关插件sha256_password 和caching_sha2_password插件的信息，请参阅 第 6.4.1.5 节，“SHA-256 可插入身份验证”和 第 6.4.1.4 节，“缓存 SHA-2 可插入身份验证”。

该 --server-public-key-path 选项是在 MySQL 5.7.23 中添加的。

--set-charset=charset_name

在输出中添加一条语句以指定用于处理日志文件的字符集。 SET NAMES charset_name

--shared-memory-base-name=name

在 Windows 上，用于使用共享内存与本地服务器建立连接的共享内存名称。默认值为MYSQL。共享内存名称区分大小写。

仅当服务器启动时 shared_memory启用了支持共享内存连接的系统变量时，此选项才适用。

--short-form, -s

仅显示日志中包含的语句，没有任何额外信息或基于行的事件。这仅用于测试，不应在生产系统中使用。

--skip-gtids[=(true|false)]

不要在输出转储文件中包含二进制日志文件中的 GTID。例如：

mysqlbinlog --skip-gtids binlog.000001 >  /tmp/dump.sql
mysql -u root -p -e "source /tmp/dump.sql"

您通常不应在生产或恢复中使用此选项，除非在特定且罕见的情况下 GTID 主动不需要。例如，管理员可能希望将选定的事务（例如表定义）从一个部署复制到另一个不相关的部署，该部署不会复制到原始部署或从原始部署复制。在这种情况下， --skip-gtids 可用于使管理员能够像处理新事务一样应用事务，并确保部署保持无关。但是，只有在包含 GTID 导致您的用例出现已知问题时，您才应使用此选项。

--socket=path, -S path

对于与 的连接localhost，要使用的 Unix 套接字文件，或者在 Windows 上，要使用的命名管道的名称。

在 Windows 上，仅当服务器启动时named_pipe 启用了支持命名管道连接的系统变量时，此选项才适用。此外，进行连接的用户必须是 named_pipe_full_access_group 系统变量指定的 Windows 组的成员。

--ssl*

以 开头的选项--ssl指定是否使用加密连接到服务器并指示在哪里可以找到 SSL 密钥和证书。请参阅 加密连接的命令选项。

--start-datetime=datetime

在时间戳等于或晚于 datetime参数的第一个事件开始读取二进制日志。该 datetime值相对于您运行 mysqlbinlog的机器上的本地时区。该值应采用 DATETIME或 TIMESTAMP数据类型可接受的格式。例如：

mysqlbinlog --start-datetime="2005-12-25 11:25:56" binlog.000003

此选项对于时间点恢复很有用。请参阅 第 7.5 节，“时间点（增量）恢复”。

--start-position=N, -j N

在位置等于或大于 的第一个事件开始读取二进制日志 N。此选项适用于在命令行上命名的第一个日志文件。

此选项对于时间点恢复很有用。请参阅 第 7.5 节，“时间点（增量）恢复”。

--stop-datetime=datetime

在时间戳等于或晚于 datetime参数的第一个事件处停止读取二进制日志。--start-datetime有关该值的信息， 请参阅选项的描述 datetime。

此选项对于时间点恢复很有用。请参阅 第 7.5 节，“时间点（增量）恢复”。

--stop-never

此选项与 一起使用 --read-from-remote-server。它告诉mysqlbinlog保持与服务器的连接。否则 ，当最后一个日志文件从服务器传输时，mysqlbinlog退出。--stop-never 暗示--to-last-log，因此只需要在命令行上命名要传输的第一个日志文件。

--stop-never通常用于--raw制作实时二进制日志备份，但也可用于 --raw在服务器生成日志事件时不维护日志事件的连续文本显示。

--stop-never-slave-server-id=id

使用--stop-never， mysqlbinlog在连接到服务器时报告服务器 ID 为 65535。 --stop-never-slave-server-id 明确指定要报告的服务器 ID。它可用于避免与副本服务器或另一个mysqlbinlog进程的 ID 发生冲突。请参阅 第 4.6.7.4 节，“指定 mysqlbinlog 服务器 ID”。

--stop-position=N

在第一个位置等于或大于 的事件处停止读取二进制日志 N。此选项适用于在命令行中命名的最后一个日志文件。

此选项对于时间点恢复很有用。请参阅 第 7.5 节，“时间点（增量）恢复”。

--tls-version=protocol_list

加密连接允许的 TLS 协议。该值是一个或多个以逗号分隔的协议名称的列表。可以为此选项命名的协议取决于用于编译 MySQL 的 SSL 库。有关详细信息，请参阅 第 6.3.2 节，“加密连接 TLS 协议和密码”。

这个选项是在 MySQL 5.7.10 中添加的。

--to-last-log, -t

不要在 MySQL 服务器请求的二进制日志结束时停止，而是继续打印直到最后一个二进制日志结束。如果将输出发送到同一个 MySQL 服务器，这可能会导致死循环。此选项需要 --read-from-remote-server.

--user=user_name, -u user_name

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

--verbose, -v

重建行事件并将它们显示为带注释的 SQL 语句。如果此选项给出两次（通过传入“-vv”或“--verbose --verbose”），则输出包括指示列数据类型和一些元数据的注释，以及行查询日志事件（如果已配置）。

有关显示 行事件输出的影响的示例，请参阅--base64-output第 4.6.7.2 节，“mysqlbinlog 行事件显示”。 --verbose

--verify-binlog-checksum, -c

验证二进制日志文件中的校验和。

--version, -V

显示版本信息并退出。

在 MySQL 5.7 中，mysqlbinlog版本号为 3.4。