在开发场景中,我们经常会遇到需要将mysql数据库迁移到sqlite的情况,比如要把线上服务用的mysql数据同步到本地做轻量测试,或者项目从服务端部署改为本地单机部署需要更换数据库。不过mysql和sqlite在数据类型定义、SQL语法、存储规则上都有不少差异,直接复制数据很容易出问题,下面我们就一步步讲解完整的转换方法。

转换前的准备工作
首先我们需要准备好两个环境,一个是能正常访问的mysql数据库,另一个是安装好sqlite的环境,同时建议提前备份好mysql的原始数据,避免转换过程中出现数据丢失的情况。另外要确认mysql中要转换的库表结构,记录下所有的表名、字段类型、索引、约束等信息,方便后续对照调整。
第一步:从mysql导出数据
我们可以使用mysqldump工具导出mysql的结构和数据,注意导出时要去掉mysql特有的语法,避免后续导入sqlite时报错。执行下面的命令导出数据:
-- 导出mysql的表结构和数据,去掉mysql特有的注释和引擎设置 mysqldump -u 用户名 -p 数据库名 --no-create-db --skip-comments --compact > mysql_export.sql
导出的sql文件里会包含mysql的建表语句和insert语句,接下来我们需要对这个文件做适配调整。
第二步:处理类型映射和语法差异
mysql和sqlite的数据类型并不完全对应,我们需要先调整字段类型,同时还要修改不兼容的SQL语法,常见的差异如下:
| mysql类型 | sqlite对应类型 | 说明 |
|---|---|---|
| INT, INTEGER, BIGINT | INTEGER | sqlite没有单独的BIGINT类型,统一用INTEGER存储 |
| VARCHAR(n), CHAR(n) | TEXT | sqlite的TEXT类型可以存储任意长度的字符串,不需要指定长度 |
| DATE, DATETIME, TIMESTAMP | TEXT或INTEGER | sqlite没有原生日期类型,建议存成TEXT格式的ISO时间字符串 |
| DECIMAL(n,m), FLOAT, DOUBLE | REAL | sqlite用REAL类型存储浮点数和小数 |
除了类型调整,还有几个语法点需要修改:
- 去掉建表语句里的
ENGINE=InnoDB DEFAULT CHARSET=utf8mb4这类mysql专属的引擎和字符集设置 - 去掉
AUTO_INCREMENT,sqlite的自增字段需要定义为INTEGER PRIMARY KEY AUTOINCREMENT - mysql的注释是
-- 注释内容,如果后面没有空格可能会报错,统一改成sqlite支持的-- 注释内容(注意--后面加空格) - 如果有
UNSIGNED关键字,直接删掉,sqlite不支持无符号类型
第三步:调整后的sql导入sqlite
处理完sql文件后,我们就可以把它导入到sqlite数据库中了,执行下面的命令:
-- 创建新的sqlite数据库并导入处理后的sql文件 sqlite3 target.db < adjusted_mysql.sql
如果导入过程中没有报错,就说明转换成功了,我们可以用sqlite3客户端连接数据库验证数据:
-- 连接sqlite数据库并查询表数据 sqlite3 target.db .tables -- 查看所有表 SELECT * FROM 表名 LIMIT 10; -- 查看前10条数据
常见问题解决
转换过程中最常遇到的是语法报错,比如提示某个关键字不识别,这时候可以打开sql文件找到对应的行,检查是不是还有未处理的mysql专属语法。如果是数据类型不匹配导致的插入失败,可以对照上面的类型映射表调整字段类型。另外如果导出的数据里有特殊字符,比如单引号,需要确认是否已经做了转义,避免插入时字符串截断。
如果是表结构比较复杂,有外键、触发器或者存储过程,需要注意sqlite对外键的支持默认是关闭的,需要手动执行PRAGMA foreign_keys = ON;开启,而存储过程和触发器需要按照sqlite的语法重新编写,因为两者的触发器语法差异较大,无法直接兼容。