性能和可扩展性注意事项

调用语法

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

连接选项

选项文件选项

DDL 选项

调试选项

帮助选项

国际化选项

复制选项

格式选项

过滤选项

性能选项

交易选项

选项组

例子

限制

如果您的表主要是InnoDB 表，或者混合使用InnoDB 和MyISAM表，请考虑使用 MySQL Enterprise Backup 产品的 mysqlbackup命令。（作为企业订阅的一部分提供。）它InnoDB以最小的中断提供最佳的备份性能；它还可以备份来自 MyISAM其他存储引擎的表；并且它提供了许多方便的选项以适应不同的备份场景。请参阅 第 24.2 节，“MySQL 企业备份概述”。

如果您的表主要是MyISAM 表，请考虑改用mysqlhotcopy ，以获得比备份和恢复操作的mysqldump 更好的性能 。请参阅第 4.6.10 节，“mysqlhotcopy — 数据库备份程序”。

--bind-address=ip_address

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

--compress,-C

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

--default-auth=plugin

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

--enable-cleartext-plugin

启用mysql_clear_password明文身份验证插件。（请参阅 第 6.4.1.5 节，“客户端明文可插入身份验证”。）

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

--host=host_name, -h host_name

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

--login-path=name

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

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

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

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

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

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

--pipe,-W

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

--plugin-dir=dir_name

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

--port=port_num, -P port_num

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

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

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

--secure-auth

不要以旧的（pre-4.1）格式向服务器发送密码。这会阻止除使用较新密码格式的服务器之外的连接。默认情况下启用此选项；用于 --skip-secure-auth 禁用它。这个选项是在 MySQL 5.6.17 中添加的。

--socket=path, -S path

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

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

--ssl*

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

--user=user_name, -u user_name

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

--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.6 节，“mysql_config_editor — MySQL 配置实用程序”。

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

--print-defaults

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

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

--add-drop-database

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

--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 创建每个转储表的语句。

--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 completed on DATE

但是，日期会导致在不同时间获取的转储文件看起来不同，即使数据在其他方面是相同的。--dump-date并 --skip-dump-date 控制日期是否添加到评论中。默认为--dump-date （在注释中包含日期）。 --skip-dump-date 抑制日期打印。

--force,-f

即使在表转储过程中发生 SQL 错误，也要继续。

此选项的一个用途是使 mysqldump继续执行，即使遇到因定义引用已删除的表而变得无效的视图。如果没有 --force，mysqldump将退出并显示一条错误消息。使用--force， mysqldump会打印错误消息，但它还会将包含视图定义的 SQL 注释写入转储输出并继续执行。

--log-error=file_name

通过将它们附加到命名文件来记录警告和错误。默认是不做日志记录。

--skip-comments

请参阅 --comments选项的说明。

--verbose,-v

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

--help,-?

显示帮助信息并退出。

--version,-V

显示版本信息并退出。

--character-sets-dir=dir_name

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

--default-character-set=charset_name

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

--no-set-names,-N

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

--set-charset

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

--apply-slave-statements

对于使用该 --dump-slave选项生成的副本转储，在 STOP SLAVE语句前添加CHANGE MASTER TO 语句并START SLAVE 在输出末尾添加语句。

--delete-master-logs

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

--dump-slave[=value]

此选项类似于， --master-data只是它用于转储副本服务器以生成转储文件，该转储文件可用于将另一台服务器设置为与转储服务器具有相同源的副本。它会导致转储输出包含一条CHANGE MASTER TO语句，指示转储副本源的二进制日志坐标（文件名和位置）。这些是副本应从其开始复制的源服务器坐标。

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

选项值的处理方式与 for 相同 --master-data（设置无值或 1 会导致将CHANGE MASTER TO 语句写入转储，设置 2 会导致语句被写入但包含在 SQL 注释中）并且具有与--master-data启用相同的效果或禁用其他选项以及如何处理锁定。

此选项导致mysqldump在转储之前停止副本 SQL 线程并在转储之后再次重新启动它。

--dump-slave向服务器发送一条 SHOW SLAVE STATUS语句以获取信息，因此它需要足够的权限来执行该语句。

与 一起--dump-slave， 也可以使用 --apply-slave-statements 和 选项。--include-master-host-port

--include-master-host-port

对于CHANGE MASTER TO 使用选项生成的副本转储中的语句 --dump-slave，添加 副本源的主机名MASTER_HOST和 MASTER_PORTTCP/IP 端口号的选项。

--master-data[=value]

使用此选项转储源复制服务器以生成可用于将另一台服务器设置为源副本的转储文件。它会导致转储输出包含一条CHANGE MASTER TO 语句，指示转储服务器的二进制日志坐标（文件名和位置）。这些是源服务器坐标，在将转储文件加载到副本后，副本应从这些坐标开始复制。

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

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

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

也可以通过使用该选项转储源的现有副本来设置副本， 如果同时使用两个选项--dump-slave，该选项将覆盖--master-data并导致它被忽略。

--set-gtid-purged=value

SET @@GLOBAL.gtid_purged此选项通过指示是否向输出添加语句来 控制写入转储文件的全局事务 ID (GTID) 信息 。此选项还可能导致在重新加载转储文件时将语句写入禁用二进制日志记录的输出。

下表显示了允许的选项值。默认值为AUTO。

重新加载转储文件时，该--set-gtid-purged选项对二进制日志记录有以下影响：

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

gtid_mode=ON如果您的转储文件包含系统表， 则不建议在服务器 ( ) 上启用 GTID 时加载转储文件。mysqldump为使用非事务性 MyISAM 存储引擎的系统表发出 DML 指令，并且在启用 GTID 时不允许这种组合。另请注意，将转储文件从启用了 GTID 的服务器加载到另一台启用了 GTID 的服务器中，会导致生成不同的事务标识符。

--compact

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

--compatible=name

生成与其他数据库系统或较旧的 MySQL 服务器更兼容的输出。的值 name可以是 ansi, mysql323, mysql40, postgresql, oracle, mssql, db2, maxdb, no_key_options, no_table_options, 或 no_field_options。要使用多个值，请用逗号分隔它们。这些值与设置服务器 SQL 模式的相应选项具有相同的含义。请参阅第 5.1.10 节，“服务器 SQL 模式”。

此选项不保证与其他服务器的兼容性。它只启用那些当前可用于使转储输出更兼容的 SQL 模式值。例如，--compatible=oracle不将数据类型映射到 Oracle 类型或使用 Oracle 注释语法。

--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.6 节，“加载数据语句”。 FIELDSLOAD DATA

--hex-blob

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

--lines-terminated-by=...

该选项与选项一起使用，与 对应的 子句--tab意义相同。请参阅 第 13.2.6 节，“加载数据语句”。 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回车/换行符序列。

--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客户端 的输出--xml也遵循上述规则。（参见 第 4.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在命令行上使用选项和命名所有数据库相同。

--databases,-B

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

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

--events,-E

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

通过使用--events containsCREATE EVENT 语句创建事件而生成的输出。但是，这些语句不包括事件创建和修改时间戳等属性，因此在重新加载事件时，创建的时间戳等于重新加载时间。

如果您需要使用其原始时间戳属性创建事件，请不要使用--events. 相反， mysql.event使用对数据库具有适当权限的 MySQL 帐户直接转储并重新加载表 的内容mysql。

--ignore-table=db_name.tbl_name

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

--no-data,-d

Do not write any table row information (that is, do not dump table contents). This is useful if you want to dump only the CREATE TABLE statement for the table (for example, to create an empty copy of the table by loading the dump file).

--routines, -R

Include stored routines (procedures and functions) for the dumped databases in the output. This option requires the SELECT privilege for the mysql.proc table.

The output generated by using --routines contains CREATE PROCEDURE and CREATE FUNCTION statements to create the routines. However, these statements do not include attributes such as the routine creation and modification timestamps, so when the routines are reloaded, they are created with timestamps equal to the reload time.

If you require routines to be created with their original timestamp attributes, do not use --routines. Instead, dump and reload the contents of the mysql.proc table directly, using a MySQL account that has appropriate privileges for the mysql database.

--tables

Override the --databases or -B option. mysqldump regards all name arguments following the option as table names.

--triggers

Include triggers for each dumped table in the output. This option is enabled by default; disable it with --skip-triggers.

To be able to dump a table's triggers, you must have the TRIGGER privilege for the table.

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

Dump only rows selected by the given WHERE condition. Quotes around the condition are mandatory if it contains spaces or other characters that are special to your command interpreter.

Examples:

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

--delayed-insert

For those nontransactional tables that support the INSERT DELAYED syntax, use that statement rather than regular INSERT statements.

As of MySQL 5.6.6, DELAYED inserts are deprecated; expect this option to be removed in a future release.

--disable-keys, -K

For each table, surround the INSERT statements with /*!40000 ALTER TABLE tbl_name DISABLE KEYS */; and /*!40000 ALTER TABLE tbl_name ENABLE KEYS */; statements. This makes loading the dump file faster because the indexes are created after all rows are inserted. This option is effective only for nonunique indexes of MyISAM tables.

--extended-insert, -e

Write INSERT statements using multiple-row syntax that includes several VALUES lists. This results in a smaller dump file and speeds up inserts when the file is reloaded.

--insert-ignore

Write INSERT IGNORE statements rather than INSERT statements.

--max-allowed-packet=value

The maximum size of the buffer for client/server communication. The default is 24MB, the maximum is 1GB.

--net-buffer-length=value

The initial size of the buffer for client/server communication. When creating multiple-row INSERT statements (as with the --extended-insert or --opt option), mysqldump creates rows up to --net-buffer-length bytes long. If you increase this variable, ensure that the MySQL server net_buffer_length system variable has a value at least this large.

--opt

This option, enabled by default, is shorthand for the combination of --add-drop-table --add-locks --create-options --disable-keys --extended-insert --lock-tables --quick --set-charset. It gives a fast dump operation and produces a dump file that can be reloaded into a MySQL server quickly.

Because the --opt option is enabled by default, you only specify its converse, the --skip-opt to turn off several default settings. See the discussion of mysqldump option groups for information about selectively enabling or disabling a subset of the options affected by --opt.

--quick, -q

This option is useful for dumping large tables. It forces mysqldump to retrieve rows for a table from the server a row at a time rather than retrieving the entire row set and buffering it in memory before writing it out.

--skip-opt

See the description for the --opt option.

--add-locks

Surround each table dump with LOCK TABLES and UNLOCK TABLES statements. This results in faster inserts when the dump file is reloaded. See Section 8.2.4.1, “Optimizing INSERT Statements”.

--flush-logs, -F

Flush the MySQL server log files before starting the dump. This option requires the RELOAD privilege. If you use this option in combination with the --all-databases option, the logs are flushed for each database dumped. The exception is when using --lock-all-tables, --master-data, or --single-transaction: In this case, the logs are flushed only once, corresponding to the moment that all tables are locked by FLUSH TABLES WITH READ LOCK. If you want your dump and the log flush to happen at exactly the same moment, you should use --flush-logs together with --lock-all-tables, --master-data, or --single-transaction.

--flush-privileges

Add a FLUSH PRIVILEGES statement to the dump output after dumping the mysql database. This option should be used any time the dump contains the mysql database and any other database that depends on the data in the mysql database for proper restoration.

Because the dump file contains a FLUSH PRIVILEGES statement, reloading the file requires privileges sufficient to execute that statement.

--lock-all-tables, -x

Lock all tables across all databases. This is achieved by acquiring a global read lock for the duration of the whole dump. This option automatically turns off --single-transaction and --lock-tables.

--lock-tables, -l

For each dumped database, lock all tables to be dumped before dumping them. The tables are locked with READ LOCAL to permit concurrent inserts in the case of MyISAM tables. For transactional tables such as InnoDB, --single-transaction is a much better option than --lock-tables because it does not need to lock the tables at all.

Because --lock-tables locks tables for each database separately, this option does not guarantee that the tables in the dump file are logically consistent between databases. Tables in different databases may be dumped in completely different states.

Some options, such as --opt, automatically enable --lock-tables. If you want to override this, use --skip-lock-tables at the end of the option list.

--no-autocommit

Enclose the INSERT statements for each dumped table within SET autocommit = 0 and COMMIT statements.

--order-by-primary

Dump each table's rows sorted by its primary key, or by its first unique index, if such an index exists. This is useful when dumping a MyISAM table to be loaded into an InnoDB table, but makes the dump operation take considerably longer.

--shared-memory-base-name=name

On Windows, the shared-memory name to use for connections made using shared memory to a local server. The default value is MYSQL. The shared-memory name is case-sensitive.

This option applies only if the server was started with the shared_memory system variable enabled to support shared-memory connections.

--single-transaction

This option sets the transaction isolation mode to REPEATABLE READ and sends a START TRANSACTION SQL statement to the server before dumping data. It is useful only with transactional tables such as InnoDB, because then it dumps the consistent state of the database at the time when START TRANSACTION was issued without blocking any applications.

When using this option, you should keep in mind that only InnoDB tables are dumped in a consistent state. For example, any MyISAM or MEMORY tables dumped while using this option may still change state.

While a --single-transaction dump is in process, to ensure a valid dump file (correct table contents and binary log coordinates), no other connection should use the following statements: ALTER TABLE, CREATE TABLE, DROP TABLE, RENAME TABLE, TRUNCATE TABLE. A consistent read is not isolated from those statements, so use of them on a table to be dumped can cause the SELECT that is performed by mysqldump to retrieve the table contents to obtain incorrect contents or fail.

The --single-transaction option and the --lock-tables option are mutually exclusive because LOCK TABLES causes any pending transactions to be committed implicitly.

Using --single-transaction together with the --set-gtid-purged option is not recommended; doing so can lead to inconsistencies in the output of mysqldump.

To dump large tables, combine the --single-transaction option with the --quick option.

The --opt option turns on several settings that work together to perform a fast dump operation. All of these settings are on by default, because --opt is on by default. Thus you rarely if ever specify --opt. Instead, you can turn these settings off as a group by specifying --skip-opt, then optionally re-enable certain settings by specifying the associated options later on the command line.

The --compact option turns off several settings that control whether optional statements and comments appear in the output. Again, you can follow this option with other options that re-enable certain settings, or turn all the settings on by using the --skip-compact form.

To select the effect of --opt except for some features, use the --skip option for each feature. To disable extended inserts and memory buffering, use --opt --skip-extended-insert --skip-quick. (Actually, --skip-extended-insert --skip-quick is sufficient because --opt is on by default.)

To reverse --opt for all features except index disabling and table locking, use --skip-opt --disable-keys --lock-tables.