mysqldump部分参数整理

2023年 8月 15日 70.1k 0

mysqldump

-A, --all-databases  //备份所有数据库和表。在8.0之前使用-A的时候不需要显式指定--routines和--events参数来备份存储过程、函数和事件,因为备份的时候会备份mysql库,里面包含了mysql.proc和mysql.event表。在8.0开始使用-A的时候需要显式指定--routines和--events参数来备份存储过程、函数和事件,因为8.0开始不会备份mysql.proc和mysql.event表。

-Y, --all-tablespaces //只与NDB cluster有关,将在备份文件保存创建NDB表使用的任何表空间所需要的所有sql语句。

-y, --no-tablespaces //该选项抑制mysqldump输出中的所有CREATE LOGFILE GROUP和CREATE TABLESPACE语句。

--add-drop-database //在每个CREATE DATABASE语句之前写一个DROP DATABASE语句,该选项默认是false。该选项通常与--all-databases或--databases选项一起使用。在8.0开始要使用--add-drop-database,请使用--databases指定要备份的数据库并且其中不包括mysql库。

--add-drop-table  //在每个CREATE TABLE语句之前写一个DROP TABLE语句。默认为on,如果不想加的话使用--skip-add-drop-table。

--add-drop-trigger //在每个CREATE TRIGGER语句之前写一个DROP TRIGGER语句。

--add-locks  //在每个表insert语句前后加上lock tables和unlock tables。默认是on,不想加的话可以使用--skip-add-locks。

--allow-keywords //允许创建关键字列名。

--apply-slave-statements //8.0.26之前使用的是这个选项,之后使用的是--apply-replica-statements。在带有二进制日志坐标的语句之前加一个stop replica(stop slave),在文件末尾添加start replica(start slave)。

--bind-address //在具有多个网络接口的计算机上,使用此选项选择使用哪个接口连接到MySQL服务器。

--character-sets-dir //字符集安装的目录。

-i, --comments //在备份文件中添加附加信息(程序版本、服务器版本和主机等信息),默认情况下是启用的,可以使用--skip-comments来禁止。

--compatible //导出的数据与其他数据库系统或旧的mysql服务器更兼容,该选项唯一允许的值是ansi(这种模式改变语法和行为,使其更接近标准sql)。

--compact //使备份文件更紧凑,去掉注释和头尾等结构。该选项会启用--skip-add-drop-table、--skip-add-locks、--skip-comments、--skip-disable-keys和--skip-set-charset选项。

-c, --complete-insert //使用包含列名的完整的sql语句,但是可能会受到max_allowed_packet参数的影响。

-C, --compress //压缩client和server段之间发送的所有信息,压缩产生于客户端,但是影响客户端和服务器端的CPU负载,因为双方都执行压缩和解压缩的操作。从8.0.18开始,这个选项被弃用。

-a, --create-options //create table语句中包括所有mysql特性选项(默认打开)。如果关闭可以使用--skip-create-options。

-B, --databases //备份多个数据库。通常mysqldump将命令行上的第一个名称参数作为数据库名,将后面的名称作为表名,使用此选项后会将该参数后面的所有名称视为数据库名称,因为使用-A也不会备份performance_schema、infomation_schema、sys数据库,但是可以使用该参数来备份这些数据库。

--tables //需要备份哪些表。

--default-character-set //配置字符集,5.7默认utf8,8.0默认utf8mb4。

--delete-master-logs //从8.0.26开始使用--delete-source-logs,两种具有相同用的效果。在进行备份后通过向服务器发送purge binary log语句来删除二进制日志。该选项启用--master-data(8.0.26开始叫做--source-data)。

-K, --disable-keys //对于每个表在insert语句周围加上alter table tbl_name disable keys和alter tbl_name enable keys语句,这使得备份更快,因为索引是在插入所有行之后创建的,此选项进对于myisam表的非唯一索引有效。默认开启的,可以使用--skip-disable-keys来禁用。

--dump-slave  //从8.0.26开始使用--dump-replica参数,这两个参数具有同样的效果。该选项将导致主的binlog位置和文件名追加到备份文件中。设置为1时,将会以CHANGE MASTER命令输出到数据文件(不会注释),设置为2时会进行注释。该选项将会打开--lock-all-tables,除非指定了--single-transaction。该选项会自动关闭--lock-tables选项。默认值为0。与--master-data的区别是,--dump-slave会在备份开始的时候执行stop slave sql_thread,备份完成后执行start slave,如果备份失败,可能导致sql thread停止。

-E, --events //导出事件,在备份文件中包含数据库的事件,文件中包含create event语句来创建对应的事件。

-e, --extended-insert //该选项是将多个insert语句合并成一个(insert into .. values (),(),(),()..)提高导入效率,可以使用--skip-extended-insert 来关闭该选项(insert into .. values(); insert into .. values()...),但是开启该选项比关闭该选项耗时减少3、4倍。

-F, --flush-logs //开始导出之前刷新日志。假如一次导出多个数据库(使用选项--databases或者--all-databases),将会逐个数据库刷新日志。除使用--lock-all-tables或者--master-data外。在这种情况下,日志将会被刷新一次,相应的所以表同时被锁定。因此,如果打算同时导出和刷新日志应该使用--lock-all-tables 或者--master-data 与--flush-logs一起使用。

--flush-privileges //在导出mysql数据库之后,发出一条FLUSH  PRIVILEGES 语句。为了正确恢复,该选项应该用于导出mysql数据库和依赖mysql数据库数据的任何时候。

-f, --force //在导出过程中忽略出现的sql错误。

--hex-blob //使用十六进制表示法转储二进制列(例如,'abc'变成0x616263)。当与二进制字符集一起使用时,受影响的数据类型为BINARY、VARBINARY、BLOB类型、BIT、所有空间数据类型和其他非二进制数据类型。

-h, --host //从给定主机上的MySQL服务器进行备份。默认主机为localhost。

--ignore-error=error[,error]... //忽略指定的错误。选项值是一个用逗号分隔的错误编号列表,指定在mysqldump执行期间要忽略的错误。如果还指定了——force选项以忽略所有错误,则--force优先。

--ignore-table=name //不转储指定的表。若要指定要忽略的多个表,请多次使用该指令,每个表一次。每个表必须同时指定数据库名和表名,例如--ignore-table=database.table。

--include-master-host-port //8.0.26开始使用--include-source-host-port,这两个有相同的效果。与--dump-slave一起使用,在--dump-slave产生的'CHANGE  MASTER TO..'语句(8.0.23是CHANGE REPLICATION source to)中增加'MASTER_HOST=,MASTER_PORT='  ,在从库使用。

--insert-ignore //在插入行时使用INSERT IGNORE语句。insert ignore into 是如果数据库没有这条数据,就插入该数据数据,如果有数据的话(比如主键冲突)就跳过这条数据。

-x, --lock-all-tables //备份的时候加全局读锁(flush tables with read lock),锁定所有数据库中的所有表,并且这个选项会自动关闭-lock-tables选项,并且 不能和--single-transaction一起使用。

-l, --lock-tables //对于备份每个数据库的时候,备份前先锁定该库中所有的表(lock table tb1 read,tb2 read....;),备份完成该库后就会释放锁,备份另一个数据库的时候再去锁定另一个库中的表。myisam表应该使用该参数锁定表,对于innodb的事务表--single-transaction是一个更好的选择,因为它不需要锁表。因为--lock-tables是分别锁定的库中的表,所以不能保证备份文件中的表在数据库之间的逻辑的一致性。--opt参数会自动启用--lock-tables,如果不想启用则使用--skip-lock-tables。

--log-error=name //将告警和错误记录到指定文件中,默认是不记录的。

--master-data[=#] //8.0.26变为了--source-data,两种效果是一样的。当为1的的时候在备份文件中存在change master to (8.0.23之后change replication source to)语句;当为2的时候存在change语句但是是注释状态。该参数会默认打开--lock-all-tables,关闭--lock-tables。如果一起使用了--single-transaction那么会锁很短的时间就会释放锁。如果使用--dump-slave参数的话会忽略--master-data参数。

--max-allowed-packet=# //服务器发送和接收的最大包长度,默认6M,最大1GB。该选项的值是特定于mysqldump的,不要于mysql内部的max_allowed_packet系统变量混淆。

--net-buffer-length=# //客户端和服务器通信缓冲区的初始大小。当创建多行insert语句时(使用--extend-insert),mysqldump创建的行长度不超过--net-buffer-length字节。如果mysqldump的时候增加该值,也请确保mysql内部该变量的值至少有这么大。

--no-autocommit  //将每个备份的表insert语句包含在set autocommit=0和commit语句中。

-n, --no-create-db //在备份文件中不包含create database语句。

-t, --no-create-info //只导出数据,不添加create table语句。

-d, --no-data //只导出表结构,不导出表数据。

-N, --no-set-names  //关闭--set-charset设置,与--skip-set-charset相同。

--set-charset  //将SET NAMES default_character_set(值)写入备份文件,默认启用,如果关闭需要使用上面的参数或者--skip-set-charset。

-q, --quick  //将select出来的结果直接dump到备份文件,默认情况下是开启的。如果关闭的话(--skip-quick)会将select结果先缓存到内存中,是非常消耗内存的。

--opt //等同于--add-drop-table,  --add-locks, --create-options, --quick, --extended-insert, --lock-tables,  --set-charset, --disable-keys 该选项默认开启,  可以用--skip-opt关闭。

--order-by-primary //在备份每个表的时候,按照其主键或者第一个唯一索引(如果存在的话)进行排序,这在将myisam表恢复到innodb表时非常有用,但是也会使备份操作花费相当长的时间。

-u, --user=name //备份使用的用户。

-p, --password[=name] //备份用户的密码。

-P, --port=#   //备份数据库的端口号。

--protocol={TCP|SOCKET|PIPE|MEMORY} //用于指定连接到服务器的传输协议。

-Q, --quote-names //使用``引起数据名、表名和列名,默认打开。可以使用--skip-quote-names关闭。

--replace  //使用replace into来代替insert into。

-r, --result-file=name //指定备份输出的文件,即使在备份过程中发生错误,也会创建该文件并且如果该文件存在话会覆盖之前内容。这个选项应该应用在DOS、windows系统上,以防止换行符\n被转换为回车换行\r\n。

-R, --routines //导出存储过程和自定义函数,备份文件中包含CREATE PROCEDURE和CREATE FUNCTION语句。

--single-transaction //该选项在备份的时候会将隔离级别设置为RR,并且使用start transaction来开启一个事务,来达到备份的一致性,只对事务表(innodb)有用。使用该选项的时候只有事务表是一致的状态,而myisam或者memory表仍然可能改变状态。该选项和--lock-tables是互斥的,因为lock tables会隐式提交任何挂起的事务。该参数不能与--lock-all-tables一起使用会报错。--master-data会自动关闭--lock-tables。

--set-gtid-purged //该参数是基于GTID模式的,是获取的gtid_excuted系统变量,开启该参数的时候会在备份文件中加入set @@session sql_log_bin=0语句,这样会使得恢复的时候不计入binlog,如果在主库恢复可能导致主备不一致。开启该选项的话和--single-transaction一起使用可能导致输出不一致,如果需要使用的话可以与--lock-all-tables一起使用(--master-data默认开启--lock-all-tables)。

有如下几个值:

auto:默认值,如果数据库中启用了gtid且gtid_excuted不为空则将set @@global.gtid_purged和set @@session.sql_log_bin=0添加到备份文件中。如果没有开启gtid则不会添加。

off:不会在备份文件中添加set @@global.gtid_purged和set @@session.sql_log_bin=0。

on:如果数据库中启用了gtid且gtid_excuted不为空则将set @@global.gtid_purged和set @@session.sql_log_bin=0添加到备份文件中,如果没有启用gtid则会发生错误。

--dump-date //将备份时间添加到文件末尾,默认打开。可以使用--skip-dump-date来关闭。

--server-public-key-path=name //PEM格式文件的路径名,其中包含服务器进行基于RSA密钥对的密码交换所需的公钥的客户端副本。该选项适用于使用sha256_password或caching_sha2_password身份验证插件进行身份验证的客户端。对于没有使用这些插件之一进行身份验证的帐户,该选项将被忽略。

--get-server-public-key //从服务器请求基于RSA密钥对的密码交换所需的公钥。该选项适用于使用caching_sha2_password身份验证插件进行身份验证的客户端。

--fields-terminated-by 、--fields-enclosed-by、--fields-optionally-enclosed-by、--fields-escaped-by //这些选项与--tab选项一起使用,与load data infile对应的选项意义相同,但是不能与--databases和--all-databases一起使用。

--lines-terminated-by //该选项与--tab选项一起使用,与LOAD DATA对应的LINES子句具有相同的含义。但是不能与--databases和--all-databases一起使用。

-T, --tab=name //需要在mysql中设置secure_file_priv参数。指定生成文件的路径,每个表分别生成两个文件(.txt存储数据、.sql存储sql语句),在.txt文件中每列的数据默认以tab分割,与上面的几个参数搭配使用,相当于load data infile。只有当mysqldump和mysqld在同一台机器上运行时,才应该使用这个选项。

--triggers //备份每个表中的触发器。默认情况下启用此选项,使用--skip-triggers禁用它。

--tz-utc //在备份文件顶部设置时区TIME_ZONE='+00:00' ,以保证在不同时区导出的TIMESTAMP 数据或者数据被移动其他时区时的正确性。默认开启,可以使用--skip-tz-utc来关闭。

-w, --where=name  //只转储给定的WHERE条件选择的记录。请注意如果条件包含命令解释符专用空格或字符,一定要将条件引用起来。

-X, --xml //导出xml格式。

--default-auth //使用客户端身份认证插件。

--plugin-dir //查找插件的目录,一般使用--default-auth参数,且mysqldump找不到插件时使用该参数显示指定。

--enable-cleartext-plugin //激活或者禁用mysql_clear_password认证插件

相关文章

Oracle如何使用授予和撤销权限的语法和示例
Awesome Project: 探索 MatrixOrigin 云原生分布式数据库
下载丨66页PDF,云和恩墨技术通讯(2024年7月刊)
社区版oceanbase安装
Oracle 导出CSV工具-sqluldr2
ETL数据集成丨快速将MySQL数据迁移至Doris数据库

发布评论