使用说明

使用限制

• 引擎功能限制

  X-Engine引擎在功能上有如下限制。

  分类	功能	说明
  SQL功能	外键	不支持
  	临时表	不支持
  	Generated Column	不支持
  	Handler API	不支持
  列属性	最大列长度 （longblob/longtext/json）	32 MB
  	GIS地理数据类型	不支持所有GIS相关数据类型（包含geometry、point、linestring、polygon、multipoint、multilinestring、multipolygon、geometrycollection）
  索引	哈希索引	不支持
  	空间索引	不支持（所有与全文索引相关的创建、使用均不支持）
  事务	事务隔离级别	支持如下2个隔离级别： 读已提交（RC） 可重复读（RR）
  	单个事务支持的最大数据量	32 MB
  	Savepoint	不支持
  	XA事务	支持内部XA事务
  锁	锁粒度	支持表级别锁和行级别锁 不支持GAP锁
  	Skip Locked	不支持
  	Lock Nowait	不支持
  字符集	非索引列支持的字符集	非索引列支持所有的字符集（校对规则）
  	索引列支持的字符集	latin1（latin1_bin） gbk（gbk_chinese_ci、gbk_bin） utf8（utf8_general_ci、utf8_bin） utf8mb4（utf8mb4_0900_ai_ci、utf8mb4_general_ci、utf8mb4_bin）
  主从复制	Binlog格式	支持如下3种格式： stmt row mixed 说明 默认为row，采用stmt/mixed在特定并发场景可能存在数据安全性问题。

  说明

  对于X-Engine引擎中其他未列出的功能，默认其功能特性与InnoDB引擎相同。

• 大事务功能限制

  X-Engine目前不支持大事务。当一个事务修改的行数等于或大于10000行时，X-Engine会启用commit in middle功能，即X-Engine会在内部提交该事务，并重新开启一个子事务继续执行该事务。但commit in middle并不能遵循严格意义上的事务原子性（Atomicity），因此您在使用过程中需要注意如下几点：

  • 假设需要开启一个事务插入大量数据，但在数据插入过程中，由于commit in middle功能，已经先提交了一部分数据，其它请求就可以访问到插入的数据。

  • 假设需要开启一个事务修改大量数据，已经执行了commit in middle的事务将无法回滚。

    DROP TABLE t1;
    CREATE TABLE t1(c1 int primary key , c2 int)ENGINE=xengine;
    BEGIN;
    call insert_data(12000); //插入12000行数据，触发commit in middle，前10000行数据已经提交。
    rollback;// 回滚只能把最后2000条数据回滚。
    SELECT COUNT(*) FROM t1; // 这里仍然能够查询到10000条数据。
    +----------+
    | COUNT(*) |
    +----------+
    |    10000 |
    +----------+
    1 row in set (0.00 sec)

  • 假设开启一个需要修改且删除大量数据的事务，由于commit in middle功能，DELETE操作读不到本事务中新插入的行，导致新插入的数据未被DELETE。

    DROP TABLE t1;
    CREATE TABLE t1(c1 int primary key , c2 int)ENGINE=xengine;
    call insert_data(10000);
    BEGIN;
    INSERT INTO t1 VALUES(10001,10001), (10002,10002);
    DELETE FROM t1 WHERE c1 >= 0;// DELETE操作触发commit in middle，导致delete操作没有读到本事务插入的行。
    commit;
    SELECT * FROM t1;
    +-------+-------+
    | c1    | c2    |
    +-------+-------+
    | 10001 | 10001 |
    | 10002 | 10002 |
    +-------+-------+
    2 rows in set (0.00 sec)

将InnoDB引擎下的表转存至高压缩引擎（X-Engine）

1. 使用DMS、客户端或命令行连接数据库，具体操作请参见连接数据库集群。

2. 执行以下命令，将InnoDB引擎下的表转存至X-Engine引擎。

   ALTER TABLE <数据库名>.<表名> ENGINE xengine;

   说明

   使用ALTER命令将InnoDB引擎下的表转存至X-Engine引擎的过程中，会阻塞转换涉及的表的写入操作（DML和DDL）。

在高压缩引擎（X-Engine）中创建表

在双引擎（InnoDB和X-Engine）集群中创建位于X-Engine引擎的表，您需要在创建表时指定X-Engine引擎。语法示例如下：

CREATE TABLE t1(c1 int primary key , c2 int) ENGINE=xengine;

参数说明