文档中心

云数据库 TiDB 版

产品简介

与 MySQL 兼容性

TiDB 高度兼容 MySQL 协议，以及 MySQL 5.7 和 MySQL 8.0 的常用特性和语法。MySQL 的生态工具（PHPMyAdmin、Navicat、MySQL Workbench、DBeaver以及更多）和 MySQL 客户端均可用于 TiDB。由于一些特性已有更适合 TiDB 架构的替代实现方式，另一些特性的使用场景有限、实现与维护成本较高，因此 TiDB 当前暂不支持部分 MySQL 特性。

不支持的特性

存储过程和函数

触发器

事件

用户自定义函数

FULLTEXT 语法和索引 #1793

SPATIAL（也称为 GIS/GEOMETRY）函数、数据类型和索引 #6347

除 ascii、latin1、binary、utf8、utf8mb4 和 gbk 之外的字符集

优化器追踪

XML 函数

X-Protocol #1109

XA 语法（TiDB 内部使用两阶段提交，但未通过 SQL 接口暴露）

CREATE TABLE tblName AS SELECT stmt 语法 #4754

CHECK TABLE 语法 #4673

CHECKSUM TABLE 语法 #1895

REPAIR TABLE 语法

OPTIMIZE TABLE 语法

HANDLER 语句

CREATE TABLESPACE 语句

"Session Tracker: Add GTIDs context to the OK packet"

降序索引 #2519

SKIP LOCKED 语法 #18207

Lateral 派生表 #40328

JOIN ON 子查询 #11414

与 MySQL 的差异

自增 ID

在 TiDB 中，自增列的值（ID）在单个 TiDB 集群内是全局唯一且递增的。若需在多个 TiDB 集群间实现递增，可以使用 AUTO_INCREMENT MySQL 兼容模式。但分配的 ID 不一定严格连续，因此建议避免混用默认值和自定义值，以防出现 Duplicated Error 错误。

你可以通过 tidb_allow_remove_auto_inc 系统变量来允许或禁止移除 AUTO_INCREMENT 列属性。移除列属性时，可使用 ALTER TABLE MODIFY 或 ALTER TABLE CHANGE 语法。

TiDB 不支持新增 AUTO_INCREMENT 列属性，且一旦移除后无法恢复。更多细节参见 AUTO_INCREMENT。

说明

如果在建表时未指定主键，TiDB 会使用 _tidb_rowid 作为行标识。该值的分配与自增列（如存在）共用一个分配器。如果指定自增列为主键，TiDB 会使用该列作为行标识。在这种情况下，可能会出现如下情况：

如上所示，由于共用分配器，id 每次递增 2。该行为在 MySQL 兼容模式下会发生变化，此时不再共用分配器，因此不会跳号。

性能模式（Performance schema）

您可以在云数据 TiDB 版控制台的集群概览页面查看性能指标。在 TiDB 中，大多数 performance schema 表返回空结果。

查询执行计划

TiDB 中查询执行计划（EXPLAIN/EXPLAIN FOR）的输出格式、内容和权限设置与 MySQL 有较大差异。

在 TiDB 中，MySQL 系统变量 optimizer_switch 为只读，对查询计划无影响。虽然优化器 Hint 语法与 MySQL 类似，但可用的 Hint 及其实现可能不同。

更多信息参见理解查询执行计划。

内置函数

TiDB 支持大多数 MySQL 的内置函数，但并非全部。你可以使用 SHOW BUILTINS 语句获取可用函数列表。

DDL 操作

在 TiDB 中，所有支持的 DDL 变更均可在线完成。但与 MySQL 相比，TiDB 在 DDL 操作上有以下主要限制：

使用单条 ALTER TABLE 语句修改同一张表的多个 schema 对象（如列或索引）时，不支持对同一对象进行多次变更。例如，执行 ALTER TABLE t1 MODIFY COLUMN c1 INT, DROP COLUMN c1 会报错 Unsupported operate same column/index。

不支持通过单条 ALTER TABLE 语句同时修改多个 TiDB 特有的 schema 对象，如 TIFLASH REPLICA、SHARD_ROW_ID_BITS 和 AUTO_ID_CACHE。

TiDB 不支持通过 ALTER TABLE 修改某些数据类型。例如，不支持将 DECIMAL 类型修改为 DATE 类型。若不支持的数据类型变更，TiDB 会报错 Unsupported modify column: type %d not match origin %d。详情参见 ALTER TABLE。

ALGORITHM={INSTANT,INPLACE,COPY} 语法在 TiDB 中仅作为断言存在，不会改变 ALTER 算法。详见 ALTER TABLE。

不支持对 CLUSTERED 类型的主键进行添加/删除。关于 CLUSTERED 类型主键的更多信息，参见聚簇索引。

不支持不同类型的索引（HASH|BTREE|RTREE|FULLTEXT），指定时会被解析并忽略。

TiDB 支持 HASH、RANGE、LIST 和 KEY 分区类型。对于不支持的分区类型，TiDB 返回 Warning: Unsupported partition type %s, treat as normal table，其中 %s 为具体不支持的分区类型。

Range、Range COLUMNS、List 和 List COLUMNS 分区表支持 ADD、DROP、TRUNCATE 和 REORGANIZE 操作。其他分区操作会被忽略。

Hash 和 Key 分区表支持 ADD、COALESCE 和 TRUNCATE 操作。其他分区操作会被忽略。

分区表不支持以下语法，更多分区相关内容，参见分区表。

SUBPARTITION

{CHECK|OPTIMIZE|REPAIR|IMPORT|DISCARD|REBUILD} PARTITION

表分析

在 TiDB 中，统计信息收集与 MySQL 不同，会完全重建表的统计信息，因此资源消耗更大，耗时更长。而 MySQL/InnoDB 执行的是相对轻量、耗时较短的操作。

更多信息参见 ANALYZE TABLE。

SELECT 语法限制

TiDB 不支持以下 SELECT 语法：

SELECT ... INTO @variable

SELECT .. GROUP BY expr 不像 MySQL 5.7 那样隐式等同于 GROUP BY expr ORDER BY expr。

更多细节参见 SELECT 语句参考。

UPDATE 语句

参见 UPDATE 语句参考。

视图

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

临时表

更多信息参见 TiDB 本地临时表与 MySQL 临时表的兼容性。

字符集与排序规则

了解 TiDB 支持的字符集与排序规则，参见字符集与排序规则概述。

关于 GBK 字符集的 MySQL 兼容性，参见 GBK 兼容性。

TiDB 继承表中使用的字符集作为国家字符集。

存储引擎

TiDB 支持使用不同的存储引擎创建表。尽管如此，TiDB 描述的元数据仍为 InnoDB 存储引擎，以保证兼容性。

SQL 模式

TiDB 支持大多数 SQL 模式：

兼容性模式，如 Oracle 和 PostgreSQL，会被解析但被忽略。兼容性模式在 MySQL 5.7 中已废弃，在 MySQL 8.0 中已移除。

ONLY_FULL_GROUP_BY 模式与 MySQL 5.7 存在语义差异。

MySQL 的 NO_DIR_IN_CREATE 和 NO_ENGINE_SUBSTITUTION SQL 模式为兼容性而接受，但在 TiDB 中无实际作用。

默认差异

TiDB 与 MySQL 5.7 和 MySQL 8.0 的默认值存在如下差异：

默认字符集：

TiDB 默认值为 utf8mb4。

MySQL 5.7 默认值为 latin1。

MySQL 8.0 默认值为 utf8mb4。

默认排序规则：

TiDB 默认排序规则为 utf8mb4_bin。

MySQL 5.7 默认排序规则为 utf8mb4_general_ci。

MySQL 8.0 默认排序规则为 utf8mb4_0900_ai_ci。

默认 SQL 模式：

TiDB 默认 SQL 模式包含：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 默认 SQL 模式：

MySQL 5.7 的默认 SQL 模式与 TiDB 相同。

MySQL 8.0 的默认 SQL 模式包含：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，表示表名和数据库名在磁盘上按 CREATE TABLE 或 CREATE DATABASE 语句指定的大小写存储，名称比较区分大小写。

Windows 上为 1，表示表名在磁盘上以小写存储，名称比较不区分大小写。MySQL 在存储和查找时会将所有表名转换为小写。该行为同样适用于数据库名和表别名。

macOS 上为 2，表示表名和数据库名在磁盘上按 CREATE TABLE 或 CREATE DATABASE 语句指定的大小写存储，但 MySQL 在查找时会将其转换为小写，名称比较不区分大小写。

explicit_defaults_for_timestamp 的默认值：

TiDB 的默认值为 ON，且目前仅支持 ON。

MySQL 的默认值如下：

MySQL 5.7：OFF。

MySQL 8.0：ON。

日期与时间

TiDB 支持命名时区，具体说明如下：

TiDB 使用系统当前安装的所有时区规则（通常为 tzdata 包）进行计算，因此可以直接使用所有时区名称，无需导入时区表数据。导入时区表数据不会改变计算规则。

目前，MySQL 默认使用本地时区，然后依赖系统内置的当前时区规则（例如夏令时开始时）进行计算。若未导入时区表数据，MySQL 无法通过名称指定时区。

类型系统差异

以下列类型为 MySQL 支持但 TiDB 不支持：

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

正则表达式

关于 TiDB 正则表达式与 MySQL 的兼容性，包括 REGEXP_INSTR()、REGEXP_LIKE()、REGEXP_REPLACE() 和 REGEXP_SUBSTR()，参见正则表达式与 MySQL 的兼容性。

由于废弃特性导致的不兼容

TiDB 未实现 MySQL 中已废弃的部分特性，包括：

浮点类型指定精度。MySQL 8.0 已废弃该特性，推荐使用 DECIMAL 类型。

ZEROFILL 属性。MySQL 8.0 已废弃该特性，推荐在应用层对数值进行补零。

CREATE RESOURCE GROUP、DROP RESOURCE GROUP 和 ALTER RESOURCE GROUP 语句

以下用于创建、修改和删除资源组的语句，其支持的参数与 MySQL 不同。详情参见以下文档：

CREATE RESOURCE GROUP

DROP RESOURCE GROUP

ALTER RESOURCE GROUP

TiDB 与 MySQL InnoDB 悲观事务（锁）的差异

关于 TiDB 与 MySQL InnoDB 在悲观事务（锁）方面的差异，参见与 MySQL InnoDB 的差异。

重要提醒

该文档部分内容附带平凯云平台链接，以下简称为外链。若遇到以下分类对应的外链时，请参考以下说明。现将外链文档划分为不同类型，并明确各类文档可作为参考依据的范围：

分类	说明
操作类	外链中所涉及的创建集群、连接集群等操作，请参考云数据库 TiDB 版的相应内容：创建集群连接集群 ……
参考类	外链涉及平凯云 SQL 参考目录下的文档可作为参考。外链涉及平凯云 SQL 调优目录下的文档部分可作为参考。
Dashboard	云数据库 TiDB 版暂未提供 Dashboard。参考链接中涉及 Dashboard 相关的内容，暂不能作为有效参考。

最近更新时间：2026.08.05 14:41:55

这个页面对您有帮助吗？

有用

无用