性能和可扩展性注意事项

调用语法

选项语法 - 按字母顺序排序

连接选项

选项文件选项

DDL 选项

调试选项

帮助选项

国际化选项

复制选项

格式选项

过滤选项

性能选项

事务选项

选项组

示例

限制

--bind-address=ip_address

在具有多个网络接口的计算机上，使用此选项可以选择用于连接到 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.3 节，“客户端明文可插拔身份验证”。）

--get-server-public-key

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

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

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

--host=host_name, -h host_name

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

--login-path=name

从 .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[=password], -p[password]

用于连接到服务器的 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 系统变量以支持命名管道连接时，此选项才适用。此外，进行连接的用户必须是 named_pipe_full_access_group 系统变量指定的 Windows 组的成员。

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

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

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

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

--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

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 插件的信息，请参阅 第 8.4.1.2 节，“SHA-256 可插拔身份验证” 和 第 8.4.1.1 节，“缓存 SHA-2 可插拔身份验证”。

--socket=路径, -S 路径

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

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

--ssl*

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

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

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

允许使用以下 --ssl-fips-mode 值

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

--tls-ciphersuites=密码套件列表

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

--tls-sni-servername=服务器名称

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

服务器名称指示 (SNI) 是 TLS 协议的扩展（必须使用 TLS 扩展编译 OpenSSL 才能使此选项起作用）。MySQL 对 SNI 的实现仅代表客户端。

--tls-version=协议列表

加密连接允许的 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=文件名

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

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

--defaults-file=文件名

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

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

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

--defaults-group-suffix=字符串

不仅读取通常的选项组，还读取具有通常名称和后缀 字符串 的组。例如，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

如果给定了 --databases 或 --all-databases 选项，则禁止输出中包含的 CREATE DATABASE 语句。

--no-create-info, -t

不要编写创建每个转储表的 CREATE TABLE 语句。

--no-tablespaces, -y

此选项禁止 mysqldump 的输出中的所有 CREATE LOGFILE GROUP 和 CREATE TABLESPACE 语句。

--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。

仅当使用 WITH_DEBUG 构建 MySQL 时，此选项才可用。 Oracle 提供的 MySQL 发行版二进制文件未使用此选项构建。

--debug-check

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

仅当使用 WITH_DEBUG 构建 MySQL 时，此选项才可用。 Oracle 提供的 MySQL 发行版二进制文件未使用此选项构建。

--debug-info

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

仅当使用 WITH_DEBUG 构建 MySQL 时，此选项才可用。 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[=值]

这是--dump-replica的已弃用别名。

--include-source-host-port

将副本源的主机名和 TCP/IP 端口号的SOURCE_HOST和SOURCE_PORT选项添加到使用--dump-replica选项生成的副本转储中的CHANGE REPLICATION SOURCE TO语句。

--include-master-host-port

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

--master-data[=值]

这是--source-data的已弃用别名。

--output-as-version=值

确定用于与副本和事件相关的语句的术语级别，从而可以创建与不接受较新术语的旧版本 MySQL 兼容的转储文件。此选项可以采用以下任何值，其效果如下所述

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

--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，但服务器上的任何二进制日志文件中都不存在这些 GTID。mysqldump因此添加了在源服务器上执行的事务的 GTID，以便目标服务器将这些事务记录为已应用，尽管它的二进制日志中没有这些事务。--set-gtid-purged还控制包含SET @@SESSION.sql_log_bin=0语句，该语句在重新加载转储文件时禁用二进制日志记录。此语句可防止在执行转储文件中的事务时生成新 GTID 并将其分配给这些事务，以便使用事务的原始 GTID。

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

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

值得注意的是，mysqldump 为 SET @@GLOBAL.gtid_purged 语句包含的值包括服务器上 gtid_executed 集中所有事务的 GTID，即使是那些更改了数据库中被抑制部分或服务器上未包含在部分转储中的其他数据库的事务。 这意味着在已更新转储文件所在服务器上的 gtid_purged 值后，存在的 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=名称

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

--complete-insert、-c

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

--create-options

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

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

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

--hex-blob

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

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

--lines-terminated-by=...

此选项与 --tab 选项一起使用，并且与 LOAD DATA 的相应 LINES 子句具有相同的含义。 请参阅 第 15.2.9 节“LOAD DATA 语句”。

--quote-names、-Q

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

--result-file=文件名、-r 文件名

将输出直接定向到指定的文件。 将创建结果文件并覆盖其先前的内容，即使在生成转储时发生错误也是如此。

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

--show-create-skip-secondary-engine=值

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

--tab=目录名、-T 目录名

生成制表符分隔的文本格式数据文件。 对于每个转储的表，mysqldump 会创建一个 表名.sql 文件，其中包含创建该表的 CREATE TABLE 语句，并且服务器会写入一个 表名.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' 在此选项生成的输出中彼此区分如下。

使用 --xml 选项运行时，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 9.0 之前，mysqldump 的 --routines 和 --events 选项在使用 --all-databases 选项时不需要包含存储例程和事件：转储包含 mysql 系统数据库，因此还包含存储例程和事件定义的 mysql.proc 和 mysql.event 表。从 MySQL 9.0 开始，不再使用 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

添加一个额外的 SQL 语句，以便在连接或重新连接到 MySQL 服务器后执行。它可以在没有 --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 节“生成的不可见主键”。

--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

对于每个表，使用 /*!40000 ALTER TABLE tbl_name DISABLE KEYS */; 和 /*!40000 ALTER TABLE tbl_name ENABLE KEYS */; 语句将 INSERT 语句括起来。这会加快转储文件的加载速度，因为索引是在插入所有行之后创建的。此选项仅对 MyISAM 表的非唯一索引有效。

--extended-insert, -e

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

--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 即可关闭多个默认设置。有关选择性启用或禁用 --opt 影响的选项子集的信息，请参阅 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 语句添加到转储输出中。每当转储包含 mysql 数据库和任何其他依赖于 mysql 数据库中的数据才能正确还原的数据库时，都应使用此选项。

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

--lock-all-tables, -x

锁定所有数据库中的所有表。这是通过在整个转储期间获取全局读锁来实现的。此选项会自动关闭 --single-transaction 和 --lock-tables。

--lock-tables, -l

对于每个转储的数据库，在转储之前锁定所有要转储的表。使用 READ LOCAL 锁定表，以便在 MyISAM 表的情况下允许并发插入。对于 InnoDB 等事务性表，--single-transaction 比 --lock-tables 好得多，因为它根本不需要锁定表。

因为 --lock-tables 会分别锁定每个数据库的表，所以此选项不能保证转储文件中的表在数据库之间逻辑上一致。不同数据库中的表可能会以完全不同的状态进行转储。

某些选项（如 --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 时转储数据库的一致状态，而不会阻塞任何应用程序。

如果同时使用 gtid_mode=ON 和 gtid_purged=ON|AUTO，则使用 --single-transaction 需要 RELOAD 或 FLUSH_TABLES 权限。

使用此选项时，您应该记住，只有 InnoDB 表会以一致的状态进行转储。例如，使用此选项转储的任何 MyISAM 或 MEMORY 表仍然可能会更改状态。

在 --single-transaction 转储过程中，为确保转储文件有效（表内容和二进制日志坐标正确），其他连接不应使用以下语句：ALTER TABLE、CREATE TABLE、DROP TABLE、RENAME TABLE、TRUNCATE TABLE。一致性读取不与这些语句隔离，因此对要转储的表使用这些语句可能会导致 mysqldump 执行的 SELECT 以检索表内容，从而获得错误的内容或失败。

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

要转储大型表，请将 --single-transaction 选项与 --quick 选项结合使用。

--opt 选项启用多个设置，这些设置协同工作以执行快速转储操作。默认情况下，所有这些设置都处于启用状态，因为默认情况下 --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。