性能和可扩展性考虑因素

调用语法

选项语法 - 字母表摘要

连接选项

配置文件选项

DDL 选项

调试选项

帮助选项

国际化选项

复制选项

格式选项

过滤选项

性能选项

事务选项

选项组

示例

限制

--bind-address=ip_地址

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

--compress, -C

如果可能，压缩客户端和服务器之间发送的所有信息。请参阅第6.2.8节，“连接压缩控制”。

这个选项已经过时。预计将来版本的MySQL中会移除它。请参阅配置遗留连接压缩。

--compression-algorithms=value

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

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

--default-auth=plugin

关于哪个客户端认证插件的提示。请参阅第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=file_name并且它指定了一个有效的公钥文件，那么它将优先于--get-server-public-key。

关于caching_sha2_password插件的信息，请参阅Section 8.4.1.2, “Caching SHA-2 Pluggable Authentication”。

--host=host_name, -h host_name

从MySQL服务器上导出数据，指定的主机。默认主机是localhost。

--login-path=name

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

关于此和其他选项文件选项的更多信息，请参阅Section 6.2.2.3, “Command-Line Options that Affect Option-File Handling”。

--no-login-paths

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

有关此选项的相关信息，请参阅--login-path。

关于此和其他选项文件选项的更多信息，请参阅Section 6.2.2.3, “Command-Line Options that Affect Option-File Handling”。

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

MySQL服务器连接用的帐户密码。密码值是可选的。如果不给出，mysqldump 会提示输入一个。如果给出，那么在--password=或-p后面不能有空格。如果没有指定密码选项，默认情况下不会发送密码。

在命令行上指定密码应该被认为是不安全的。为了避免在命令行上输入密码，使用选项文件。请参阅第8.1.2.1节，“用户密码安全指南”。

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

--password1[=pass_val]

用于连接到服务器的MySQL帐户的多因素认证第一个因素的密码。密码值是可选的。如果不给出，mysqldump 会提示输入一个。如果给出，那么在--password1=后面不能有空格。如果没有指定密码选项，默认情况下不会发送密码。

在命令行上指定密码应该被认为是不安全的。为了避免在命令行上输入密码，使用选项文件。请参阅第8.1.2.1节，“用户密码安全指南”。

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

--password1和--password是同义词，--skip-password1和--skip-password也是同义词。

--password2[=pass_val]

MySQL账户用于连接服务器的多因素认证第二因素密码。该选项的语义与--password1的语义相似；请参阅该选项的描述以获取详细信息。

--password3[=pass_val]

MySQL账户用于连接服务器的多因素认证第三因素密码。该选项的语义与--password1的语义相似；请参阅该选项的描述以获取详细信息。

--pipe, -W

在Windows上，使用命名管道连接到服务器。这一选项仅适用于服务器以支持命名管道连接的方式启动，并且执行连接的用户必须是由named_ pipe_full_access_group系统变量指定的Windows组成员。

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

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

默认情况下，用于客户端侧插件选项的值使用安全支持提供程序接口（SSPI），它能够从Windows内存缓存中获取凭据。或者，客户端用户可以选择一个模式，该模式通过MIT Kerberos库在Windows上支持通用安全服务应用程序程序接口（GSSAPI）。GSSAPI能够从以前使用kinit命令生成的缓存凭据中获取。

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

--plugin-dir=dir_name

指定插件目录。只有当使用--default-auth选项指定了认证插件，但mysqldump无法找到它时，需要指定这个选项。请参阅第8.2.17节，“可插拔认证”。

--port=端口号, -P 端口号

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

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

用于连接到服务器的传输协议。它在其他连接参数通常导致使用不同于您想要的协议时非常有用。在可接受值的详细信息，请参阅第6.2.7节，“连接传输协议”。

--server-public-key-path=文件名

包含服务器端公钥的PEM格式文件路径。这个选项适用于使用--server-public-key-path=文件名的客户端。这个选项对于不使用RSA密钥对密码交换的账户是被忽略的。这也适用于当客户端连接到服务器时使用安全连接时，RSA-基于密码交换不被使用的情况。

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

对于--server-public-key-path=文件名，这个选项仅适用于使用OpenSSL构建的MySQL版本。

关于 sha256_密码 和 缓存_sha2_密码 插件的信息，请参阅第 8.4.1.3 节，“SHA-256 可插拔认证”，以及第 8.4.1.2 节，“缓存 SHA-2 可插拔认证”。

--socket=路径, -S 路径

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

在 Windows 上，这个选项仅适用于服务器以支持命名管道启动时启用。另外，尝试连接的用户必须是由 named_pipe 系统变量指定的 Windows 组中的成员。

--ssl*

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

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

控制客户端是否启用 FIPS 模式。与其他以 --ssl-xxx 开头的选项不同，--ssl-fips-mode 选项不是用于建立加密连接的，而是用来影响哪些加密操作被允许。请参阅第 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_options() 的 MYSQL_ OPT_TLS_SNI_SERVERNAME 选项。服务器名称不区分大小写。要查看客户端为当前会话指定的服务器名称（如果有），请检查Tls_sni_server_name状态变量。

Server Name Indication (SNI) 是对TLS协议的扩展（OpenSSL必须使用TLS扩展编译以使此选项功能）。MySQL SNI实现仅限客户端。

--tls-version=protocol_list

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

--user=user_name, -u user_name

要用于连接到服务器的MySQL账户名称。

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

--zstd-compression-level=级别

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

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

--defaults-extra-file=文件名

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

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

--defaults-file=文件名

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

例外情况：即使有--defaults-file，客户端程序仍然读取.mylogin.cnf。

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

--defaults-group-suffix=字符串

除了常规的选项组外，还要阅读那些带有常规名称和一个后缀的 str 的选项组。例如，mysqldump 通常会读取 [client] 和 [mysqldump] 组。如果给出这样的选项 --defaults-group-suffix=_other，mysqldump 也会读取 [client_other] 和 [mysqldump_other] 组。

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

--no-defaults

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

唯一的例外是 .mylogin.cnf 文件总是在所有情况下都被读取，如果它存在。这允许在使用 --no-defaults 时安全地指定密码。要创建 .mylogin.cnf，请使用 mysql_config_editor 工具。参阅第 6.6.7 节，“mysql_config_editor — MySQL 配置编辑器”。

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

--print-defaults

打印程序名称及其来自选项文件的所有选项。

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

--add-drop-database

在每个CREATE DATABASE语句之前写入一个DROP DATABASE语句。这项选项通常与--all-databases或--databases选项一起使用，因为否则不会写入任何CREATE DATABASE语句，除非指定了其中一种选项。

--add-drop-table

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

--add-drop-trigger

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

--all-tablespaces, -Y

将所有用于一个NDB表的SQL语句添加到表格中。这些信息不在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 打印错误消息，但它也将 SQL 评论写入备份输出中，包含视图定义，并继续执行。

如果同时给出 --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语句。

--apply-slave-statements

这是--apply-replica-statements的过时别名。

--delete-source-logs

在复制源服务器上，删除二进制日志文件，通过向服务器发送PURGE BINARY LOGS语句来完成备份操作。这项选项需要RELOAD权限以及执行该语句所需的其他权限。此外，这个选项自动启用--source-data。

--delete-master-logs

这是--delete-source-logs的过时别名。

--dump-replica[=value]

这项选项与--source-data类似，但用于将复制服务器导出，以生成一个可以用来设置另一个服务器作为具有相同源的副本的备份文件。该选项会导致导出的输出包含一个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。这些是从副本开始复制的源服务器的坐标。

--dump-replica会使用源的坐标，而不是被导出的服务器的坐标，这与--source-data选项相同。此外，指定此选项将覆盖--source-data选项。

该选项值与--source-data相同。设置无值或1会导致在备份中写入一个CHANGE REPLICATION SOURCE TO语句。设置为2会将语句写入备份，但以SQL注释的形式包围它。这与--source-data在启用或禁用其他选项以及锁定处理方面具有相同效果。

--dump-replica会导致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 选项添加到复制源的主机名和 TCP/IP 端口号码，用于在使用 --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的输出。

--source-data[=value]

用于将复制源服务器的备份导出，以产生一个可以用来为另一个服务器设置其为源服务器副本的备份文件。选项会导致输出中包含一个CHANGE REPLICATION SOURCE TO语句，该语句指示了被导出的服务器的二进制日志坐标（文件名和位置），这些是副本从哪个源服务器开始复制的坐标，用户在将备份文件加载到副本中时会使用。

如果选项值为2，则CHANGE REPLICATION SOURCE TO语句作为SQL注释写入，因此在重新加载备份文件时没有效果；如果选项值为1，则该语句不作为注释写入，在重新加载备份文件时会生效；如果未指定选项值，默认值为1。

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

--source-数据 自动关闭--lock-tables。它们还打开--lock-all-tables，除非同时指定了--single-transaction，在这种情况下，会在导出开始时对全局读锁进行短暂的获取（请参阅--single-transaction 的描述）。无论哪种情况，任何日志操作都在导出时发生。

还可以通过使用--dump-replica 选项来设置副本，忽略--source-数据。

--set-gtid-purged=value

这个选项是为使用GTID-基于复制的服务器（gtid_模式=ON）设计的。它控制在导出输出中包含一个SET @@GLOBAL.gtid_purged 语句，该语句在将导出文件重新加载到服务器时更新gtid_executed 系统变量的值，来自源服务器的gtid_purged 系统变量。mysqldump 因此添加了源服务器上执行的交易的GTID，以便目标服务器记录这些交易为已应用，但它不在其二进制日志中。--set-gtid-purged 还控制在导出文件重新加载时包含一个SET @@SESSION.sql_log_bin=0 语句，该语句禁用二进制日志记录，防止在导出文件中执行的交易生成新的GTID并分配给它们，以便使用原始的GTID。

如果您没有设置 --set-gtid-purged 选项，mysqldump 将在备份输出中包含一个 SET @@GLOBAL.gtid_purged 语句，如果服务器启用了GTID，并且全局变量 gtid_executed 中的 GTID 集合不为空。此外，如果服务器启用了GTID，mysqldump 还将包含一个 SET @@SESSION.sql_log_bin=0 语句。

您可以通过指定一个特定的 GTID 集合来替换 gtid_purged 的值，或者在语句中添加一个加号 (+) 来将指定的 GTID 集合追加到已经由 gtid_purged 持有的 GTID 集合中。mysqldump 记录的 SET @@GLOBAL.gtid_purged 语句包括一个版本特定的注释，mysqldump 将在备份文件中添加来自 dump 文件的 GTID 集合到现有 gtid_purged 值中。

重要的是要注意，mysqldump 为 SET @@GLOBAL.gtid_purged 语句包含了服务器上所有在 gtid_executed 集合中的事务的 GTIDs，包括那些改变了被抑制的数据库部分或其他服务器上的数据库（即使这些数据库未包含在部分备份中）。这意味着当 dump 文件在目标服务器上重放时，gtid_purged 值可能会更新，但在目标服务器上没有任何关联数据的 GTIDs 会存在。如果您不在目标服务器上重放进一步的 dump 文件，这些额外的 GTIDs 不会导致任何问题，但它们会使在不同服务器上的 GTID 集合比较或一致性检查更加困难。如果您在目标服务器上重放包含相同 GTIDs 的另一个部分备份（例如，来自同一源服务器），第二个 dump 文件中的 SET @@GLOBAL.gtid_purged 语句将失败。在这种情况下，您可以手动删除该语句，或在重放 dump 文件之前从输出中排除它。

如果 SET @@GLOBAL.gtid_purged 语句在目标服务器上没有预期的效果，您可以排除该语句，或者将其包含但注释掉，以便不会自动执行。您还可以将该语句包含，但手动编辑 dump 文件以实现所需的结果。

--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 节，“Server SQL Modes”。

--complete-insert, -c

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

--create-options

在CREATE TABLE语句中包含所有 MySQL 特有的表选项。

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

这些选项与--tab选项一起使用，其含义与对应的FIELDS子句相同，用于LOAD DATA。请参阅第15.2.9节，“LOAD DATA Statement”。

--hex-blob

使用十六进制表示法导出二进制列（例如，'abc'变为0x616263）。影响的数据类型包括BINARY、VARBINARY、BLOB类型、BIT、所有空间数据类型以及其他非二进制数据类型，尤其是当与binary字符集一起使用时。

--hex-blob选项在使用--tab时被忽略。

--lines-terminated-by=...

这个选项与--tab一起使用，其含义与对应的LINES子句相同，用于LOAD DATA。请参阅第15.2.9节，“LOAD DATA Statement”。

--quote-names, -Q

在`字符中引用标识符（如数据库、表和列名）。如果启用了ANSI_QUOTES SQL 模式，标识符将以“字符引起来。这个选项默认是启用的，可以通过--skip-quote-names禁用，但应该在任何可能启用--quote-names的选项（如--compatible）之后给出。

--result-file=file_name, -r file_name

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

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

--show-create-skip-secondary-engine=value

从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', and Empty Values：对于名为column_name的列，在输出中，NULL值、空字符串和字符串值'NULL'之间有所区分。这个选项生成的输出如下所示。

使用mysql客户端时，带有--xml选项的输出遵循前述规则。 (参见第 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.4 之前，使用--routines和--events选项的mysqldump时，不需要使用--all-databases选项来包括存储的程序和事件：备份包含了 mysql 系统数据库，因此也包含了 mysql.proc 和 mysql.event 表，含有存储程序和事件定义。从 MySQL 8.4 开始，mysql.event 和 mysql.proc 表不再使用。对应对象的定义现在存储在数据字典表中，但那些表不会被导出。要将存储的程序和事件包括在使用--all-databases选项生成的备份中，必须显式地使用--routines和--events选项。

--databases, -B

导出多个数据库。通常，mysqldump 会将命令行中的第一个参数解释为数据库名称，后面的参数解释为表名称。使用这个选项，它会将所有的参数都解释为数据库名称。CREATE DATABASE 和 USE 语句会在每个新数据库之前包含在输出中。

这个选项可以用来导出 performance_schema 数据库，这通常不会被导出，即使使用了 --all-databases 选项。（也要使用 --skip-lock-tables 选项。）

--events, -E

将事件调度器的事件包含在输出中。这个选项需要对这些数据库有 EVENT 权限。

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

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

忽略指定的错误。这个选项的值是一个以逗号分隔的错误编号列表，用于指定在 mysqldump 执行过程中要忽略的错误。如果同时给出了 --force 选项来忽略所有错误，--force 将优先考虑。

--ignore-table=db_name.tbl_name

不要导出给定的表，这个表必须使用数据库和表的名称指定。要忽略多个表，可以重复使用这个选项。这也可以用来忽略视图。

--ignore-views=boolean

在备份文件中跳过视图表。

--init-command=str

连接到MySQL服务器后执行的单个SQL语句。定义重置了由其或init-command-add定义的现有语句。

--init-command-add=str

在连接或重新连接到MySQL服务器后执行的额外SQL语句。它可以单独使用，但没有效果，如果在--init-command之前使用，因为init-command重置要调用的命令列表。

--no-data, -d

不写入任何表行信息（即，不备份表内容）。这对于只想备份表的CREATE TABLE语句有用（例如，创建一个空白副本的表以加载备份文件）。

--routines, -R

在输出中包含存储的程序（过程和函数）以备份数据库。该选项需要全局SELECT权限。

使用--routines生成的输出包含CREATE PROCEDURE和CREATE FUNCTION语句，以创建程序。

--skip-generated-invisible-primary-key

这项选项会导致生成的不可见主键在输出中被排除。有关更多信息，请参阅第15.1.20.11节，“Generated Invisible Primary Keys”。

--tables

覆盖--databases或-B选项。mysqldump将所有跟随该选项的名称参数视为表名。

--triggers

在输出中包含每个导出的表的触发器。这项选项默认启用，可以通过--skip-triggers禁用。

为了能够导出一个表的触发器，您必须对该表拥有TRIGGER权限。

允许多个触发器。mysqldump以激活顺序导出触发器，因此当导出的文件重新加载时，触发器将以相同的激活顺序创建。但是，如果一个mysqldump导出的文件包含多个对同一事件和动作时间的触发器，对于尝试将该文件加载到不支持多个触发器的旧服务器时，将会出现错误。有关解决方案，请参阅Downgrade Notes；您可以将触发器转换为兼容旧服务器的方式。

--where='where_ condition', -w 'where_condition'

仅导出符合给定WHERE条件的行。条件周围的引号是必需的，如果它包含空格或其他特殊字符，这些字符对您的命令解释器来说具有特殊含义。

示例：

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

--column-statistics

将ANALYZE TABLE语句添加到输出中，以便在重新加载备份文件时生成表的直方图统计信息。由于对大型表进行直方图生成可能需要很长时间，这个选项默认是禁用的。

--disable-keys, -K

对于每个表，使用INSERT语句包围它，并在其前后添加/*!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 选项组控制的选项的讨论，请参阅mysqldump 选项组。

--quick, -q

这项选项对于备份大型表格非常有用。它强制mysqldump从服务器中按行逐一检索表格的数据，而不是一次性检索所有数据并在内存中缓冲后再写出。这样可以减少内存使用量，特别是当处理大型表格时。

--skip-opt

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

--add-locks

在每个表格的备份前后分别添加LOCK TABLES和UNLOCK TABLES语句。这可以在将备份文件重新加载到服务器时加快插入操作的速度。请参阅第10.2.5.1节，“优化INSERT语句”。

--flush-logs, -F

在开始备份之前清空MySQL服务器的日志文件。这项选项需要RELOAD权限。如果您同时使用了--all-databases选项，日志将在每个备份的数据库中清空。除非使用--lock-all-tables、--source-data或--single-transaction选项，在这种情况下，日志只会在所有表格被FLUSH TABLES WITH READ LOCK锁定时清空一次。如果您希望备份和日志清空同时发生，您应该将--flush-logs与--lock-all-tables、--source-data或--single-transaction一起使用。

--flush-privileges

在导出 mysql 数据库时，添加一个 FLUSH PRIVILEGES 语句到 dump 输出。这一选项应该在 dump 文件包含 mysql 数据库以及任何依赖于 mysql 数据库数据的其他数据库时使用，以确保正确恢复。

由于 dump 文件包含了一个 FLUSH PRIVILEGES 语句，重新加载文件需要具有执行该语句的权限。

--lock-all-tables, -x

锁定所有表，跨越所有数据库。这通过获取一个全局读锁来实现，以保持整个 dump 的持续时间。这个选项自动关闭 --single-transaction 和 --lock-tables。

--lock-tables, -l

对于每个被导出的数据库，锁定所有将要导出的表在导出之前。这些表以 READ LOCAL 锁定，以允许对 MyISAM 表进行并发插入。在事务性表（如 InnoDB）上，--single-transaction 比 --lock-tables 更好，因为它不需要锁定表。

由于 --lock-tables 对于每个数据库单独锁定表，这一选项不能保证 dump 文件中的表在不同数据库之间是逻辑上的一致状态。来自不同数据库的表可能会以完全不同的状态被导出。

一些选项，如 --opt，自动启用 --lock-tables。如果您想要覆盖这一点，请在选项列表的末尾使用 --skip-lock-tables。

--no-autocommit

将每个导出的表的 INSERT 语句包围在 SET autocommit = 0 和 COMMIT 语句中。

--order-by-primary

将每个表的行按照其主键或第一个唯一索引排序，这对于将 MyISAM 表导出到 InnoDB 表非常有用，但会显著延长导出操作的时间。

--shared-memory-base-name=name

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

这个选项只适用于服务器以支持共享内存连接的方式启动时启用了 shared_ memory 系统变量。

--single-transaction

这个选项将事务隔离模式设置为 REPEATABLE READ，并在导出数据之前向服务器发送一个 START TRANSACTION SQL 语句。它对于只包含事务表的数据库（如 InnoDB）非常有用，因为这样可以在不阻塞任何应用程序的情况下导出一致的数据库状态，直到 START TRANSACTION 被发出时。

在使用 --single-transaction 时，需要拥有 RELOAD 或 FLUSH_TABLES 的权限，如果同时启用了 gtid_ mode=ON 和 gtid_purged=ON|AUTO。

使用这个选项时，请注意，只有 InnoDB 表在一致的状态下被导出。例如，使用此选项导出的任何 MyISAM 或 MEMORY 表可能仍然会改变其状态。

在执行一个--single-transaction备份时，为了确保生成的备份文件（正确的表内容和二进制日志坐标）有效，不应该在同一时间内使用其他连接执行以下语句：ALTER TABLE，CREATE TABLE，DROP TABLE，RENAME TABLE，TRUNCATE TABLE。一致的读取不是隔离这些语句，因此在备份要包含的表上执行这些语句可能会导致SELECT语句（由mysqldump执行）无法正确获取表内容或失败。

--single-transaction选项和--lock-tables选项是互斥的，因为LOCK TABLES会隐式提交任何挂起的事务。

为了备份大型表，结合使用--quick选项。

--opt选项会启用多个设置，它们共同工作以执行快速备份操作。所有这些设置默认都是打开的，因为--opt默认是打开的。因此，你几乎从不需要指定--opt，而是可以通过在命令行上指定相关选项来关闭这些设置，然后再次打开某些设置。或者，你可以使用--skip-opt的形式来关闭所有设置。

--compact选项会关闭控制输出中是否包含可选语句和注释的几个设置。同样，你可以在这个选项后面跟随其他选项来重新启用某些设置，或者使用--skip-compact的形式来打开所有设置。

要选择 --opt 的效果，但排除某些特性，请使用 --skip 选项来为每个特性禁用。要禁用扩展插入和内存缓冲，使用 --opt --skip-extended-insert --skip-quick。（实际上，--skip-extended-insert --skip-quick 就足够了，因为 --opt 默认情况下是开启的。）

要取消所有特性的反向操作，除了禁用索引和表锁定外，请使用--skip-opt--disable-keys--lock-tables。