TiDB
社区
联系我们

与 MySQL 兼容性对比

  • TiDB 高度兼容 MySQL 5.7 协议、MySQL 5.7 常用的功能及语法。MySQL 5.7 生态中的系统工具（PHPMyAdmin、Navicat、MySQL Workbench、mysqldump、Mydumper/Myloader）、客户端等均适用于 TiDB。

  • 但 TiDB 尚未支持一些 MySQL 功能，可能的原因如下：

    • 有更好的解决方案，例如 JSON 取代 XML 函数。
    • 目前对这些功能的需求度不高，例如存储流程和函数。
    • 一些功能在分布式系统上的实现难度较大。

  • 除此以外，TiDB 不支持 MySQL 复制协议，但提供了专用工具用于与 MySQL 复制数据

    • 从 MySQL 复制：TiDB Data Migration (DM) 是将 MySQL/MariaDB 数据迁移到 TiDB 的工具，可用于增量数据的复制。
    • 向 MySQL 复制：TiCDC 是一款通过拉取 TiKV 变更日志实现的 TiDB 增量数据同步工具，可通过 MySQL sink 将 TiDB 增量数据复制到 MySQL。

不支持的功能特性

  • 存储过程与函数
  • 触发器
  • 事件
  • 自定义函数
  • 外键约束 #18209
  • 临时表 #1248
  • 全文语法与索引 #1793
  • 空间类型的函数（即 GIS/GEOMETRY）、数据类型和索引 #6347
  • 非 ascii/latin1/binary/utf8/utf8mb4 的字符集
  • SYS schema
  • MySQL 追踪优化器
  • XML 函数
  • X-Protocol #1109
  • Savepoints #6840
  • 列级权限 #9766
  • XA 语法（TiDB 内部使用两阶段提交，但并没有通过 SQL 接口公开）
  • CREATE TABLE tblName AS SELECT stmt 语法 #4754
  • CHECK TABLE 语法 #4673
  • CHECKSUM TABLE 语法 #1895
  • GET_LOCK 和 RELEASE_LOCK 函数 #14994

与 MySQL 有差异的特性详细说明

自增 ID

  • TiDB 的自增列仅保证唯一，也能保证在单个 TiDB server 中自增，但不保证多个 TiDB server 中自增，不保证自动分配的值的连续性，建议不要将缺省值和自定义值混用，若混用可能会收 Duplicated Error 的错误信息。

  • TiDB 可通过 tidb_allow_remove_auto_inc 系统变量开启或者关闭允许移除列的 AUTO_INCREMENT 属性。删除列属性的语法是：ALTER TABLE MODIFY 或 ALTER TABLE CHANGE。

  • TiDB 不支持添加列的 AUTO_INCREMENT 属性，移除该属性后不可恢复。

自增 ID 详情可参阅 AUTO_INCREMENT。

mysql> CREATE TABLE t(id INT UNIQUE KEY AUTO_INCREMENT);
Query OK, 0 rows affected (0.05 sec)

mysql> INSERT INTO t VALUES(),(),();
Query OK, 3 rows affected (0.00 sec)
Records: 3  Duplicates: 0  Warnings: 0

mysql> SELECT _tidb_rowid, id FROM t;
+-------------+------+
| _tidb_rowid | id   |
+-------------+------+
|           4 |    1 |
|           5 |    2 |
|           6 |    3 |
+-------------+------+
3 rows in set (0.01 sec)

Performance schema

TiDB 主要使用 Prometheus 和 Grafana 来存储及查询相关的性能监控指标，所以 Performance schema 部分表是空表。

查询计划

EXPLAIN/EXPLAIN FOR 输出格式、内容、权限设置与 MySQL 有比较大的差别，参见理解 TiDB 执行计划。

内建函数

支持常用的 MySQL 内建函数，有部分函数并未支持。可通过执行 SHOW BUILTINS 语句查看可用的内建函数。参考 SQL 语法文档。

DDL 的限制

TiDB 中，所有支持的 DDL 变更操作都是在线执行的。与 MySQL 相比，TiDB 中的 DDL 存在以下限制：

  • 不能在单条 ALTER TABLE 语句中完成多个操作。例如，不能在单个语句中添加多个列或索引，否则，可能会输出 Unsupported multi schema change 的错误。
  • 不支持不同类型的索引 (HASH|BTREE|RTREE|FULLTEXT)。若指定了不同类型的索引，TiDB 会解析并忽略这些索引。
  • 不支持添加/删除主键，除非开启了 alter-primary-key 配置项。
  • 不支持将字段类型修改为其超集，例如不支持从 INTEGER 修改为 VARCHAR，或者从 TIMESTAMP 修改为 DATETIME，否则可能输出的错误信息 Unsupported modify column: type %d not match origin %d。
  • 更改/修改数据类型时，尚未支持“有损更改”，例如不支持从 BIGINT 更改为 INT。
  • 更改/修改 DECIMAL 类型时，不支持更改精度。
  • 更改/修改整数列时，不允许更改 UNSIGNED 属性。
  • TiDB 中，ALGORITHM={INSTANT,INPLACE,COPY} 语法只作为一种指定，并不更改 ALTER 算法，详情参阅 ALTER TABLE。
  • 分区表支持 HASH 和 RANGE 分区类型。对于不支持的分区类型，TiDB 会返回 Warning: Unsupported partition type, treat as normal table。
  • 分区表支持 ADD、DROP、TRUNCATE 操作，其他分区操作会被忽略。TiDB 不支持以下分区表语法：
    • PARTITION BY LIST
    • PARTITION BY KEY
    • SUBPARTITION
    • {CHECK|EXCHANGE|OPTIMIZE|REPAIR|IMPORT|DISCARD|REBUILD|REORGANIZE|COALESCE} PARTITION

ANALYZE TABLE

TiDB 中的信息统计 与 MySQL 中的有所不同：TiDB 中的信息统计会完全重构表的统计数据，语句执行过程较长，但在 MySQL/InnoDB 中，它是一个轻量级语句，执行过程较短。

更多信息统计的差异请参阅 ANALYZE TABLE。

SELECT 的限制

  • 不支持 SELECT ... INTO @变量 语法。
  • 不支持 SELECT ... GROUP BY ... WITH ROLLUP 语法。
  • TiDB 中的 SELECT .. GROUP BY expr 的返回结果与 MySQL 5.7 并不一致。MySQL 5.7 的结果等价于 GROUP BY expr ORDER BY expr。

详情参见 SELECT。

UPDATE 语句

详情参见 UPDATE。

视图

TiDB 中的视图不可更新，不支持 UPDATE、INSERT、DELETE 等写入操作。

存储引擎

  • 仅在语法上兼容创建表时指定存储引擎，实际上 TiDB 会将元信息统一描述为 InnoDB 存储引擎。TiDB 支持类似 MySQL 的存储引擎抽象，但需要在系统启动时通过--store 配置项来指定存储引擎。

SQL 模式

TiDB 支持大部分 SQL 模式。不支持的 SQL 模式如下：

  • 不支持兼容模式，例如：Oracle 和 PostgreSQL（TiDB 解析但会忽略这两个兼容模式），MySQL 5.7 已弃用兼容模式，MySQL 8.0 已移除兼容模式。
  • TiDB 的 ONLY_FULL_GROUP_BY 模式与 MySQL 5.7 相比有细微的语义差别。
  • NO_DIR_IN_CREATE 和 NO_ENGINE_SUBSTITUTION 仅用于解决与 MySQL 的兼容性问题，并不适用于 TiDB。

默认设置

  • 字符集：

    • TiDB 默认：utf8mb4。
    • MySQL 5.7 默认：latin1。
    • MySQL 8.0 默认：utf8mb4。

  • 排序规则：

    • TiDB 中 utf8mb4 字符集默认：utf8mb4_bin。
    • MySQL 5.7 中 utf8mb4 字符集默认：utf8mb4_general_ci。
    • MySQL 8.0 中 utf8mb4 字符集默认：utf8mb4_0900_ai_ci。

  • foreign_key_checks：

    • TiDB 默认：OFF，且仅支持设置该值为 OFF。
    • MySQL 5.7 默认：ON。

  • SQL mode：

    • TiDB 默认：ONLY_FULL_GROUP_BY,STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION。
    • MySQL 5.7 默认 与 TiDB 相同。
    • MySQL 8.0 默认 ONLY_FULL_GROUP_BY,STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION。

  • lower_case_table_names：

    • TiDB 默认：2，且仅支持设置该值为 2。
    • MySQL 默认如下：
      • Linux 系统中该值为 0
      • Windows 系统中该值为 1
      • macOS 系统中该值为 2

  • explicit_defaults_for_timestamp：

    • TiDB 默认：ON，且仅支持设置该值为 ON。
    • MySQL 5.7 默认：OFF。
    • MySQL 8.0 默认：ON。

日期时间处理的区别

时区

  • TiDB 采用系统当前安装的所有时区规则进行计算（一般为 tzdata 包），不需要导入时区表数据就能使用所有时区名称，无法通过导入时区表数据的形式修改计算规则。

  • MySQL 默认使用本地时区，依赖于系统内置的当前的时区规则（例如什么时候开始夏令时等）进行计算；且在未导入时区表数据的情况下不能通过时区名称来指定时区。

零月和零日

  • 与 MySQL 一样，TiDB 默认启用了 NO_ZERO_DATE 和 NO_ZERO_IN_DATE 模式，但是 TiDB 与 MySQL 在处理这两个 SQL 模式有以下不同：
    • TiDB 在非严格模式下启用以上两个 SQL 模式，插入零月/零日/零日期不会给出警告，MySQL 则会给出对应的警告。
    • TiDB 在严格模式下，启用了 NO_ZERO_DATE，仍然能够插入零日期；如果启用了 NO_ZERO_IN_DATE 则无法插入零月/零日日期。MySQL 在严格模式下则都无法插入两种类型的日期。

类型系统

  • 不支持 FLOAT4/FLOAT8。

  • 不支持 SQL_TSI_*（包括 SQL_TSI_MONTH、SQL_TSI_WEEK、SQL_TSI_DAY、SQL_TSI_HOUR、SQL_TSI_MINUTE 和 SQL_TSI_SECOND，但不包括 SQL_TSI_YEAR）。

MySQL 弃用功能导致的不兼容问题

TiDB 不支持 MySQL 中标记为弃用的功能，包括：

  • 指定浮点类型的精度。MySQL 8.0 弃用了此功能，建议改用 DECIMAL 类型。
  • ZEROFILL 属性。 MySQL 8.0 弃用了此功能，建议在业务应用中填充数字值。
下载 PDF