MySQL Backup mysqldump 常用选项与主要用法

正文

the mysqldump client utility performs logical backups, producing a set of sql statements that can be executed to reproduce the original database object definitions and table data. it dumps one or more mysql databases for backup or transfer to another sql server. the mysqldump command can also generate output in csv, other delimited text, or xml format.

mysqldump是mysql官方自带的逻辑备份工具。备份结果是生成一系列的文本sql语句，可以很方便地用作数据备份，也可以用于数据迁移。平时逻辑备份时用mysqldump是最多的，但也没好好进行学习总结，本文主要就mysqldump常用选项和主要用法作个学习总结。

关于mysqldump更详细的信息可以参考官方文档：

本文使用的mysql版本为官方社区版 5.7.24。

(root@localhost) [test] > select version();
+------------+
| version()  |
+------------+
| 5.7.24-log |
+------------+
1 row in set (0.00 sec)

主要说明

# mysqldump --help
mysqldump  ver 10.13 distrib 5.7.24, for linux-glibc2.12 (x86_64)
copyright (c) 2000, 2018, oracle and/or its affiliates. all rights reserved.

oracle is a registered trademark of oracle corporation and/or its
affiliates. other names may be trademarks of their respective
owners.

dumping structure and contents of mysql databases and tables.
usage: mysqldump [options] database [tables]
or     mysqldump [options] --databases [options] db1 [db2 db3...]
or     mysqldump [options] --all-databases [options]

default options are read from the following files in the given order:
/etc/my.cnf /etc/mysql/my.cnf /usr/local/mysql/etc/my.cnf ~/.my.cnf

常用选项

连接选项(connection options)

• --bind-address=ip_address
  当mysql服务器有多个网络接口，指定mysqldump连接mysql服务器使用的网络接口。

• --compress, -c
  当服务端和客户端都支持压缩时，指定压缩传输的数据。

• --host=host_name, -h host_name
  指定需要dump数据的mysql服务器，默认是localhost。

• --port=port_num, -p port_num
  指定连接mysql服务器的端口。

• --user=user_name, -u user_name
  指定连接mysql服务器的用户名。

• --password[=password], -p[password]
  指定连接mysql服务器的用户密码。
  • 如果命令行使用 -p 选项指定密码，则选项与密码串之间不允许有空格，不过命令行中密码串明文是不安全的；
  • 如果命令行选项后面没有指定密码串，则mysqldump在连接前会进行提示输入。

• --pipe, -w
  在windows环境下，指定命名管道连接mysql服务器。此选项仅当服务器支持命名管道连接才生效。

• --socket=path, -s path
  在unix系统下指定本地连接使用socket文件，类似于windows环境下的命名管道。

参数文件选项(option-file options)

• --defaults-file=file_name
  指定读取的参数文件。如果这个文件不存存或是无法访问则会报错。

• --no-defaults
  不读取任何的参数文件。

• --print-defaults
  显示mysqldump读取的参数文件。

ddl选项(ddl options)

• --add-drop-database
  在每行create database语句前添加drop database语句。这个选项通常与 --all-databases或 --databases选项一起使用，因为如果没有指定这两个选项之一也不会有create database语句。

• --add-drop-table
  在dump输出中每行create table语句前添加drop table语句。

• --add-drop-trigger
  在dump输出中每行create trigger语句前添加drop trigger语句。

• --no-create-db, -n
  在dump输出中禁止生成create database语句，即使指定了 --all-databases或 --databases选项。

• --no-create-info, -t
  每张表dump的时候都不生成create table语句。

• --no-tablespaces, -y
  在dump输出中都禁止生成create logfile group和create tablespace语句。

• --replace
  在dump输出中使用replace语句代替insert语句。

调试选项(debug options)

• --comments, -i
  在dump输出中增加额外的信息，如mysqldump版本，mysql版本，mysql主机名等。默认是开启状态，如果要禁止，则可以指定选项 --skip-comments。

• --debug-info
  在mysqldump退出时打印调试信息以及cpu和内存的使用统计信息。

• --dump-date
  当启用选项 --comments时，在dump输出中的末尾添加结束时间。可以使用选项 --skip-dump-date禁止添加。

• --force, -f
  忽略dump表过程当中的sql错误。这个选项适用于当指定dump视图，视图所对应的表被清除而变成invaild状态时，mysqldump会记录视图定义以及错误信息并继续执行dump操作。如果未指定该选项，则mysqldump报错并退出。

• --log-error=file_name
  指定警告和错误信息记录的文件，默认不记录。

• --verbose, -v
  详细模式，打印mysqldump执行更详细的信息。

国际化选项(internationalization options)

• --character-sets-dir=dir_name
  指定字符集安装所在的目录。

• --default-character-set=charset_name
  指定默认的字符集，如果没指定，默认为utf8。

• --set-charset
  添加set names default_character_set语句到dump文件输出中。默认是开启的，可以使用选项 --skip-set-charset禁止。

• --no-set-names, -n
  关闭选项 --set-charset。

复制选项(replication options)

• --apply-slave-statements
  指定选项 --dump-slave的从库dump过程中，在change master to语句之前添加stop slave语句，在dump结束之后再添加start slave语句。

• --delete-master-logs
  在主服务器上，在完成dump之后发送语句purge binary logs到主服务器执行。此选项会自动开启 --master-data。

• --dump-slave[=value]
  这个选项类似于 --master-data，只不过作用于mysqldump在从库生成的dump文件，即mysqldump在从库进行备份。这个选项的作用是为了产生一个与备份从库相同主库的从库，记录新的从库需要从主库开启复制读取的binlog文件和binlog位置，生成新的change master to语句，binlog文件和binlog位置分别读取来自于show slave status状态语句当中的relay_master_log_file和 exec_master_log_pos值。该选项的取值与 --master-data一致。
  该选项会使mysqldump在开始dump之前停止sql thread，而在dump结束之后再重新开启。

• --include-master-host-port
  指定选项 --dump-slave的从库dump过程中，生成change master to语句添加master_host和master_port信息以便可以通过新dump文件创建新的从库开启主从复制。

• --master-data[=value]
  在主服务器完成mysqldump指定该选项导出备份文件可以用来搭建从库。在dump文件中包含了change master to语句，该语句表示新搭建的从库需要从主库哪个binlog文件和位置开始进行同步。
  该选项需要reload权限和mysql中开启binlog，会关闭选项 --lock-tables并开启选项 --lock-all-tables，除非指定了选项 --single-transaction。
  value取值如下：
  • 2：则change master to语句是以注释的形式存在dump文件中，在dump文件导入的过程当中并不会生效；
  • 1：则change master to语句是以非注释的形式存在dump文件中，在dump文件导入的过程中会生效；
  • 未指定：则默认值为1。
• --set-gtid-purged=value
  指定是否在dump文件中写入set @@global.gtid_purged语句，同时会导致dump文件在被重载的时候不会记录binlog。
  value取值如下：
  • off：不添加set @@global.gtid_purged语句，同时不添加set @@session.sql_log_bin=0语句；
  • on：添加set @@global.gtid_purged语句，如果没开启gtid则报错，同时添加set @@session.sql_log_bin=0语句；
  • auto：如果开启gitd则添加set @@global.gtid_purged语句，同时添加set @@session.sql_log_bin=0语句，默认选项。

格式化选项(format options)

• --compact
  更加紧凑的输出dump文件。该选项同时会开启 --skip-add-drop-table，--skip-add-locks，--skip-comments，--skip-disable-keys和 --skip-set-charset选项。

• --complete-insert, -c
  指定dump文件中的insert语句为包含所有字段名称的完整语句。

• --create-options
  指定dump文件中create table语句包含所有mysql表选项。

• --hex-blob
  转储二进制列为十六进制格式。涉及的类型有binary、varbinary、blob和bit。

• --quote-names, -q
  指定dump文件中数据库、表和字段的引用标识符为反引号 `，默认开启，通过选项 --skip-quote-names来禁用。如果sql_mode当中有ansi_quotes，则标识符为双引号 "。

• --result-file=file_name, -r file_name
  指定dump输出到给定文件。

• --tz-utc
  指定dump文件中表timestamp字段导出格式以适应不同时区服务器导入时值的准确性。默认是开启，使用选项 --skip-tz-utc禁用。

过滤选项(filtering options)

• --all-databases, -a
  指定dump出所有库当中的所有表。

• --databases, -b
  指定dump一个或多个数据库。该选项会在dump每个数据库之前添加create database和use语句，如果没有指定该选项，则mysqldump将第一个参数当成是数据库，第二个参数当成是表。通常用来备份information_schema和performance_schema库，默认情况下是不导出这两个库的。

• --no-data, -d
  指定只dump表结构，而不dump表数据。

• --tables
  指定dump一张或多张表。会覆盖选项 --databases, -b，把该选项之后所有参数当成是表。

• --ignore-table=db_name.tbl_name
  指定忽略dump某张表。格式必须是db.table，如果有多张表需要多次指定该选项，也适用于视图。

• --where='where_condition', -w 'where_condition'
  指定where条件dump数据。

• --events, -e
  指定dump数据库中的计划事件。需要对库有event权限。

• --routines, -r
  指定dump数据库中的函数和存储过程。

• --triggers
  指定dump表中的触发器。需要对表有trigger权限。

性能选项(performance options)

• --disable-keys, -k
  指定dump文件里insert表时添加/*!40000 alter table tbl_name disable keys */语句，完成后再添加/*!40000 alter table tbl_name enable keys */语句，这样可以加快表数据导入速度，但只对有非唯一索引的myisam表有效果。

• --extended-insert, -e
  指定dump文件当中的insert语句为多行格式，降低dump文件大小。

• --insert-ignore
  使用insert ignore代替insert语句。

• --opt
  默认开启，包含了一系列选项的集合，主要有 --add-drop-table --add-locks --create-options --disable-keys --extended-insert --lock-tables --quick --set-charset，如果要禁用，可以使用选项 --skip-opt。

• --quick, -q
  对于大表的dump很有帮助。默认开启。该选项使mysqldump直接从表中获取数据输出而不经过mysql的缓存。

事务选项(transactional options)

• --add-locks
  指定dump文件中每张表insert语句之前添加lock tables语句，insert语句之后添加unlock tables语句。这样可以提高导入效率。

• --flush-logs, -f
  在dump开始之前切换日志。该选项需要reload权限。如果与选项 --all-databases联合使用的话会导致每dump一个库之前都要进行日志切换。如果有使用选项 --lock-all-tables、--master-data或者 --single-transaction，则在dump过程当中只进行一次日志切换。如果希望dump与日志的切换同时发生，则使用 --flush-logs与选项 --lock-all-tables、--master-data或者 --single-transaction一同使用。

• --flush-privileges
  在dump完mysql数据库之后添加flush privileges语句。

• --lock-all-tables, -x
  在dump过程中锁住所有数据库中所有表。该选项会自动关闭 --single-transaction和 --lock-tables选项。

• --lock-tables, -l
  在dump每个库时锁定库中的表。这个选项只能保证库中表的状态一致，因为针对每个库进行加锁，所以无法保证所有库都是一致状态。

• --no-autocommit
  指定dump文件中每条insert语句包含在set autocommit = 0和commit语句之间。

• --order-by-primary
  在dump每张表的时候以表的主键或第一个唯一索引为序。对于导出是myisam表而导入是innodb表很有用。

• --single-transaction
  在dump开始之前将会话事务隔离级别设置成repeatable read并执行语句start transaction，只适用于事务引擎的表如innodb。当指定该选项进行dump的过程中，应该避免其它会话连接执行如下语句：alter table，create table，drop table，rename table，truncate table，因为一致性读并不能隔离以上语句，所以当mysqldump执行select语句进行dump表数据时，其它会话执行以上语句容易产生数据不一致或者报错。
  该选项与 --lock-tables是互斥的，因为lock tables语句会导致在执行的事务隐式提交。

用法示例

• 备份所有库

# mysqldump -uadmin -p -h192.168.58.3 -p3306 -e -r --triggers --single-transaction --master-data=2 -a > test_all.sql

• 备份一个或多个库

# mysqldump -uadmin -p -h192.168.58.3 -p3306 -e -r --triggers --single-transaction --master-data=2 -b test1 test2 > test1_test2.sql

• 备份一张表或多张表

# mysqldump -uadmin -p -h192.168.58.3 -p3306 -e -r --triggers --single-transaction --master-data=2 test1 t1 > test1_t1.sql
或
# mysqldump -uadmin -p -h192.168.58.3 -p3306 -e -r --triggers --single-transaction --master-data=2 test1 --tables t1 > test1_t1.sql

# mysqldump -uadmin -p -h192.168.58.3 -p3306 -e -r --triggers --single-transaction --master-data=2 test1 t1 t2 > test1_t1_t2.sql
或
# mysqldump -uadmin -p -h192.168.58.3 -p3306 -e -r --triggers --single-transaction --master-data=2 test1 --tables t1 t2 > test1_t1_t2.sql 

• 备份库结构(同时会包含表结构)

# mysqldump -uadmin -p -h192.168.58.3 -p3306 -e -r --triggers --single-transaction --master-data=2 --no-data -b test1 test2 > test1_test2.sql

• 只备份表结构

# mysqldump -uadmin -p -h192.168.58.3 -p3306 -e -r --triggers --single-transaction --master-data=2 --no-data test1 --tables t1 t2 > test1_t1_t2.sql

• 只备份表数据(不包含建表语句)

# mysqldump -uadmin -p -h192.168.58.3 -p3306 -e -r --triggers --single-transaction --master-data=2 --no-create-info test1 --tables t1 t2 > test1_t1_t2.sql

• 忽略一张或多张表备份

# mysqldump -uadmin -p -h192.168.58.3 -p3306 -e -r --triggers --single-transaction --master-data=2 test1 --ignore-table=test1.t1 --ignore-table=test1.t2 > test1_ig_t1_t2.sql 

• 输出文件通过管道传到gzip命令进行压缩

# mysqldump -uadmin -p -h192.168.58.3 -p3306 -e -r --triggers --single-transaction --master-data=2 -a | gzip > test_all.sql.gz

• 指定where条件备份表数据

# mysqldump -uadmin -p -h192.168.58.3 -p3306 -e -r --triggers --single-transaction --master-data=2 test1 --tables t1 --where='c1>1000000' > test1_t1_w.sql

不包含建表语句

# mysqldump -uadmin -p -h192.168.58.3 -p3306 -e -r --triggers --single-transaction --master-data=2 --no-create-info test1 --tables t1 --where='c1>1000000' > test1_t1_w.sql

注意事项

• 默认情况下，mysqldump是不会导出information_schema、performance_schema和sys的，如果需要导出，则在命令行中显示指定选项 --databases, -b；
• mysqldump不会导出innodb创建表空间create tablespace语句；
• 不建议使用当前版本的mysqldump导出文件导入mysql5.6.9(或更早)开启gtid的版本；
• 如果general_log和slow_query_log都是指定存存储在表中，mysqldump导出文件包含general_log和slow_query_log表的创建语句，但并不包含表数据。

参考

☆〖本人水平有限，文中如有错误还请留言批评指正！〗☆