---
title: "在浏览器中将 MariaDB 迁移到 MySQL"
description: "将 MariaDB 数据库迁移到 MySQL：把转储转换为表、键、序列和数据相同的脚本，并报告每项更改。"
canonical: https://intosql.com/zh-cn/mariadb-to-mysql
last_updated: 2026-10-15
---

# 在浏览器中将 MariaDB 迁移到 MySQL

拖入由 mariadb-dump、mysqldump、phpMyAdmin 或 Adminer 生成的转储（.sql 或 .sql.gz），即可下载包含相同表、键、索引和数据的 MySQL 脚本。MySQL 无法原样存储的每个值，以及它不支持的每个对象，都会在报告中列出。

[MariaDB 到 MySQL 迁移指南](https://intosql.com/docs/migrations/mariadb-to-mysql)

[MariaDB 到 MySQL 的数据类型](https://intosql.com/docs/types/mariadb-to-mysql)

## 从 MariaDB 到 MySQL 的变化

每一行是转换器应用的一条规则，以及该规则更改你的数据时在报告中写入的记录。

| 在 MariaDB 中 | 在 MySQL 中 | 报告记录 |
| --- | --- | --- |
| utf8mb4_0900_* and utf8mb4_uca1400_* collations | utf8mb4_unicode_520_ci（二进制排序规则用 utf8mb4_bin） | `collation_replaced` |
| zero, partial or impossible dates (0000-00-00, 2024-02-30) | 保留 |  |
| TIME | TIME，包括时长 |  |
| TINYINT(1), BOOL | TINYINT(1) |  |
| UNSIGNED and ZEROFILL | 保留 |  |
| ENUM and SET, the '' error value included | 保留 |  |
| JSON | JSON |  |
| NUL bytes in text | 保留 |  |
| AUTO_INCREMENT | AUTO_INCREMENT，带表的计数器 |  |
| MyISAM AUTO_INCREMENT on the second column of a key, in a table that isn't MyISAM in the dump | 列上的一个索引，整个表一个计数器 | `myisam_group_autoincrement` |
| ON UPDATE CURRENT_TIMESTAMP | 保留 |  |
| generated columns | 与源数据一样为 VIRTUAL 或 STORED |  |
| generated columns with functions IntoSQL doesn't read | 普通列 | `generated_not_translated` |
| INVISIBLE columns | 普通列 | `invisible_column` |
| CHECK constraints | 保留（MySQL 5.7 会解析并忽略它们） |  |
| CHECK constraints with functions IntoSQL doesn't read | 不创建 | `check_skipped` |
| CHECK ... NOT ENFORCED | 不创建 | `check_not_enforced` |
| expression defaults, and defaults on TEXT, BLOB, JSON and GEOMETRY | 无默认值 | `default_not_translated` |
| functional indexes, KEY ((expr)) | 不创建 | `index_skipped` |
| keys and indexes on a prefix, c(20) | 保留 |  |
| FULLTEXT indexes | 保留 |  |
| SPATIAL indexes | 保留 |  |
| foreign keys | 保留，以 FOREIGN_KEY_CHECKS=0 导入 |  |
| GEOMETRY, POINT, POLYGON... | 保留，带每个值的 SRID |  |
| INET4, INET6, UUID (MariaDB) | varchar(15), varchar(39), char(36) | `type_replaced` |
| BINARY, VARBINARY, BLOB | 保留 |  |
| PARTITION BY | 单个表 | `partitions_dropped` |
| WITH SYSTEM VERSIONING (MariaDB) | 只含当前行的表 | `system_versioning_dropped` |
| Aria, ColumnStore, CONNECT, Spider, RocksDB (MariaDB) | InnoDB | `engine_dropped` |
| CREATE SEQUENCE (MariaDB) | 不创建 | `sequence_not_converted` |
| views, triggers, procedures, functions and events | 在报告中列出 | `not_converted_objects` |
| NOT NULL columns with values that become NULL | 去除 NOT NULL | `not_null_relaxed` |
| text that isn't valid in its character set | 错误的字节变为替换字符 | `invalid_utf8_replaced` |
| text decoded twice (Ã±) | 按原样复制 | `mojibake_suspected` |
| dumps without CREATE TABLE | 根据值推断类型 | `no_schema` |
| geometries in a dump without CREATE TABLE | GEOMETRY |  |
| SET NAMES utf8 from utf8mb4 tables | 已转换，并给出警告 | `dump_lost_four_byte_chars` |
| dumps without SET NAMES whose text isn't UTF-8 | 按 Latin-1 (Windows-1252) 读取 | `charset_guessed` |
| sjis, cp932, gbk, big5 dumps | 按 UTF-8 读取，并给出警告 | `unsupported_charset` |
| UNHEX('..'), CONVERT(b'..', UNSIGNED), CONVERT(".." USING x), ST_GeomFromText('..') in rows | 求值 |  |
| other expressions in rows | NULL | `expression_value` |
| DEFAULT in VALUES | 该列的默认值 | `default_keyword_filled` |
| DEFAULT in VALUES without a literal default | NULL | `default_keyword_null` |
| REPLACE and INSERT IGNORE | 普通行 | `replace_as_insert` |
| types IntoSQL doesn't know | LONGBLOB | `unknown_type` |
| values that don't fit their column | NULL | `invalid_value_null` |
| unreadable geometries | NULL | `bad_geometry` |
| TIMESTAMP | 保留，按转储声明的时区导入 |  |
| VECTOR(n) (MariaDB 11.7+) | json，浮点数存为数组 | `type_replaced` |

## 将脚本导入 MySQL

脚本先创建表、复制行，再添加键、索引和外键，因此导入速度快，并会在遇到第一个错误时停止。

```shell
mysql --default-character-set=utf8mb4 mydb < mariadb.mysql.sql
```

外键按转储中的声明创建，导入行时使用 FOREIGN_KEY_CHECKS=0，因此指向不存在的行的行不会中止导入。

对于较大的转储，请在服务器所在的机器上运行客户端；如果单行非常大，请调高 max_allowed_packet。

IntoSQL Pro 可以通过桌面应用或命令行将文件直接导入 MySQL，无需生成脚本。

## 如何转储 MariaDB 以获得最佳结果

转换器读取转储中的内容。以下选项能让转储保留更多数据：

- --default-character-set=utf8mb4 会保留表情符号和其他 4 字节字符，而 utf8mb3 转储在转换器读取之前就会丢失它们。
- --hex-blob 将二进制列和 VECTOR 值写为十六进制，在系统之间复制时不会损坏。
- --routines --triggers --events 会将这些对象加入转储，以便报告列出它们。

## 哪些内容不会转换

视图、触发器、存储过程、函数和事件都是用 MariaDB 自己的语言编写的。它们会按名称在报告中列出，绝不会被悄悄丢弃，以便你为 MySQL 重写。

## 关于 MariaDB 转 MySQL 的问题

### 我的转储会被上传吗？

不会。转换器在你的浏览器中运行，分块从磁盘读取转储，因此转储不会离开你的电脑。桌面应用和命令行也在你的电脑上转换。

### 转储可以多大？

转换器从不把整个转储放进内存：它按范围读取文件两次，边读边写出脚本。几 GB 的转储可以在浏览器、桌面应用和命令行中转换。

### 转储可以来自哪些 MariaDB 版本？

由 MariaDB 10.3 到 12 的 mariadb-dump 和 mysqldump 写出的转储，每个表一条 INSERT 或每行一条均可。每个测试转储都来自 MariaDB 10.11、11.4 和 11.8，并与其源数据逐个单元格比较。

### UUID、INET6、JSON 和 VECTOR 列会保留吗？

UUID 变为 char(36)，INET4 和 INET6 变为 varchar，JSON 变为 json，VECTOR 变为由其浮点数组成的 json 数组，因为 MySQL 5.7 和 8.0 没有这些类型。

### AUTO_INCREMENT 值和序列会保留吗？

AUTO_INCREMENT 保持不变，从转储停下的位置继续。MySQL 没有序列，因此序列以及从中取值的默认值都会在报告中说明。

### 存储过程和触发器怎么处理？

它们会按名称在报告中列出，但不会转换，因此你可以在重新创建之前对照 MySQL 逐个检查。

### 脚本可以导入哪些 MySQL 版本？

MySQL 5.7 及更高版本。每个测试转储都能在 5.7 和 9 上导入，如有问题会在第一个错误处停止。

## 从 MariaDB

- [MariaDB 到 PostgreSQL](https://intosql.com/zh-cn/mariadb-to-postgresql)
- [MariaDB 到 MariaDB](https://intosql.com/zh-cn/mariadb-to-mariadb)
- [MariaDB 到 SQLite](https://intosql.com/zh-cn/mariadb-to-sqlite)
- [MariaDB 到 SQL Server](https://intosql.com/zh-cn/mariadb-to-sql-server)
- [MariaDB 到 Oracle](https://intosql.com/zh-cn/mariadb-to-oracle)

## 到 MySQL

- [MySQL 到 MySQL](https://intosql.com/zh-cn/mysql-to-mysql)
- [PostgreSQL 到 MySQL](https://intosql.com/zh-cn/postgresql-to-mysql)
- [SQL Server 到 MySQL](https://intosql.com/zh-cn/sql-server-to-mysql)
- [SQLite 到 MySQL](https://intosql.com/zh-cn/sqlite-to-mysql)
- [Oracle 到 MySQL](https://intosql.com/zh-cn/oracle-to-mysql)

## 指南和所有组合

- [MySQL 到 MariaDB](https://intosql.com/zh-cn/mysql-to-mariadb)
- [MariaDB 到 MySQL 迁移指南](https://intosql.com/docs/migrations/mariadb-to-mysql)
- [MariaDB 到 MySQL 的数据类型](https://intosql.com/docs/types/mariadb-to-mysql)
- [所有数据库组合](https://intosql.com/zh-cn/database-migration)
