性能和可扩展性注意事项

调用语法

选项语法 - 字母顺序总结

连接选项

选项文件选项

DDL 选项

调试选项

帮助选项

国际化选项

复制选项

格式选项

过滤选项

性能选项

事务选项

选项组

示例

限制

--bind-address=ip_address

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

--compress, -C

在可能的情况下压缩客户端和服务器之间的所有信息。见 第 6.2.8 节，“连接压缩控制”。

该选项已弃用。预计在未来版本的 MySQL 中删除。见 配置遗留连接压缩。

--compression-algorithms=value

服务器连接的可接受压缩算法。可用的算法与 protocol_compression_algorithms 系统变量相同。默认值为 uncompressed。

更多信息，请参见 第 6.2.8 节，“连接压缩控制”。

--default-auth=插件

关于客户端身份验证插件的提示。见 第 8.2.17 节，“可插拔身份验证”。

--enable-cleartext-plugin

启用 mysql_clear_password 明文身份验证插件。（见 第 8.4.1.4 节，“客户端明文可插拔身份验证”。）

--get-server-public-key

从服务器请求用于 RSA 密钥对基于密码交换的公钥。此选项适用于使用 caching_sha2_password 身份验证插件的客户端。对于该插件，服务器不会发送公钥，除非被请求。此选项将被忽略，如果客户端使用安全连接连接到服务器时，不使用 RSA 基于密码交换。

如果 --server-public-key-path=文件名 被指定并指定了有效的公钥文件，它将优先于 --get-server-public-key。

关于 caching_sha2_password 插件的信息，见 第 8.4.1.2 节，“caching SHA-2 可插拔身份验证”。

--host=主机名, -h 主机名

从指定的 MySQL 服务器主机上转储数据。默认主机是 localhost。

--login-path=名称

从命名的登录路径文件中读取选项。.mylogin.cnf 登录路径文件。一个 “登录路径” 是一个选项组，包含指定要连接的 MySQL 服务器和要身份验证的账户的选项。要创建或修改登录路径文件，请使用 mysql_config_editor 实用程序。见 第 6.6.7 节，“mysql_config_editor — MySQL 配置实用程序”。

关于这个和其他选项文件选项的更多信息，见 第 6.2.2.3 节，“命令行选项影响选项文件处理”。

--no-login-paths

跳过从登录路径文件中读取选项。

见 --login-path 有关信息。

关于这个和其他选项文件选项的更多信息，见 第 6.2.2.3 节，“命令行选项影响选项文件处理”。

--password[=密码], -p[密码]

MySQL 帐户用于连接到服务器的密码。密码值是可选的。如果不给出，mysqldump 将提示输入。如果给出，必须在 --password= 或 -p 和其后的密码之间没有空格。如果没有指定密码选项，默认情况下不发送密码。

在命令行上指定密码应该被认为是不安全的。要避免在命令行上给出密码，请使用选项文件。见 第 8.1.2.1 节，“最终用户密码安全指南”。

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

--password1[=pass_val]

MySQL 帐户用于连接到服务器的多因素身份验证因子 1 的密码。密码值是可选的。如果不给出，mysqldump 将提示输入。如果给出，必须在 --password1= 和其后的密码之间没有空格。如果没有指定密码选项，默认情况下不发送密码。

在命令行上指定密码应该被认为是不安全的。要避免在命令行上给出密码，请使用选项文件。见 第 8.1.2.1 节，“最终用户密码安全指南”。

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

--password1 和 --password 是同义的，如同 --skip-password1 和 --skip-password。

--password2[=pass_val]

MySQL 帐户用于连接到服务器的多因素身份验证因子 2 的密码。该选项的语义与 --password1 的语义相似；见该选项的描述以获取详细信息。

--password3[=pass_val]

MySQL 帐户用于连接到服务器的多因素身份验证因子 3 的密码。该选项的语义与 --password1 的语义相似；见该选项的描述以获取详细信息。

--pipe, -W

在 Windows 上，使用命名管道连接到服务器。该选项仅适用于服务器启用了 named_pipe 系统变量以支持命名管道连接。此外，进行连接的用户必须是 Windows 组 named_pipe_full_access_group 的成员。

--plugin-authentication-kerberos-client-mode=value

在 Windows 上，该 authentication_kerberos_client 认证插件支持该插件选项。它提供了两个可能的值，客户端用户可以在运行时设置：SSPI 和 GSSAPI。

客户端插件选项的默认值使用 Security Support Provider Interface (SSPI)，该接口能够从 Windows 内存缓存中获取凭据。或者，客户端用户可以选择支持 Generic Security Service Application Program Interface (GSSAPI) 的模式，通过 Windows 上的 MIT Kerberos 库。GSSAPI 能够获取以前使用 kinit 命令生成的缓存凭据。

有关更多信息，请参阅 Windows 客户端的 GSSAPI 模式命令。

--plugin-dir=dir_name

要查找插件的目录。如果使用 --default-auth 选项指定认证插件，但 mysqldump 未找到它。请参阅 第 8.2.17 节，“可插拔认证”。

--port=port_num, -P port_num

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

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

用于连接到服务器的传输协议。当其他连接参数通常导致使用其他协议时，该选项非常有用。有关允许值的详细信息，请参阅 第 6.2.7 节，“连接传输协议”。

--server-public-key-path=file_name

包含服务器所需的公钥文件的路径名，用于 RSA 密钥对基于的密码交换。该选项适用于使用 sha256_password 或 caching_sha2_password 认证插件的客户端。如果客户端使用安全连接连接到服务器，该选项将被忽略。

如果 --server-public-key-path=file_name 指定了有效的公钥文件，它将优先于 --get-server-public-key。

对于 sha256_password，该选项仅在 MySQL 使用 OpenSSL 构建时适用。

有关 sha256_password 和 caching_sha2_password 插件的信息，请参阅 第 8.4.1.3 节，“SHA-256 可插拔认证” 和 第 8.4.1.2 节，“caching SHA-2 可插拔认证”。

--socket=path, -S path

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

在 Windows 上，这个选项仅在服务器以 named_pipe 系统变量启用以支持命名管道连接的情况下生效。此外，进行连接的用户必须是 Windows 组 named_pipe_full_access_group 系统变量指定的成员。

--ssl*

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

--ssl-fips-mode={OFF|ON|STRICT}

控制客户端是否启用 FIPS 模式。该 --ssl-fips-mode 选项不同于其他 --ssl-xxx 选项，因为它不是用于建立加密连接，而是影响哪些加密操作被允许。请参阅 第 8.8 节，“FIPS 支持”。

这些 --ssl-fips-mode 值是允许的：

该选项已弃用。预计在未来版本的 MySQL 中将被删除。

--tls-ciphersuites=ciphersuite_list

用于 TLSv1.3 加密连接的允许密码套件列表。该值是一个或多个以冒号分隔的密码套件名称。可以命名的密码套件取决于编译 MySQL 的 SSL 库。详细信息，请参阅 第 8.3.2 节，“加密连接 TLS 协议和密码”。

--tls-sni-servername=server_name

当指定时，该名称将传递给 libmysqlclient C API 库使用 MYSQL_OPT_TLS_SNI_SERVERNAME 选项的 mysql_options()。服务器名称不区分大小写。要显示客户端当前会话中指定的服务器名称（如果有），请检查 Tls_sni_server_name 状态变量。

服务器名称指示（SNI）是 TLS 协议的扩展（OpenSSL 必须使用 TLS 扩展编译以使该选项生效）。MySQL 实现 SNI 仅表示客户端。

--tls-version=protocol_list

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

--user=用户名, -u 用户名

用于连接服务器的MySQL帐户用户名。

如果您使用Rewriter插件，应该授予该用户SKIP_QUERY_REWRITE特权。

--zstd-compression-level=级别

用于服务器连接的zstd压缩算法的压缩级别。允许的级别从1到22，较高的值表示较高的压缩级别。默认的zstd压缩级别为3。压缩级别设置对不使用zstd压缩的连接没有影响。

有关更多信息，请参阅第6.2.8节，“连接压缩控制”。

--defaults-extra-file=文件名

在全局选项文件之后但在用户选项文件之前读取该选项文件。如果文件不存在或不可访问，将发生错误。如果文件名不是绝对路径名，则相对于当前目录进行解释。

有关更多信息，请参阅第6.2.2.3节，“命令行选项影响选项文件处理”。

--defaults-file=文件名

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

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

有关更多信息，请参阅第6.2.2.3节，“命令行选项影响选项文件处理”。

--defaults-group-suffix=str

不仅读取通常的选项组，还读取具有通常名称和str后缀的组。例如，mysqldump通常读取[client]和[mysqldump]组。如果给出这个选项作为--defaults-group-suffix=_other，mysqldump还将读取[client_other]和[mysqldump_other]组。

有关更多信息，请参阅第6.2.2.3节，“命令行选项影响选项文件处理”。

--不读取默认值

不要读取任何选项文件。如果程序启动失败是由于从选项文件中读取未知选项，--不读取默认值 可以用于防止它们被读取。

唯一的例外是，如果存在，.mylogin.cnf 文件总是被读取。这允许在命令行上以更安全的方式指定密码，即使使用 --不读取默认值。要创建 .mylogin.cnf，使用 mysql_config_editor 实用程序。见 第 6.6.7 节，“mysql_config_editor — MySQL 配置实用程序”。

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

--打印默认值

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

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

--添加删除数据库

在每个 CREATE DATABASE 语句之前写入一个 DROP DATABASE 语句。该选项通常与 --所有数据库 或 --数据库 选项一起使用，因为没有 CREATE DATABASE 语句被写入，除非指定了其中一个选项。

--添加删除表

在每个 CREATE TABLE 语句之前写入一个 DROP TABLE 语句。

--添加删除触发器

编写一个 DROP TRIGGER 语句在每个 CREATE TRIGGER 语句之前。

--all-tablespaces, -Y

将所有 SQL 语句添加到表转储中，以创建任何由 NDB 表所使用的表空间。这信息不包括在 mysqldump 的输出中。这选项当前仅适用于 NDB 集群表。

--no-create-db, -n

抑制 CREATE DATABASE 语句，这些语句否则将包含在输出中，如果给出了 --databases 或 --all-databases 选项。

--no-create-info, -t

不写入 CREATE TABLE 语句，以创建每个转储表。

--no-tablespaces, -y

该选项抑制所有 CREATE LOGFILE GROUP 和 CREATE TABLESPACE 语句在 mysqldump 输出中。

--replace

编写 REPLACE 语句，而不是 INSERT 语句。

--allow-keywords

允许创建关键字作为列名。这通过在每个列名前面加上表名来实现。

--comments, -i

在转储文件中写入附加信息，例如程序版本、服务器版本和主机。这选项默认启用。要抑制这些附加信息，请使用 --skip-comments。

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

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

只有在 MySQL 使用 WITH_DEBUG 选项构建时，才可以使用该选项。 Oracle 提供的 MySQL 发行版二进制文件 不 使用该选项构建。

--debug-check

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

只有在 MySQL 使用 WITH_DEBUG 选项构建时，才可以使用该选项。 Oracle 提供的 MySQL 发行版二进制文件 不 使用该选项构建。

--debug-info

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

只有在 MySQL 使用 WITH_DEBUG 选项构建时，才可以使用该选项。 Oracle 提供的 MySQL 发行版二进制文件 不 使用该选项构建。

--dump-date

如果给定了 --comments 选项，mysqldump 在转储文件的末尾生成以下形式的注释：

-- Dump completed on DATE

然而，日期使得在不同时间拍摄的转储文件看起来不同，即使数据否则相同。--dump-date 和 --skip-dump-date 控制是否将日期添加到注释中。默认是 --dump-date（在注释中包括日期）。 --skip-dump-date 取消日期打印。

--force, -f

忽略所有错误；即使在表转储期间发生 SQL 错误，也继续执行。

该选项的一个用途是使 mysqldump 继续执行，即使遇到无效的视图，因为视图的定义引用了已删除的表。没有 --force，mysqldump 将退出并显示错误消息。使用 --force，mysqldump 将打印错误消息，但也将视图定义写入转储输出并继续执行。

如果也给出了 --ignore-error 选项以忽略特定错误，--force 优先。

--log-error=file_name

将警告和错误追加到指定文件中。默认是不进行日志记录。

--skip-comments

请参阅 --comments 选项的描述。

--verbose, -v

详细模式。打印程序执行的更多信息。

--help, -?

显示帮助信息并退出。

--version, -V

显示版本信息并退出。

--character-sets-dir=dir_name

字符集安装的目录。见 第 12.15 节，“字符集配置”。

--default-character-set=charset_name

使用 charset_name 作为默认字符集。见 第 12.15 节，“字符集配置”。如果没有指定字符集，mysqldump 使用 utf8mb4。

--no-set-names, -N

关闭 --set-charset 设置，相当于指定 --skip-set-charset。

--set-charset

写入 SET NAMES default_character_set 到输出中。该选项默认启用。要抑制 SET NAMES 语句，请使用 --skip-set-charset。

--apply-replica-statements

对于使用 --dump-replica 选项生成的副本转储，添加一个 STOP REPLICA 语句在二进制日志坐标语句之前，并在输出的末尾添加一个 START REPLICA 语句。

--应用从属语句

这是一个 deprecated 别名为 --应用副本语句。

--删除源日志

在复制源服务器上，删除二进制日志通过向服务器发送 PURGE BINARY LOGS 语句来删除二进制日志，执行转储操作后。该选项需要 RELOAD 权限以及执行该语句所需的权限。该选项自动启用 --源数据。

--删除主日志

这是一个 deprecated 别名为 --删除源日志。

--转储副本[=值]

该选项类似于 --源数据，except that it's used to dump a 副本服务器以生成一个转储文件，该文件可以用于设置另一个服务器作为副本，该副本具有与被转储服务器相同的源。该选项会导致转储输出包括一个 CHANGE REPLICATION SOURCE TO 语句，该语句指示了被转储副本的源二进制日志坐标（文件名和位置）。该 CHANGE REPLICATION SOURCE TO 语句从 SHOW REPLICA STATUS 输出中读取 Relay_Master_Log_File 和 Exec_Master_Log_Pos 的值，并将其用于 SOURCE_LOG_FILE 和 SOURCE_LOG_POS 分别。这是从中复制的源服务器坐标。

--转储副本 使用源坐标，而不是被转储服务器的坐标，如 --源数据 所做的那样。此外，指定该选项将覆盖 --源数据 选项。

该选项值的处理方式与 --源数据 相同。设置无值或 1 将导致 CHANGE REPLICATION SOURCE TO 语句被写入转储中。设置 2 将导致语句被写入，但被 SQL 注释所包围。它与 --源数据 在启用或禁用其他选项和锁定处理方面具有相同的效果。

--转储副本 导致 mysqldump 在转储之前停止复制 SQL 线程，并在转储后重新启动它。

--dump-replica 将发送一个 SHOW REPLICA STATUS 语句到服务器，以获取信息，因此需要执行该语句所需的权限。

--apply-replica-statements 和 --include-source-host-port 选项可以与 --dump-replica 一起使用。

--dump-slave[=value]

这是 --dump-replica 的废弃别名。

--include-source-host-port

将 SOURCE_HOST 和 SOURCE_PORT 选项添加到使用 --dump-replica 选项生成的副本转储中的 CHANGE REPLICATION SOURCE TO 语句中。

--include-master-host-port

这是 --include-source-host-port 的废弃别名。

--master-data[=value]

这是 --source-data 的废弃别名。

--output-as-version=value

确定了副本和事件相关语句的术语级别，使得可以创建与旧版本 MySQL 兼容的转储。此选项可以取以下任何一个值，效果如下所述：

该选项影响--events、--dump-replica、--source-data、--apply-replica-statements和--include-source-host-port的输出。

从 MySQL 8.2.0 版本添加。

--source-data[=值]

用于将复制源服务器转储到生成一个转储文件，以便在另一个服务器上设置为源服务器的副本。该选项会导致转储输出包括一个CHANGE REPLICATION SOURCE TO语句，该语句指示了被转储服务器的二进制日志坐标（文件名和位置），这些坐标将是副本服务器从中开始复制的坐标。

如果选项值为 2，则CHANGE REPLICATION SOURCE TO语句将作为 SQL 注释写入，从而没有实际效果。当选项值为 1 时，该语句将被写入并生效。如果没有指定选项值，默认值为 1。

--source-data 将发送一个SHOW BINARY LOG STATUS语句到服务器，以获取信息，因此需要执行该语句的权限。此选项还需要RELOAD权限，并且二进制日志必须启用。

--source-data 自动关闭--lock-tables。它们还打开--lock-all-tables--single-transaction也被指定，在这种情况下，仅在转储开始时获取全局读锁（见--single-transaction的描述）。在所有情况下，日志操作都发生在转储的确切时刻。

也可以通过转储现有的源服务器副本来设置副本，使用--dump-replica选项，该选项将覆盖--source-data，使其被忽略。

--set-gtid-purged=值

此选项适用于使用基于GTID的复制的服务器 (gtid_mode=ON)。它控制在转储输出中包括一个 SET @@GLOBAL.gtid_purged 语句，该语句在服务器上重新加载转储文件时更新 gtid_purged 的值，以添加源服务器的 gtid_executed 系统变量中的GTID集。gtid_purged 持有服务器上应用的所有事务的GTID，但这些事务不在服务器的任何二进制日志文件中。mysqldump 因此添加了源服务器上执行的事务的GTID，以便目标服务器记录这些事务为已应用，尽管它们不在其二进制日志中。--set-gtid-purged 选项还控制了一个 SET @@SESSION.sql_log_bin=0 语句的包括，该语句在重新加载转储文件时禁用二进制日志记录，以防止新的GTID被生成并分配给转储文件中的事务。

如果您不设置 --set-gtid-purged 选项，默认情况下，如果服务器启用了GTID，并且 gtid_executed 系统变量的全局值不为空，则将在转储输出中包括一个 SET @@GLOBAL.gtid_purged 语句。还将包括一个 SET @@SESSION.sql_log_bin=0 语句，如果服务器启用了GTID。

您可以将 gtid_purged 的值替换为指定的GTID集，或者在语句中添加一个加号 (+) 以将指定的GTID集追加到 gtid_purged 的值中。mysqldump 记录的 SET @@GLOBAL.gtid_purged 语句包括一个版本特定的注释，以便MySQL将GTID集从转储文件添加到现有的 gtid_purged 值中。

需要注意的是，mysqldump 为 SET @@GLOBAL.gtid_purged 语句包括的值包括服务器上 gtid_executed 集中的所有事务的GTID，即使这些事务更改了数据库的某些部分，或者其他数据库在服务器上没有包括在部分转储中。这可能意味着，在目标服务器上重新加载转储文件后，GTID集将包含不相关的GTID，这些GTID不属于目标服务器上的任何数据。如果您不重新加载其他转储文件到目标服务器上，这些额外的GTID不会对服务器的未来操作造成任何问题，但它们使得在复制拓扑结构中比较或协调GTID集变得更加困难。如果您重新加载了其他转储文件到目标服务器上，其中包含相同的GTID（例如，来自同一源服务器的其他部分转储），那么任何 SET @@GLOBAL.gtid_purged 语句在第二个转储文件中将失败。在这种情况下，您可以手动删除语句，然后重新加载转储文件，或者输出转储文件时不包括语句。

如果 SET @@GLOBAL.gtid_purged 语句在目标服务器上不产生所需的结果，您可以从输出中排除语句，或者将其注释掉，以便在重新加载转储文件时不自动执行。您也可以包括语句，但手动编辑转储文件以达到所需的结果。

以下是 --set-gtid-purged 选项的可能值：

--compact

生成更紧凑的输出。此选项启用 --skip-add-drop-table、--skip-add-locks、--skip-comments、--skip-disable-keys 和 --skip-set-charset 选项。

--compatible=name

生成与其他数据库系统或旧版本 MySQL 服务器更兼容的输出。该选项的唯一允许值是 ansi，它与服务器 SQL 模式的对应选项具有相同的含义。请参阅 第 7.1.11 节，“服务器 SQL 模式”。

--complete-insert, -c

使用完整的 INSERT 语句，包括列名。

--create-options

包括所有 MySQL 特定表选项在 CREATE TABLE 语句中。

--fields-terminated-by=..., --fields-enclosed-by=..., --fields-optionally-enclosed-by=..., --fields-escaped-by=...

这些选项与 --tab 选项一起使用，具有与 FIELDS 子句相同的含义 LOAD DATA。见 第 15.2.9 节，“LOAD DATA 语句”。

--hex-blob

使用十六进制表示形式转储二进制列（例如，'abc' 变为 0x616263）。受影响的数据类型是 BINARY、VARBINARY、BLOB 类型、BIT，所有空间数据类型，以及使用 binary 字符集 的其他非二进制数据类型。

当使用 --tab 时，忽略 --hex-blob 选项。

--lines-terminated-by=...

该选项与 --tab 选项一起使用，具有与 LINES 子句相同的含义 LOAD DATA。见 第 15.2.9 节，“LOAD DATA 语句”。

--quote-names, -Q

在 ` 字符中引用标识符（例如数据库、表和列名）。如果启用了 ANSI_QUOTES SQL 模式，则标识符将在 " 字符中引用。此选项默认启用，可以使用 --skip-quote-names 禁用，但这应该在任何可能启用 --quote-names 的选项（例如 --compatible）之后。

--result-file=file_name, -r file_name

将输出直接写入指定的文件中。结果文件将被创建，并且其先前的内容将被覆盖，即使在生成转储时发生错误。

在 Windows 上使用此选项，以防止换行 \n 字符被转换为 \r\n 回车换行序列。

--显示创建跳过次要引擎=值

从 CREATE TABLE 语句中排除 SECONDARY ENGINE 子句。它通过在转储操作期间启用 show_create_table_skip_secondary_engine 系统变量来实现。或者，您可以在使用 mysqldump 之前启用 show_create_table_skip_secondary_engine 系统变量。

--tab=dir_name, -T dir_name

生成制表符分隔的文本格式数据文件。对于每个转储表，mysqldump 创建一个 tbl_name.sql 文件，其中包含创建表的 CREATE TABLE 语句，并将服务器写入一个 tbl_name.txt 文件，其中包含其数据。选项值是写入文件的目录。

默认情况下，.txt 数据文件使用制表符分隔列值和每行结尾的换行符。可以使用 --fields-xxx 和 --lines-terminated-by 选项显式指定格式。

列值将被转换为由 --default-character-set 选项指定的字符集。

--tz-utc

此选项启用 TIMESTAMP 列在不同时区的服务器之间的转储和重新加载。 mysqldump 将其连接时区设置为 UTC，并将 SET TIME_ZONE='+00:00' 添加到转储文件中。否则，TIMESTAMP 列将在源服务器和目标服务器的本地时区中转储和重新加载，这可能会导致值更改。如果服务器在不同的时区中，--tz-utc 也可以防止夏令时的更改。--tz-utc 默认启用。要禁用它，请使用 --skip-tz-utc。

--xml, -X

将转储输出写入格式良好的 XML。

NULL、'NULL' 和空值: 对于一个名为 column_name 的列，NULL 值、空字符串和字符串值 'NULL' 在输出中是区分开的，如下所示。

使用 mysql 客户端时，输出也遵循上述规则。（见 第 6.5.1.1 节，“mysql 客户端选项”。）

使用 mysqldump 生成的 XML 输出包括 XML 命名空间，如下所示：

$> mysqldump --xml -u root world City
<?xml version="1.0"?>
<mysqldump xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<database name="world">
<table_structure name="City">
<field Field="ID" Type="int(11)" Null="NO" Key="PRI" Extra="auto_increment" />
<field Field="Name" Type="char(35)" Null="NO" Key="" Default="" Extra="" />
<field Field="CountryCode" Type="char(3)" Null="NO" Key="" Default="" Extra="" />
<field Field="District" Type="char(20)" Null="NO" Key="" Default="" Extra="" />
<field Field="Population" Type="int(11)" Null="NO" Key="" Default="0" Extra="" />
<key Table="City" Non_unique="0" Key_name="PRIMARY" Seq_in_index="1" Column_name="ID"
Collation="A" Cardinality="4079" Null="" Index_type="BTREE" Comment="" />
<options Name="City" Engine="MyISAM" Version="10" Row_format="Fixed" Rows="4079"
Avg_row_length="67" Data_length="273293" Max_data_length="18858823439613951"
Index_length="43008" Data_free="0" Auto_increment="4080"
Create_time="2007-03-31 01:47:01" Update_time="2007-03-31 01:47:02"
Collation="latin1_swedish_ci" Create_options="" Comment="" />
</table_structure>
<table_data name="City">
<row>
<field name="ID">1</field>
<field name="Name">Kabul</field>
<field name="CountryCode">AFG</field>
<field name="District">Kabol</field>
<field name="Population">1780000</field>
</row>

...

<row>
<field name="ID">4079</field>
<field name="Name">Rafah</field>
<field name="CountryCode">PSE</field>
<field name="District">Rafah</field>
<field name="Population">92020</field>
</row>
</table_data>
</database>
</mysqldump>

--all-databases, -A

转储所有数据库中的所有表。这与使用 --databases 选项并在命令行上命名所有数据库相同。

在 MySQL 8.3 之前，--routines 和 --events 选项对于 mysqldump 和 mysqlpump 不是必需的，以包括存储的例程和事件时使用 --all-databases 选项：转储包括 mysql 系统数据库，因此也包括 mysql.proc 和 mysql.event 表，其中包含存储的例程和事件定义。从 MySQL 8.3 开始，mysql.event 和 mysql.proc 表不再使用。相应对象的定义存储在数据字典表中，但这些表不被转储。要在使用 --all-databases 选项时包括存储的例程和事件，请明确使用 --routines 和 --events 选项。

--databases, -B

转储多个数据库。通常，mysqldump 将命令行上的第一个名称参数视为数据库名称，后续名称参数视为表名称。使用此选项时，它将所有名称参数视为数据库名称。CREATE DATABASE 和 USE 语句将包含在输出中，每个新数据库之前。

该选项可用于转储 performance_schema 数据库，该数据库通常不会被转储，即使使用 --all-databases 选项。（也使用 --skip-lock-tables 选项。）

--events, -E

在输出中包括 Event Scheduler 事件 для转储的数据库。该选项需要对这些数据库具有 EVENT 权限。

使用 --events 生成的输出包含 CREATE EVENT 语句，以创建事件。

--ignore-error=error[,error]...

忽略指定的错误。该选项的值是一个逗号分隔的错误号列表，指定要忽略的错误。在 mysqldump 执行期间忽略这些错误。如果也给出了 --force 选项以忽略所有错误，--force 选项优先。

--ignore-table=db_name.tbl_name

不要转储指定的表，该表必须使用数据库和表名指定。要忽略多个表，请多次使用该选项。该选项也可以用来忽略视图。

--ignore-views=boolean

跳过转储文件中的表视图。该选项添加于 MySQL 8.2.0。

--init-command=str

在连接到 MySQL 服务器后执行的单个 SQL 语句。该定义重置了由它或 init-command-add 定义的现有语句。该选项添加于 MySQL 8.2.0。

--init-command-add=str

添加一个额外的 SQL 语句，以在连接或重新连接到 MySQL 服务器后执行。它可以与 --init-command 一起使用，但如果在 init-command 之前使用，则无效。该选项添加于 MySQL 8.2.0。

--no-data, -d

不要写入任何表行信息（即，不要转储表内容）。这在您只想转储表的 CREATE TABLE 语句时很有用（例如，通过加载转储文件来创建表的空副本）。

--routines, -R

在输出中包括存储的例程（过程和函数） для转储的数据库。该选项需要全局 SELECT 权限。

输出生成使用 --routines 包含 CREATE PROCEDURE 和 CREATE FUNCTION 语句来创建例程。

--skip-generated-invisible-primary-key

该选项导致生成的不可见主键从输出中排除。有关更多信息，请参阅 第 15.1.20.11 节，“生成的不可见主键”。

--tables

覆盖 --databases 或 -B 选项。mysqldump 将所有名称参数视为表名，位于该选项之后。

--triggers

在输出中包括每个转储表的触发器。该选项默认启用；使用 --skip-triggers 禁用它。

要转储表的触发器，您必须拥有该表的 TRIGGER 权限。

允许多个触发器。mysqldump 按激活顺序转储触发器，以便在重新加载转储文件时，触发器以相同的激活顺序创建。然而，如果 mysqldump 转储文件包含多个触发器，用于同一个表的同一个触发事件和操作时间，那么尝试加载转储文件到较旧的服务器时将出现错误，该服务器不支持多个触发器。（有关解决方法，请参阅 降级说明；您可以将触发器转换为与较旧服务器兼容。）

--where='where_condition', -w 'where_condition'

仅转储由给定的 WHERE 条件所选定的行。命令解释器中的特殊字符需要在条件周围加引号。

示例：

--where="user='jimf'"
-w"userid>1"
-w"userid<1"

--column-statistics

将 ANALYZE TABLE 语句添加到输出中，以便在重新加载转储文件时生成直方图统计信息。该选项默认禁用，因为大型表的直方图生成可能需要很长时间。

--disable-keys, -K

对于每个表，使用INSERT语句，surround它们以/*!40000 ALTER TABLE tbl_name DISABLE KEYS */;和/*!40000 ALTER TABLE tbl_name ENABLE KEYS */;语句。这使得加载转储文件变得更快，因为索引是在所有行插入后创建的。此选项仅对MyISAM表的非唯一索引有效。

--extended-insert, -e

使用多行语法编写INSERT语句，包括多个VALUES列表。这将生成较小的转储文件，并加速重新加载时的插入。

--insert-ignore

编写INSERT IGNORE语句，而不是INSERT语句。

--max-allowed-packet=value

客户端/服务器通信的缓冲区的最大大小。默认值为 24MB，最大值为 1GB。

--mysqld-long-query-time=value

设置会话值long_query_time系统变量。使用此选项，如果您想增加mysqldump查询的时间限制，以便它们被记录到慢查询日志文件中。mysqldump执行全表扫描，这意味着其查询经常超过全局long_query_time设置，该设置对常规查询很有用。默认全局设置为 10 秒。

您可以使用--mysqld-long-query-time指定会话值，从 0（意味着mysqldump的每个查询都记录到慢查询日志文件中）到 31536000，即 365 天的秒数。对于mysqldump的选项，您只能指定整秒。当您不指定此选项时，服务器的全局设置将应用于mysqldump的查询。

--net-buffer-length=value

初始客户端/服务器通信缓冲区的大小。当创建多行INSERT语句（如使用--extended-insert或--opt选项）时，mysqldump创建的行长达--net-buffer-length字节。如果您增加这个变量，请确保 MySQL 服务器net_buffer_length系统变量的值至少与此相同。

--network-timeout, -M

启用大型表的转储，通过将--max-allowed-packet设置为其最大值，并将网络读取和写入超时设置为大值。该选项默认启用。要禁用它，请使用--skip-network-timeout。

--opt

该选项，默认启用，是--add-drop-table --add-locks --create-options --disable-keys --extended-insert --lock-tables --quick --set-charset的快捷方式。它提供了快速的转储操作，并生成可以快速重新加载到 MySQL 服务器的转储文件。

因为--opt选项默认启用，因此您只需要指定其反义词--skip-opt来关闭几个默认设置。请参阅mysqldump选项组关于选择性启用或禁用--opt影响的选项的信息。

--quick, -q

该选项对转储大型表非常有用。它强制mysqldump从服务器逐行检索表的行，而不是检索整个行集并将其缓存在内存中，然后写入。

--skip-opt

请参阅--opt选项的描述。

--add-locks

在每个表转储之间添加LOCK TABLES和UNLOCK TABLES语句。这将在重新加载转储文件时加速插入操作。请参阅第 10.2.5.1 节，“优化 INSERT 语句”。

--刷新日志, -F

在开始转储之前刷新 MySQL 服务器日志文件。该选项需要 RELOAD 权限。如果您将该选项与 --所有数据库 选项结合使用，则每个被转储的数据库的日志都会被刷新。except when using --锁定所有表, --源数据, 或 --单个事务。在这些情况下，日志仅在所有表被锁定时刷新一次，相应于 FLUSH TABLES WITH READ LOCK 的时刻。如果您想让转储和日志刷新同时发生，请使用 --刷新日志 与 --锁定所有表, --源数据, 或 --单个事务。

--刷新权限

将 FLUSH PRIVILEGES 语句添加到转储输出中，在转储 mysql 数据库后。这选项应该在转储包含 mysql 数据库和任何其他依赖于 mysql 数据库数据的数据库时使用。

因为转储文件包含 FLUSH PRIVILEGES 语句，因此重新加载文件需要足够的权限来执行该语句。

--锁定所有表, -x

跨所有数据库锁定所有表。这是通过获取全局读锁来实现的，锁定整个转储过程。这选项自动关闭 --单个事务 和 --锁定表。

--锁定表, -l

对于每个被转储的数据库，锁定要转储的所有表。在转储 MyISAM 表时，使用 READ LOCAL 锁以允许并发插入。在转储事务表（如 InnoDB）时，--单个事务 是一个更好的选择，因为它不需要锁定表。

因为 --锁定表 对每个数据库单独锁定表，因此该选项不能保证转储文件中的表在不同数据库之间逻辑一致。

一些选项，如 --opt, 自动启用 --锁定表。如果您想覆盖该选项，请在选项列表末尾使用 --skip-lock-tables。

--不自动提交

将每个转储表的 INSERT 语句括在 SET autocommit = 0 和 COMMIT 语句中。

--按主键排序

将每个表的行排序到其主键，或者如果存在唯一索引，则排序到该索引。这在将 MyISAM 表dump到 InnoDB 表时非常有用，但这将使dump操作时间大大增加。

--共享内存基准名称=名称

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

该选项仅在服务器启动时启用了 shared_memory 系统变量以支持共享内存连接时生效。

--单个事务

该选项将事务隔离模式设置为 可重复读，并在dump数据之前向服务器发送 START TRANSACTION SQL 语句。它仅对事务表（如 InnoDB）有用，因为它dump数据库的一致状态，而不阻塞任何应用程序。

需要 RELOAD 或 FLUSH_TABLES 权限与 --单个事务 一起使用，如果 gtid_mode=ON 且 --set-gtid=purged=ON|AUTO。

使用该选项时，需要注意只有 InnoDB 表被dump到一致状态。例如，任何 MyISAM 或 MEMORY 表在使用该选项时dump的状态可能仍然会改变。

在使用 --单个事务 dump 时，为了确保有效的dump文件（正确的表内容和二进制日志坐标），不应在其他连接中使用以下语句：ALTER TABLE、CREATE TABLE、DROP TABLE、RENAME TABLE、TRUNCATE TABLE。一致读取不是从这些语句中隔离的，因此在要dump的表上使用这些语句可能会导致 SELECT 语句（由 mysqldump 执行）检索表内容时获得不正确的内容或失败。

选项 --单个事务 和 --锁定表 是互斥的，因为 LOCK TABLES 会隐式提交任何挂起的事务。

要dump大型表，请将 --单个事务 选项与 --快速 选项结合使用。

选项 --opt 将多个设置组合在一起，以执行快速dump操作。所有这些设置默认情况下都是启用的，因为 --opt 默认情况下是启用的。因此，您很少指定 --opt。相反，您可以通过指定 --skip-opt 来关闭这些设置，然后在命令行上重新启用相关选项。

该 --compact 选项关闭了控制可选语句和注释在输出中的显示的几个设置。再次，您可以跟随该选项使用其他选项重新启用某些设置，或者使用 --skip-compact 形式启用所有设置。

要选择 --opt 的效果，除了某些功能外，使用 --skip 选项对于每个功能。要禁用扩展插入和内存缓冲区，使用 --opt --skip-extended-insert --skip-quick。（实际上，--skip-extended-insert --skip-quick 足够，因为 --opt 默认启用。）

要反转 --opt 对于所有功能，除了禁用索引和表锁定，使用 --skip-opt --disable-keys --lock-tables。