在本地开发或运维中,经常需要把MySQL数据库从一台机器迁移到另一台,或者做定期备份。使用MySQL官方提供的命令行工具可以完成可靠的导出与导入,不需要借助第三方图形软件也能精准控制过程。
一、使用mysqldump导出本地数据库
mysqldump是MySQL安装包自带的逻辑备份工具,它会连接数据库并把表结构、数据以及触发器、存储过程等对象输出为标准的SQL语句文本。相比直接拷贝数据目录文件,逻辑导出不受MySQL版本和存储引擎差异影响,迁移更稳妥。
最基本的单库导出命令如下,其中-u后面是用户名,-p表示回车后输入密码,db_name是要导出的库名,大于号把输出写到sql文件:
# 导出单个数据库结构和数据 mysqldump -u root -p db_name > /tmp/db_name.sql # 导出所有数据库 mysqldump -u root -p --all-databases > /tmp/all_db.sql # 导出时压缩,节省磁盘 mysqldump -u root -p db_name | gzip > /tmp/db_name.sql.gz
如果数据库中含有大量数据,建议加上--single-transaction参数,它利用InnoDB的一致性读保证备份期间不锁表;同时用--routines和--events把存储过程和事件也一并导出。对于只包含MyISAM表的库,则需要用--lock-tables来防止导出时数据写入导致不一致。
导出的SQL文件开头通常包含SET语句来记录字符集和时区,这正是为了避免导入端环境不同而产生乱码。因此不要手动删改文件头,除非你明确知道目标环境完全一致。
二、使用mysql命令导入数据库
导入的本质是把之前生成的SQL文本交给mysql客户端执行。目标机器需要先创建空库(如果SQL里没有建库语句),再通过重定向或source命令执行。
下面演示在命令行直接导入整个文件,以及进入客户端后用source导入的两种方式:
# 方式一:命令行直接重定向 mysql -u root -p db_name < /tmp/db_name.sql # 方式二:先登录再执行 mysql -u root -p CREATE DATABASE db_name CHARACTER SET utf8mb4; USE db_name; SOURCE /tmp/db_name.sql;
当原文件是gzip压缩包时,可先解压再导入,或者在Linux下用zcat管道传入:zcat /tmp/db_name.sql.gz | mysql -u root -p db_name。这种方式省去了解压占盘的步骤。
导入大文件时常碰到server has gone away错误,这是因为MySQL默认接收的包大小max_allowed_packet偏小。可在导入前临时调大,或在配置文件里修改后重启:
-- 登录后执行,单位字节,设为256M SET GLOBAL max_allowed_packet = 268435456;
三、字符集与权限注意事项
很多导入后出现中文乱码,根源是导出端、SQL文件、导入端三处字符集不统一。推荐统一使用utf8mb4,它完整支持表情符与特殊汉字。创建目标库时显式声明,可以避免沿用服务器默认的可能偏老的字符集。
权限方面,执行导入的账号需要对目标库有CREATE、INSERT、ALTER等权限;若SQL中含有DEFINER定义的视图或存储过程,还需注意目标库存在对应的授权用户,否则导入后调用会报权限拒绝。开发机一般用root规避,但生产环境应遵循最小权限原则。
| 场景 | 推荐做法 | 风险 |
|---|---|---|
| 同版本本机备份 | mysqldump单库导出后mysql导入 | 几乎无 |
| 跨版本迁移 | 逻辑导出,目标建库指定字符集 | 旧版语法不兼容需手工改 |
| 超大数据量 | 加single-transaction并调大packet | 耗时较长 |
四、常见问题与排查思路
如果导入时报错说表已存在,说明SQL里包含CREATE TABLE且目标库非空。可先清空库或用mysqldump的--add-drop-table参数重新导出,它会在建表前自动写DROP TABLE语句。
另一种情况是外键约束导致插入顺序报错。临时关闭约束检查能快速通过导入,完成后再开启:
SET FOREIGN_KEY_CHECKS = 0; SOURCE /tmp/db_name.sql; SET FOREIGN_KEY_CHECKS = 1;
对于Windows用户,路径中的反斜杠要写成双反斜杠或改用正斜杠,例如C:/backup/db.sql,否则命令行会误解析。此外,powershell与cmd对重定向的支持略有差异,遇到怪异报错可换终端重试。
掌握上述导出导入方法后,本地MySQL数据库的迁移和备份就不再依赖图形工具,也能在脚本里定时自动化,保障数据安全与环境一致。