Documentation Home
MySQL 8.0 参考手册  / 第 4 章 MySQL 程序  / 4.5 客户端程序  /  4.5.4 mysqldump——数据库备份程序

4.5.4 mysqldump——数据库备份程序

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

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

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

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

笔记

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

mysqldump [options] > dump.sql

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

mysqldump [options] --result-file=dump.sql

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

性能和可扩展性注意事项

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

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

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

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

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

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

调用语法

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

mysqldump [options] db_name [tbl_name ...]
mysqldump [options] --databases db_name ...
mysqldump [options] --all-databases

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

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

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

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

表 4.15 mysqldump 选项

选项名称 描述 介绍 弃用
--添加删除数据库 在每个 CREATE DATABASE 语句之前添加 DROP DATABASE 语句
--添加删除表 在每个 CREATE TABLE 语句之前添加 DROP TABLE 语句
--add-drop-trigger 在每个 CREATE TRIGGER 语句之前添加 DROP TRIGGER 语句
--添加锁 用 LOCK TABLES 和 UNLOCK TABLES 语句围绕每个表转储
--所有数据库 转储所有数据库中的所有表
--allow-关键字 允许创建作为关键字的列名
--apply-slave-statements 在 CHANGE MASTER 语句之前包括 STOP SLAVE 并在输出结束时包括 START SLAVE
--绑定地址 使用指定的网络接口连接到 MySQL 服务器
--字符集目录 安装字符集的目录
- 注释 向转储文件添加注释
- 袖珍的 产生更紧凑的输出
- 兼容的 生成与其他数据库系统或旧版 MySQL 服务器更兼容的输出
--complete-插入 使用包含列名的完整 INSERT 语句
- 压缩 压缩客户端和服务器之间发送的所有信息
--创建选项 在 CREATE TABLE 语句中包含所有 MySQL 特定的表选项
--数据库 将所有名称参数解释为数据库名称
--调试 写调试日志
--调试检查 程序退出时打印调试信息
- 调试信息 程序退出时打印调试信息、内存和 CPU 统计信息
--default-auth 要使用的身份验证插件
--默认字符集 指定默认字符集
--defaults-extra-file 除了通常的选项文件外,还读取命名的选项文件
--defaults-文件 只读命名选项文件
--defaults-group-suffix 选项组后缀值
--delete-master-logs 在复制源服务器上,执行转储操作后删除二进制日志
--disable-keys 对于每个表,用语句包围 INSERT 语句以禁用和启用键
--转储日期 如果给出了 --comments,则将转储日期包含为“转储完成于”注释
--转储奴隶 包括列出副本源的二进制日志坐标的 CHANGE MASTER 语句
--启用明文插件 启用明文身份验证插件 5.7.10
--事件 从转储数据库中转储事件
--扩展插入 使用多行 INSERT 语法
--fields-enclosed-by 此选项与 --tab 选项一起使用,与 LOAD DATA 的相应子句含义相同
--fields-escaped-by 此选项与 --tab 选项一起使用,与 LOAD DATA 的相应子句含义相同
--fields-optionally-enclosed-by 此选项与 --tab 选项一起使用,与 LOAD DATA 的相应子句含义相同
--fields-terminated-by 此选项与 --tab 选项一起使用,与 LOAD DATA 的相应子句含义相同
--刷新日志 在开始转储之前刷新 MySQL 服务器日志文件
--刷新权限 转储 mysql 数据库后发出 FLUSH PRIVILEGES 语句
- 力量 即使在表转储过程中出现 SQL 错误也继续
--get-server-public-key 从服务器请求 RSA 公钥 5.7.23
- 帮助 显示帮助信息并退出
--hex-blob 使用十六进制表示法转储二进制列
- 主持人 MySQL 服务器所在的主机
--忽略错误 忽略指定的错误
--忽略表 不要转储给定的表
--include-master-host-port 在使用 --dump-slave 生成​​的 CHANGE MASTER 语句中包含 MASTER_HOST/MASTER_PORT 选项
--插入忽略 编写 INSERT IGNORE 而不是 INSERT 语句
--lines-terminated-by 此选项与 --tab 选项一起使用,与 LOAD DATA 的相应子句含义相同
--lock-all-tables 锁定所有数据库中的所有表
--锁表 在转储之前锁定所有表
--日志错误 将警告和错误附加到命名文件
--登录路径 从 .mylogin.cnf 读取登录路径选项
- 主要的数据 将二进制日志文件名和位置写入输出
--最大允许数据包 发送到服务器或从服务器接收的最大数据包长度
--net-buffer-length TCP/IP 和套接字通信的缓冲区大小
--no-autocommit 在 SET autocommit = 0 和 COMMIT 语句中包含每个转储表的 INSERT 语句
--no-create-db 不要编写 CREATE DATABASE 语句
--no-create-info 不要编写重新创建每个转储表的 CREATE TABLE 语句
- 没有数据 不要转储表内容
--no-defaults 不读取选项文件
--no-set-names 与 --skip-set-charset 相同
--无表空间 不要在输出中写入任何 CREATE LOGFILE GROUP 或 CREATE TABLESPACE 语句
- 选择 --add-drop-table --add-locks --create-options --disable-keys --extended-insert --lock-tables --quick --set-charset 的简写
--order-by-primary 转储按主键或第一个唯一索引排序的每个表的行
- 密码 连接到服务器时使用的密码
- 管道 使用命名管道连接到服务器(仅限 Windows)
--插件目录 安装插件的目录
- 港口 用于连接的 TCP/IP 端口号
--print-defaults 打印默认选项
- 协议 使用的传输协议
- 快的 一次从服务器中检索一个表的行
--引用名称 反引号字符中的引号标识符
- 代替 编写 REPLACE 语句而不是 INSERT 语句
--结果文件 直接输出到给定文件
--例程 从转储的数据库中转储存储的例程(过程和函数)
--secure-auth 不要以旧的(pre-4.1)格式向服务器发送密码 是的
--server-public-key-path 包含 RSA 公钥的文件的路径名 5.7.23
--set-字符集 将 SET NAMES default_character_set 添加到输出
--set-gtid-清除 是否在输出中添加 SET @@GLOBAL.GTID_PURGED
--shared-memory-base-name 共享内存连接的共享内存名称(仅限 Windows)
--单笔交易 在从服务器转储数据之前发出 BEGIN SQL 语句
--skip-add-drop-table 不要在每个 CREATE TABLE 语句之前添加 DROP TABLE 语句
--skip-add-locks 不加锁
--跳过评论 不要在转储文件中添加注释
--skip-compact 不要产生更紧凑的输出
--skip-disable-keys 不要禁用键
--skip-extended-insert 关闭扩展插入
--skip-mysql-schema 不要删除 mysql 模式 5.7.36
--skip-opt 关闭 --opt 设置的选项
--快速跳过 不要一次从服务器一行检索表的行
--skip-quote-names 不要引用标识符
--skip-set-字符集 不要写 SET NAMES 语句
--skip-触发器 不要转储触发器
--skip-tz-utc 关闭 tz-utc
- 插座 要使用的 Unix 套接字文件或 Windows 命名管道
--ssl 启用连接加密
--ssl-ca 包含可信 SSL 证书颁发机构列表的文件
--ssl-capath 包含受信任的 SSL 证书颁发机构证书文件的目录
--ssl证书 包含 X.509 证书的文件
--ssl密码 连接加密的允许密码
--ssl-crl 包含证书吊销列表的文件
--ssl-crlpath 包含证书吊销列表文件的目录
--ssl-密钥 包含 X.509 密钥的文件
--ssl模式 连接到服务器的所需安全状态 5.7.11
--ssl-verify-server-cert 根据服务器证书公用名身份验证主机名
- 标签 生成制表符分隔的数据文件
--表格 覆盖 --databases 或 -B 选项
--tls-版本 加密连接允许的 TLS 协议 5.7.10
--触发器 每个转储表的转储触发器
--tz-utc 将 SET TIME_ZONE='+00:00' 添加到转储文件
- 用户 连接到服务器时使用的 MySQL 用户名
--冗长 详细模式
- 版本 显示版本信息并退出
- 在哪里 仅转储给定 WHERE 条件选择的行
--xml 生成 XML 输出

连接选项

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

选项文件选项

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

DDL 选项

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

调试选项

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

  • --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继续执行,即使遇到因定义引用已删除的表而变得无效的视图。如果没有 --forcemysqldump将退出并显示一条错误消息。使用--forcemysqldump会打印错误消息,但它还会将包含视图定义的 SQL 注释写入转储输出并继续执行。

    如果--ignore-error 还给出了忽略特定错误的选项, --force则优先。

  • --log-error=file_name

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

  • --skip-comments

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

  • --verbose,-v

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

帮助选项

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

  • --help,-?

    显示帮助信息并退出。

  • --version,-V

    显示版本信息并退出。

国际化选项

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

复制选项

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

  • --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语句,指示转储副本源的二进制日志坐标(文件名和位置)。该 语句从 输出CHANGE MASTER TO中读取和的值Relay_Master_Log_File 并将它们用于和 Exec_Master_Log_PosSHOW SLAVE STATUSMASTER_LOG_FILEMASTER_LOG_POS分别。这些是副本应从其开始复制的源服务器坐标。

    笔记

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

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

    警告

    gtid_mode=ON如果要应用转储的服务器使用和 ,则不应使用此选项 MASTER_AUTOPOSITION=1

    选项值的处理方式与 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_HOSTMASTER_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

    价值 意义
    OFF SET不向输出添加语句。
    ON 在输出中添加SET语句。如果服务器上未启用 GTID,则会发生错误。
    AUTO SET如果在服务器上启用了 GTID,则在输出中添加一条语句。

    来自使用基于 GTID 的复制的服务器的部分转储需要 --set-gtid-purged={ON|OFF} 指定选项。ON如果打算仅使用转储服务器中的部分数据来部署新的复制副本,则使用。OFF如果打算通过在拓扑中复制表来修复表,请使用 。如果OFF 打算在不相交的复制拓扑之间复制表并使它们保持不变,则使用。

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

    • --set-gtid-purged=OFF:SET @@SESSION.SQL_LOG_BIN=0;不会添加到输出中。

    • --set-gtid-purged=ON:SET @@SESSION.SQL_LOG_BIN=0;添加到输出。

    • --set-gtid-purged=AUTO:SET @@SESSION.SQL_LOG_BIN=0;如果在您正在备份的服务器上启用了 GTID,则添加到输出中(即,如果AUTO 评估为ON)。

    将此选项与选项一起使用 --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 包含其数据的文件。选项值是写入文件的目录。

    笔记

    仅当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_nameNULL值、空字符串和字符串值'NULL'在此选项生成的输出中相互区分,如下所示。

    价值: XML 表示:
    NULL未知值

    <field name="column_name" xsi:nil="true" />

    ''空字符串

    <field name="column_name"></field>

    'NULL'字符串值

    <field name="column_name">NULL</field>

    使用该选项运行时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>

过滤选项

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

  • --all-databases,-A

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

  • --databases,-B

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

    此选项可用于转储 INFORMATION_SCHEMAperformance_schema数据库,即使使用该 --all-databases选项通常也不会转储。(也使用该 --skip-lock-tables 选项。)

  • --events,-E

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

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

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

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

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

  • --ignore-table=db_name.tbl_name

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

  • --no-data,-d

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

  • --routines,-R

    在输出中包括转储数据库的存储例程(过程和函数)。此选项需要表的 SELECT权限 mysql.proc

    通过使用--routines containsCREATE PROCEDURECREATE FUNCTION语句创建例程生成的输出。但是,这些语句不包括例程创建和修改时间戳等属性,因此在重新加载例程时,创建它们的时间戳等于重新加载时间。

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

  • --tables

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

  • --triggers

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

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

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

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

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

    例子:

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

性能选项

以下选项与性能最相关,尤其是还原操作的性能。对于大数据集,恢复操作(处理INSERT 转储文件中的语句)是最耗时的部分。当急需快速恢复数据时,提前规划和测试该阶段的性能。对于以小时为单位的恢复时间,您可能更喜欢备用备份和恢复解决方案,例如MySQL Enterprise Backup for InnoDB-only 和 mixed-use 数据库。

性能也受 事务选项的影响,主要是针对转储操作。

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

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

  • --net-buffer-length=value

    客户端/服务器通信缓冲区的初始大小。当创建多行 INSERT语句时(与--extended-insertor --opt选项一样), mysqldump创建最多 --net-buffer-length字节长的行。如果增加此变量,请确保 MySQL 服务器net_buffer_length 系统变量的值至少有这么大。

  • --opt

    此选项默认启用,是 . 组合的简写 。它提供快速转储操作并生成可以快速重新加载到 MySQL 服务器的转储文件。 --add-drop-table --add-locks --create-options --disable-keys --extended-insert --lock-tables --quick --set-charset

    因为该--opt选项在默认情况下处于启用状态,所以您只需指定其相反的选项 --skip-opt即可关闭多个默认设置。有关有选择地启用或禁用受 影响的选项子集的信息, 请参阅mysqldump 选项组的讨论 --opt

  • --quick,-q

    此选项对于转储大型表很有用。它强制 mysqldump一次一行地从服务器检索表的行,而不是检索整个行集并在写出之前将其缓冲在内存中。

  • --skip-opt

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

交易选项

以下选项权衡了转储操作的性能,以及导出数据的可靠性和一致性。

  • --add-locks

    LOCK TABLES用and UNLOCK TABLES语句 包围每个表转储。重新加载转储文件时,这会导致更快的插入。请参阅 第 8.2.4.1 节,“优化 INSERT 语句”

  • --flush-logs,-F

    在开始转储之前刷新 MySQL 服务器日志文件。此选项需要 RELOAD特权。如果将此选项与 选项结合使用 ,则会为每个转储的数据库--all-databases刷新日志。使用 、 或 时例外 : 在 这种情况下,日志仅刷新一次,对应于所有表都被 锁定的时刻 。如果您希望转储和日志刷新在同一时刻发生,您应该 与、 或 一起使用 --lock-all-tables--master-data--single-transactionFLUSH TABLES WITH READ LOCK--flush-logs--lock-all-tables--master-data--single-transaction.

  • --flush-privileges

    FLUSH PRIVILEGES 转储数据库后向转储输出 添加一条语句mysqlmysql 只要转储包含数据库和任何其他依赖于数据库中的数据以mysql进行正确恢复 的数据库,就应该使用此选项。

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

    笔记

    对于从旧版本升级到 MySQL 5.7 或更高版本,请勿使用--flush-privileges. 有关这种情况下的升级说明,请参阅 第 2.11.3 节,“MySQL 5.7 中的更改”

  • --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 = 0COMMIT 语句中。

  • --order-by-primary

    转储按其主键或第一个唯一索引(如果存在这样的索引)排序的每个表的行。MyISAM这在转储要加载到表中的表时很有用InnoDB,但会使转储操作花费相当长的时间。

  • --shared-memory-base-name=name

    在 Windows 上,用于使用共享内存与本地服务器建立连接的共享内存名称。默认值为MYSQL。共享内存名称区分大小写。

    仅当服务器启动时 shared_memory启用了支持共享内存连接的系统变量时,此选项才适用。

  • --single-transaction

    此选项将事务隔离模式设置为 REPEATABLE READ并在转储数据之前向服务器发送START TRANSACTIONSQL 语句。它仅对诸如 之类的事务表有用InnoDB,因为它会在发布时转储数据库的一致状态, START TRANSACTION而不会阻止任何应用程序。

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

    --single-transaction转储过程中,为确保转储文件有效(正确的表内容和二进制日志坐标),其他任何连接都不应使用以下语句: ALTER TABLE, CREATE TABLE, DROP TABLE, RENAME TABLE, TRUNCATE TABLE。一致性读取并不与这些语句隔离,因此在要转储的表上使用它们可能会导致 mysqldumpSELECT执行的 检索表内容的操作获取不正确的内容或失败。

    --single-transactionoption 和 --lock-tablesoption 是互斥的,因为 会LOCK TABLES导致任何未决事务被隐式提交。

    不建议--single-transaction与该选项一起使用 ;--set-gtid-purged这样做会导致 mysqldump的输出不一致。

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

选项组

  • --opt选项会启用多个协同工作以执行快速转储操作的设置。默认情况下,所有这些设置都处于启用状态,因为默认情况下处于启用 --opt状态。因此,您很少指定--opt. 相反,您可以通过指定 将这些设置作为一个组关闭 --skip-opt,然后通过稍后在命令行上指定相关选项来选择性地重新启用某些设置。

  • --compact选项关闭了几个控制可选语句和注释是否出现在输出中的设置。同样,您可以在该选项之后使用其他选项重新启用某些设置,或者使用 --skip-compact表单打开所有设置。

当您有选择地启用或禁用组选项的效果时,顺序很重要,因为选项是从前到后处理的。例如, 不会有预期的效果;它 本身就是一样的。 --disable-keys --lock-tables --skip-opt--skip-opt

例子

要备份整个数据库:

mysqldump db_name > backup-file.sql

将转储文件加载回服务器:

mysql db_name < backup-file.sql

另一种重新加载转储文件的方法:

mysql -e "source /path-to-backup/backup-file.sql" db_name

mysqldump对于通过将数据从一个 MySQL 服务器复制到另一个来填充数据库也非常有用:

mysqldump --opt db_name | mysql --host=remote_host -C db_name

您可以使用一条命令转储多个数据库:

mysqldump --databases db_name1 [db_name2 ...] > my_databases.sql

要转储所有数据库,请使用以下 --all-databases选项:

mysqldump --all-databases > all_databases.sql

对于InnoDB表, mysqldump提供了一种进行在线备份的方法:

mysqldump --all-databases --master-data --single-transaction > all_databases.sql

FLUSH TABLES WITH READ LOCK此备份在转储开始时 获取所有表(使用 )的全局读锁 。一旦获得此锁,就会读取二进制日志坐标并释放锁。如果在 FLUSH发出语句时正在运行长更新语句,则 MySQL 服务器可能会停止运行,直到这些语句完成。在那之后,转储变得无锁并且不会干扰表上的读写。如果 MySQL 服务器收到的更新语句很短(就执行时间而言),初始锁定期应该不会很明显,即使有很多更新。

对于时间点恢复(也称为 前滚 ,当您需要恢复旧备份并重播自该备份以来发生的更改时),旋转二进制日志通常很有用(请参阅 第 5.4 节)。 4,“二进制日志”)或者至少知道转储对应的二进制日志坐标:

mysqldump --all-databases --master-data=2 > all_databases.sql

或者:

mysqldump --all-databases --flush-logs --master-data=2 > all_databases.sql

和选项可以同时使用,如果使用存储引擎存储表,这提供了一种方便的方法来使在线备份适合在时间点恢复之前 --master-data使用 。 --single-transactionInnoDB

有关制作备份的更多信息,请参阅 第 7.2 节,“数据库备份方法”第 7.3 节,“示例备份和恢复策略”

限制

默认情况下, mysqldump不会转储 INFORMATION_SCHEMAperformance_schemasys 模式。要转储其中任何一个,请在命令行上明确命名它们。您也可以使用 --databases选项命名它们。对于 INFORMATION_SCHEMAperformance_schema,也使用 --skip-lock-tables 选项。

mysqldump不会转储 NDB Cluster ndbinfo信息数据库。

mysqldump不转储 InnoDB CREATE TABLESPACE语句。

不建议从使用 mysqldump生成的转储恢复到启用了 GTID 的 MySQL 5.6.9 或更早版本的服务器。请参阅 第 16.1.3.6 节,“使用 GTID 进行复制的限制”

mysqldump包括为数据库转储 重新创建 general_log和 。不转储日志表内容。 slow_query_logmysql

如果由于权限不足而在备份视图时遇到问题,请参阅第 23.9 节“视图限制”以获取解决方法。