从 MySQL 迁移到 ProtonBase 指南

ProtonBase 提供数据同步服务，可以方便、快捷的将 MySQL 数据一站式迁移至 ProtonBase。

• 如何同步 MySQL 数据参考文档Teleport 同步 MySQL 数据

字段类型映射

查询语法

如果你使用的是 ORM(Object-Relational Mapping) 框架，例如 Java 的 Hibernate、Python 的 SQLAlchemy 等，那么迁移过程会相对简单。你只需要修改 ORM 配置中的数据库驱动和连接字符串，切换到 ProtonBase 的驱动程序，大部分查询语句都无需改动，因为 ORM 会根据目标数据库自动生成正确的 SQL 语法。

当然，仍然可能存在一些 ORM 不能很好地抽象和转换的数据库特有语法和功能，这些你可能仍需要手动调整。下面是一些常见的语法差异：

标识符引号

MySQL中使用反引号``来引用数据库、表、列等标识符。ProtonBase 使用双引号"来引用标识符。

字符串引号

MySQL中使用单引号'和双引号"来引用字符串。ProtonBase只使用单引号'来引用字符串。

LIMIT分页语法

MySQL支持LIMIT {偏移量}, {行数}的语法进行分页，如 limit 20, 10。ProtonBase使用OFFSET {偏移量} LIMIT {行数}的语法进行分页，如 offset 20 limit 10。

NULL 判断

MySQL 使用= NULL 或 != NULL判断是否等于 NULL。ProtonBase 则是 IS NULL 或 IS NOT NULL。必须使用 IS NULL，不能使用 = 或 != 比较。

字符串拼接

MySQL 使用 CONCAT() 函数。ProtonBase 可以使用 ||，如 'aa' || 'bb'。

Column must appear in the GROUP BY clause or be used in an aggregate

MySQL 里允许查询 ungrouped 字段，ProtonBase 里会报错，如下：

=> create table t(a int, b int, c int);
CREATE TABLE
=> select a, b, sum(c) from t group by a;
ERROR:  column "t.b" must appear in the GROUP BY clause or be used in an aggregate function
LINE 1: select a, b, sum(c) from t group by a;

select 中的字段必须在 group by 中或者参与聚合操作。

Union/Union all 不同字段类型

MySQL在UNION查询中,不同字段类型会被自动转换为相容类型。ProtonBase在UNION查询中,如果字段类型不完全匹配,需要做类型转换。

=> create table t1(a int);
=> create table t2(b text);
=> select a from t1 union all select b from t2;

在MySQL中,虽然a和b类型不同,会自动进行类型转换。但在ProtonBase中,默认会报错，需要显式进行类型转换:

=> create table t2(b text);
=> select a from t1 union all select b from t2;
ERROR:  UNION types integer and text cannot be matched
 
-- 转换 a 的类型为 text
=> select a::text from t1 union all select b from t2;

常见函数