4.5.4 mysqldump

mysqldump客户端实用程序执行 逻辑备份，生成一组 SQL 语句，可以执行这些语句以重现原始数据库对象定义和表数据 。它转储一个或多个 MySQL 数据库以进行备份或传输到另一台 SQL 服务器。mysqldump 命令还可以生成 CSV、其他分隔文本或 XML 格式的输出 。

考虑使用MySQL Shell 转储实用程序，它提供多线程并行转储、文件压缩和进度信息显示，以及 Oracle Cloud Infrastructure 对象存储流和 MySQL 数据库服务兼容性检查和修改等云功能。使用MySQL Shell 负载转储实用程序可以轻松地将转储导入 MySQL 服务器实例或 MySQL 数据库服务数据库系统。可以在此处找到 MySQL Shell 的安装说明。

性能和可扩展性注意事项

调用语法

选项语法 - 按字母顺序排列的摘要

连接选项

选项文件选项

DDL 选项

调试选项

帮助选项

国际化选项

复制选项

格式选项

过滤选项

性能选项

交易选项

选项组

例子

限制

mysqldump至少需要 SELECT转储表、SHOW VIEW转储视图、TRIGGER转储触发器的权限，LOCK TABLES如果 --single-transaction不使用该选项，以及（从 MySQL 8.0.21 开始） PROCESS如果 --no-tablespaces不使用该选项。某些选项可能需要其他权限，如选项说明中所述。

要重新加载转储文件，您必须具有执行它包含的语句所需的权限，例如对 CREATE这些语句创建的对象的适当权限。

mysqldump输出可以包含 ALTER DATABASE更改数据库排序规则的语句。这些可以在转储存储的程序以保留其字符编码时使用。要重新加载包含此类语句的转储文件， ALTER需要受影响数据库的权限。

在 Windows 上使用 PowerShell 进行输出重定向的转储创建了一个具有 UTF-16 编码的文件：

但是，不允许将 UTF-16 作为连接字符集（请参阅 不允许的客户端字符集），因此无法正确加载转储文件。要解决此问题，请使用--result-file以 ASCII 格式创建输出的选项：

gtid_mode=ON如果您的转储文件包含系统表， 则不建议在服务器 ( ) 上启用 GTID 时加载转储文件。mysqldump为使用非事务性 MyISAM 存储引擎的系统表发出 DML 指令，并且在启用 GTID 时不允许这种组合。

mysqldump优点包括在恢复之前查看甚至编辑输出的便利性和灵活性。您可以为开发和 DBA 工作克隆数据库，或者对现有数据库进行轻微改动以进行测试。它不是用于备份大量数据的快速或可扩展的解决方案。对于大数据量，即使备份步骤花费合理的时间，恢复数据也可能非常慢，因为重放 SQL 语句涉及用于插入、索引创建等的磁盘 I/O。

对于大规模的备份和恢复， 物理备份更为合适，将数据文件以原始格式复制，以便快速恢复。

如果您的表主要是InnoDB 表，或者混合使用InnoDB和 MyISAM表，请考虑使用 mysqlbackup，它作为 MySQL Enterprise 的一部分提供。该工具以最小的中断提供高性能的 InnoDB备份；它还可以备份来自MyISAM其他存储引擎的表；它还提供了许多方便的选项以适应不同的备份方案。请参阅 第 30.2 节，“MySQL 企业备份概述”。

mysqldump可以逐行检索和转储表内容，或者它可以从表中检索整个内容并在转储之前将其缓冲在内存中。如果要转储大表，内存中的缓冲可能会成为一个问题。要逐行转储表，请使用 --quick选项（或 --opt，启用 --quick）。该 --opt选项（因此 --quick）默认启用，因此要启用内存缓冲，请使用 --skip-quick.

如果您正在使用最新版本的 mysqldump生成要重新加载到非常旧的 MySQL 服务器的转储，请使用该 --skip-opt选项而不是--optor --extended-insert选项。

有关mysqldump的其他信息，请参阅第 7.4 节，“使用 mysqldump 进行备份”。

通常有三种使用 mysqldump的方法——为了转储一组一个或多个表、一组一个或多个完整的数据库或整个 MySQL 服务器——如下所示：

要转储整个数据库，请不要在 之后命名任何表 db_name，或使用 --databases或 --all-databases选项。

要查看您的 mysqldump版本支持的选项列表，请发出命令 mysqldump --help。

mysqldump支持以下选项，可以在命令行或 选项文件的组中指定[mysqldump]。[client]有关 MySQL 程序使用的选项文件的信息，请参阅第 4.2.2.2 节，“使用选项文件”。

表 4.14 mysqldump 选项

mysqldump命令登录到 MySQL 服务器以提取信息 。以下选项指定如何连接到 MySQL 服务器，无论是在同一台机器上还是在远程系统上。

--bind-address=ip_address

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

--compress, -C

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

从 MySQL 8.0.18 开始，不推荐使用此选项。预计它会在 MySQL 的未来版本中被删除。请参阅 配置传统连接压缩。

--compression-algorithms=value

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

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

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

--default-auth=plugin

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

--enable-cleartext-plugin

启用mysql_clear_password明文身份验证插件。（请参阅 第 6.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插件的信息，请参阅 第 6.4.1.2 节，“缓存 SHA-2 可插入身份验证”。

--host=host_name, -h host_name

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

--login-path=name

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

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

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

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

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

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

--password1[=pass_val]

用于连接服务器的 MySQL 帐户的多因素身份验证因子 1 的密码。密码值是可选的。如果没有给出， mysqldump会提示输入一个。如果给定，则后面的密码和密码之间 不能有空格--password1=。如果未指定密码选项，则默认为不发送密码。

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

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

--password1and --password是同义词，就像 --skip-password1 and 一样--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-dir=dir_name

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

--port=port_num, -P port_num

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

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

用于连接到服务器的传输协议。当其他连接参数通常导致使用您想要的协议以外的协议时，它很有用。有关允许值的详细信息，请参阅 第 4.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插件的信息，请参阅 第 6.4.1.3 节，“SHA-256 可插入身份验证”和 第 6.4.1.2 节，“缓存 SHA-2 可插入身份验证”。

--socket=path, -S path

对于与 的连接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选项与其他 选项的不同之处在于它不用于建立加密连接，而是用于影响允许哪些加密操作。请参见第 6.8 节 “FIPS 支持”。 --ssl-xxx

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

OFF: 禁用 FIPS 模式。

ON：启用 FIPS 模式。

STRICT：启用“严格” FIPS 模式。

如果 OpenSSL FIPS 对象模块不可用，则唯一允许的 --ssl-fips-mode值为 OFF. 在这种情况下，设置 --ssl-fips-mode为 ON或STRICT会导致客户端在启动时发出警告并在非 FIPS 模式下运行。

--tls-ciphersuites=ciphersuite_list

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

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

--tls-version=protocol_list

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

--user=user_name, -u user_name

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

如果您将Rewriter插件与 MySQL 8.0.31 或更高版本一起使用，则应授予此用户 SKIP_QUERY_REWRITE权限。

--zstd-compression-level=level

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

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

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

这些选项用于控制要读取的选项文件。

--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. 例如， mysqldump通常读取 [client]和 [mysqldump]组。如果此选项作为 给出 --defaults-group-suffix=_other， mysqldump还会读取 [client_other]和 [mysqldump_other]组。

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

--no-defaults

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

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

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

--print-defaults

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

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

mysqldump的 使用场景包括建立一个全新的 MySQL 实例（包括数据库表），以及用现有数据库和表替换现有实例中的数据。以下选项允许您通过在转储文件中编码各种 DDL 语句来指定在恢复转储时要拆除和设置的内容。

--add-drop-database

DROP DATABASE 在每个陈述之前 写一个CREATE DATABASE陈述。此选项通常与 --all-databasesor --databases选项结合使用，因为CREATE DATABASE除非指定其中一个选项，否则不会写入任何语句。

在 MySQL 8.0 中，mysql 模式被认为是最终用户不能删除的系统模式。如果 --add-drop-database与 --all-databases或一起使用 --databaseswhere the list of schemas to be dumped includes mysql，则转储文件包含一条 DROP DATABASE `mysql`语句，该语句会在重新加载转储文件时导致错误。

相反，要使用 --add-drop-database， --databases请与要转储的模式列表一起使用，其中该列表不包括 mysql.

--add-drop-table

DROP TABLE在每个陈述之前 写一个CREATE TABLE 陈述。

--add-drop-trigger

DROP TRIGGER 在每个陈述之前 写一个CREATE TRIGGER陈述。

--all-tablespaces, -Y

将创建表使用的任何表空间所需的所有 SQL 语句添加到表转储NDB 。此信息未包含在mysqldump的输出中。此选项当前仅与 NDB Cluster 表相关。

--no-create-db, -n

如果给出了or 选项 ，则 抑制以CREATE DATABASE 其他方式包含在输出中的语句 。--databases--all-databases

--no-create-info, -t

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

此选项不排除从 mysqldump输出中创建日志文件组或表空间的语句；但是，您可以--no-tablespaces 为此目的使用该选项。

--no-tablespaces, -y

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

--replace

写REPLACE陈述而不是INSERT 陈述。

以下选项打印调试信息，在转储文件中对调试信息进行编码，或者让转储操作继续进行而不管潜在的问题。

--allow-keywords

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

--comments, -i

在转储文件中写入附加信息，例如程序版本、服务器版本和主机。默认情况下启用此选项。要禁止显示此附加信息，请使用--skip-comments.

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

写调试日志。典型的 debug_options字符串是 . 默认值为 。 d:t:o,file_named: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-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

详细模式。打印有关程序功能的更多信息。

以下选项显示有关 mysqldump命令本身的信息。

--help, -?

显示帮助信息并退出。

--version, -V

显示版本信息并退出。

以下选项更改 mysqldump命令如何表示具有本地语言设置的字符数据。

--character-sets-dir=dir_name

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

--default-character-set=charset_name

用作charset_name默认字符集。请参阅第 10.15 节，“字符集配置”。如果没有指定字符集， mysqldump使用 utf8mb4.

--no-set-names, -N

关闭 --set-charset设置，与指定 相同--skip-set-charset。

--set-charset

写入 输出。默认情况下启用此选项。要禁止该 语句，请使用 . SET NAMES default_character_setSET NAMES--skip-set-charset

mysqldump命令经常用于 在复制配置中的副本服务器上创建空实例或包含数据的实例。以下选项适用于在复制源服务器和副本上转储和恢复数据。

--apply-replica-statements

从 MySQL 8.0.26 开始，使用 --apply-replica-statements，在 MySQL 8.0.26 之前，使用 --apply-slave-statements. 这两个选项具有相同的效果。对于使用 --dump-replicaor --dump-slave选项生成的副本转储，该选项 在带有二进制日志坐标的语句之前 添加一个STOP REPLICA（或在 MySQL 8.0.22 之前）语句，并在输出末尾添加一个语句。 STOP SLAVESTART REPLICA

--apply-slave-statements

在 MySQL 8.0.26 之前使用此选项而不是 --apply-replica-statements. 这两个选项具有相同的效果。

--delete-source-logs

从 MySQL 8.0.26 开始，使用 --delete-source-logs，在 MySQL 8.0.26 之前，使用 --delete-master-logs. 这两个选项具有相同的效果。PURGE BINARY LOGS在复制源服务器上，选项通过在执行转储操作后向服务器发送语句来删除二进制日志 。这些选项需要RELOAD 特权以及足以执行该语句的特权。选项自动启用 --source-data或 --master-data。

--delete-master-logs

在 MySQL 8.0.26 之前使用此选项而不是 --delete-source-logs. 这两个选项具有相同的效果。

--dump-replica[=value]

从 MySQL 8.0.26 开始，使用--dump-replica，在 MySQL 8.0.26 之前，使用 --dump-slave. 这两个选项具有相同的效果。这些选项类似于 --source-data，不同之处在于它们用于转储副本服务器以生成转储文件，该转储文件可用于将另一台服务器设置为与转储服务器具有相同源的副本。这些选项导致转储输出包含一条 CHANGE REPLICATION SOURCE TO 语句（来自 MySQL 8.0.23）或一条语句CHANGE MASTER TO（在 MySQL 8.0.23 之前），指示转储副本源的二进制日志坐标（文件名和位置）。该 CHANGE REPLICATION SOURCE TO 语句读取和的 Relay_Master_Log_File值 Exec_Master_Log_Pos从 SHOW REPLICA STATUS输出并分别将它们用于 SOURCE_LOG_FILE和 SOURCE_LOG_POS。这些是副本开始复制的复制源服务器坐标。

已执行的中继日志中事务顺序的不一致可能导致使用错误的位置。有关更多信息，请参阅 第 17.5.1.34 节，“复制和事务不一致” 。

--dump-replica或 --dump-slave导致使用来自源的坐标而不是转储服务器的坐标，如 --source-data或 --master-data选项所做的那样。此外，指定此选项会导致 --source-data或 --master-data选项被覆盖（如果使用）并被有效地忽略。

--dump-replica如果要应用转储的服务器使用and 或 ， --dump-slave则不应使用 . gtid_mode=ONSOURCE_AUTO_POSITION=1MASTER_AUTO_POSITION=1

选项值的处理方式与 for 相同 --source-data。不设置值或设置 1 会导致将CHANGE REPLICATION SOURCE TO语句（来自 MySQL 8.0.23）或 CHANGE MASTER TO语句（MySQL 8.0.23 之前）写入转储。设置 2 导致语句被写入但包含在 SQL 注释中。--source-data它与启用或禁用其他选项以及如何处理锁定 具有相同的效果 。

--dump-replica并 --dump-slave导致 mysqldump在转储之前停止复制 SQL 线程并在转储之后再次重新启动它。

--dump-replica并向 服务器--dump-slave发送 SHOW REPLICA STATUS语句以获取信息，因此他们需要足够的权限来执行该语句。

--apply-replica-statements and --include-source-host-port 选项可以与 --dump-replicaand 结合使用--dump-slave。

--dump-slave[=value]

在 MySQL 8.0.26 之前使用此选项而不是 --dump-replica. 这两个选项具有相同的效果。

--include-source-host-port

从 MySQL 8.0.26 开始，使用 --include-source-host-port，在 MySQL 8.0.26 之前，使用 --include-master-host-port. 这两个选项具有相同的效果。选项添加 SOURCE_HOST| MASTER_HOST和 SOURCE_PORT| MASTER_PORT副本源的主机名和 TCP/IP 端口号的 选项，到使用或 选项 生成的副本转储中 的CHANGE REPLICATION SOURCE TO 语句（来自 MySQL 8.0.23）或语句（MySQL 8.0.23 之前）。CHANGE MASTER TO--dump-replica--dump-slave

--include-master-host-port

在 MySQL 8.0.26 之前使用此选项而不是 --include-source-host-port. 这两个选项具有相同的效果。

--source-data[=value]

从 MySQL 8.0.26 开始，使用--source-data，在 MySQL 8.0.26 之前，使用 --master-data. 这两个选项具有相同的效果。这些选项用于转储复制源服务器以生成可用于将另一台服务器设置为源副本的转储文件。这些选项导致转储输出包含一条 CHANGE REPLICATION SOURCE TO 语句（来自 MySQL 8.0.23）或一条语句（MySQL 8.0.23CHANGE MASTER TO之前），指示转储服务器的二进制日志坐标（文件名和位置）。这些是复制源服务器坐标，在将转储文件加载到副本后，副本应从该坐标开始复制。

如果选项值为 2，则CHANGE REPLICATION SOURCE TO| CHANGE MASTER TO语句以 SQL 注释的形式编写，因此仅供参考；重新加载转储文件时它不起作用。如果选项值为 1，则该语句不作为注释写入，并在重新加载转储文件时生效。如果未指定选项值，则默认值为 1。

--source-data并向 服务器--master-data发送 SHOW MASTER STATUS语句以获取信息，因此他们需要足够的权限来执行该语句。此选项还需要RELOAD 权限并且必须启用二进制日志。

--source-data并 --master-data自动关闭 --lock-tables。它们也会打开--lock-all-tables，除非 --single-transaction还指定，在这种情况下，全局读锁只会在转储开始时短时间内获取（请参阅说明 --single-transaction）。在所有情况下，对日志的任何操作都发生在转储的确切时刻。

也可以通过使用 --dump-replicaor --dump-slave选项转储源的现有副本来设置副本，该选项会覆盖--source-dataand --master-data并导致它们被忽略。

--master-data[=value]

在 MySQL 8.0.26 之前使用此选项而不是 --source-data. 这两个选项具有相同的效果。

--set-gtid-purged=value

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

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

您可以将 的值替换为 gtid_purged指定的 GTID 集，或者在语句中添加加号 (+) 以将指定的 GTID 集附加到已由 持有的 GTID 集gtid_purged。mysqldump记录的 SET @@GLOBAL.gtid_purged语句在特定于版本的注释中包含一个加号 ( )，这样 MySQL 8.0（及更高版本）将从转储文件中设置的 GTID 添加到现有 值中。 +gtid_purged

重要的是要注意， mysqldump为该SET @@GLOBAL.gtid_purged语句包含的值包括服务器上集合中所有事务的 GTID gtid_executed，甚至是那些更改了数据库的抑制部分的 GTID，或者服务器上未包含在部分转储。这可能意味着在 gtid_purged值已在重放转储文件的服务器上更新，存在与目标服务器上的任何数据无关的 GTID。如果您不在目标服务器上重播任何进一步的转储文件，则无关的 GTID 不会对服务器的未来操作造成任何问题，但它们会使比较或协调复制拓扑中不同服务器上的 GTID 集变得更加困难。如果您确实在目标服务器上重播包含相同 GTID 的进一步转储文件（例如，来自同一源服务器的另一个部分转储），则任何SET @@GLOBAL.gtid_purged第二个转储文件中的语句失败。在这种情况下，要么在重放转储文件之前手动删除该语句，要么输出不带该语句的转储文件。

将此选项与选项一起使用 --single-transaction 会导致输出不一致。如果 --set-gtid-purged=ON需要，它可以与 一起使用 --lock-all-tables，但这可以防止 在运行mysqldump时进行并行查询。

如果该SET @@GLOBAL.gtid_purged语句在您的目标服务器上没有预期的结果，您可以从输出中排除该语句，或者（从 MySQL 8.0.17 开始）包含它但将其注释掉，这样它就不会自动执行。您还可以包含该语句，但在转储文件中手动编辑它以获得所需的结果。

该 --set-gtid-purged选项的可能值如下：

默认值。如果在您正在备份的服务器上启用了 GTID 并且 gtid_executed不为空，SET @@GLOBAL.gtid_purged则添加到输出中，其中包含来自的 GTID 集 gtid_executed。如果启用了 GTID，SET @@SESSION.sql_log_bin=0则会添加到输出中。如果服务器上未启用 GTID，则不会将语句添加到输出中。

SET @@GLOBAL.gtid_purged未添加到输出中，并且SET @@SESSION.sql_log_bin=0未添加到输出中。对于未使用 GTID 的服务器，请使用此选项或AUTO. 如果您确定所需的 GTID 集已经存在于 gtid_purged目标服务器上并且不应更改，或者如果您计划手动识别和添加任何缺失的 GTID，则仅对正在使用 GTID 的服务器使用此选项。

如果在要备份的服务器上启用了 GTID， SET @@GLOBAL.gtid_purged则添加到输出（除非 gtid_executed为空），并SET @@SESSION.sql_log_bin=0添加到输出。如果设置此选项但服务器上未启用 GTID，则会发生错误。对于正在使用 GTID 的服务器，请使用此选项或 AUTO，除非您确定 gtid_executed目标服务器不需要 GTID。

从 MySQL 8.0.17 开始可用。如果在您正在备份的服务器上启用了 GTID，SET @@GLOBAL.gtid_purged则会添加到输出中（除非gtid_executed 为空），但会被注释掉。这意味着 的值 gtid_executed在输出中可用，但在重新加载转储文件时不会自动执行任何操作。 SET @@SESSION.sql_log_bin=0被添加到输出中，并且没有被注释掉。使用 COMMENTED，您可以控制gtid_executed 手动或通过自动化设置。例如，如果您正在将数据迁移到另一台已经具有不同活动数据库的服务器，您可能更愿意这样做。

以下选项指定如何表示整个转储文件或转储文件中的某些类型的数据。它们还控制是否将某些可选信息写入转储文件。

--compact

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

--compatible=name

生成与其他数据库系统或较旧的 MySQL 服务器更兼容的输出。该选项唯一允许的值为ansi，其含义与设置服务器 SQL 模式的相应选项相同。请参阅第 5.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=...

这些选项与 option 一起使用，与 的相应 子句--tab具有相同的含义。请参阅 第 13.2.7 节，“加载数据语句”。 FIELDSLOAD DATA

--hex-blob

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

--lines-terminated-by=...

该选项与选项一起使用，与 对应的 子句--tab意义相同。请参阅 第 13.2.7 节，“加载数据语句”。 LINESLOAD DATA

--quote-names, -Q

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

--result-file=file_name, -r file_name

直接输出到命名文件。即使在生成转储时发生错误，也会创建结果文件并覆盖其先前的内容。

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

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

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

这个选项是在 MySQL 8.0.18 中添加的。 在不支持该变量的 MySQL 8.0.18 之前的版本上 尝试 使用选项进行mysqldump操作 会导致错误。 --show-create-skip-secondary-engineshow_create_table_skip_secondary_engine

--tab=dir_name, -T dir_name

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

仅当mysqldump与mysqld服务器在同一台机器上运行 时才应使用此选项 。因为服务器*.txt在您指定的目录中创建文件，所以该目录必须是服务器可写的，并且您使用的 MySQL 帐户必须具有 FILE权限。因为 mysqldump在同一目录中创建 *.sql，所以它必须对您的系统登录帐户是可写的。

默认情况下，.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'在此选项生成的输出中相互区分，如下所示。

NULL

使用该选项运行时mysql客户端 的输出--xml也遵循上述规则。（参见 第 4.5.1.1 节，“mysql 客户端选项”。）

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

以下选项控制将哪种模式对象写入转储文件：按类别，例如触发器或事件；按名称，例如，选择要转储的数据库和表；甚至使用WHERE子句从表数据中过滤行。

--all-databases, -A

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

--add-drop-database 有关该选项与 不兼容的信息， 请参阅 说明--all-databases。

在 MySQL 8.0 之前， mysqldump和 mysqlpump--routines的和 --events选项 在使用选项时不需要包括存储的例程和事件 ：转储包括系统数据库，因此也 包括包含存储例程和事件定义的和 表。从 MySQL 8.0 开始，和 --all-databasesmysqlmysql.procmysql.eventmysql.eventmysql.proc不使用表格。相应对象的定义存储在数据字典表中，但不会转储这些表。要在使用 生成的转储中包含存储的例程和事件， 请明确--all-databases使用 --routines和 --events选项。

--databases, -B

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

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

--add-drop-database 有关该选项与 不兼容的信息， 请参阅 说明--databases。

--events, -E

在输出中包括转储数据库的事件计划程序事件。此选项需要 EVENT这些数据库的权限。

通过使用--events containsCREATE EVENT 语句创建事件而生成的输出。

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

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

--ignore-table=db_name.tbl_name

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

--no-data, -d

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

--routines, -R

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

通过使用--routines containsCREATE PROCEDURE和 CREATE FUNCTION语句创建例程生成的输出。

--skip-generated-invisible-primary-key

此选项从 MySQL 8.0.30 开始可用，并导致生成的不可见主键从输出中排除。有关详细信息，请参阅 第 13.1.20.11 节，“生成的不可见主键”。

--tables

覆盖--databases or-B选项。mysqldump 将选项后面的所有名称参数视为表名。

--triggers

在输出中包含每个转储表的触发器。默认情况下启用此选项；禁用它 --skip-triggers。

为了能够转储表的触发器，您必须拥有该 TRIGGER表的权限。

允许多个触发器。 mysqldump以激活顺序转储触发器，以便在重新加载转储文件时，以相同的激活顺序创建触发器。但是，如果 mysqldump转储文件包含具有相同触发事件和操作时间的表的多个触发器，则尝试将转储文件加载到不支持多个触发器的旧服务器时会发生错误。（有关解决方法，请参阅 降级说明；您可以转换触发器以与旧服务器兼容。）

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

仅转储给定 WHERE条件选择的行。如果条件包含空格或其他对您的命令解释器来说特殊的字符，则必须在条件周围加上引号。

例子：