使用说明

使用限制

• 与InnoDB引擎共存时的资源分配限制

  使用X-Engine引擎时，由于95%的内存会提供给X-Engine引擎用做写入缓存和BlockCache以加速读写速度，留给InnoDB Buffer Pool的内存非常少，所以在X-Engine引擎的集群中，请尽量避免使用InnoDB引擎表存储太多数据，否则会因为缓存命中率低而导致性能大幅降低。建议使用PolarDB高压缩引擎（X-Engine）时，所有的表都使用相同的X-Engine引擎，避免引擎混用影响集群性能。

• 引擎功能限制

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

  分类	功能	说明
  SQL功能	外键	不支持
  	临时表	不支持
  	分区表（partition）	不支持（所有与partition相关的创建及增删改查操作均不支持）
  	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事务	即将支持
  锁	锁粒度	支持表级别锁和行级别锁 不支持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）中创建表

• 在现网已购的高压缩引擎（X-Engine）产品系列集群中创建表时，无需指定X-Engine引擎，默认会创建X-Engine引擎的表。语法示例如下：

  CREATE TABLE test_arc.t1 (id int PRIMARY KEY,c1 varchar(10));

  表创建成功后，后续使用方法与InnoDB一样，数据会存储在X-Engine引擎上。

  说明

  • 高压缩引擎（X-Engine）产品系列的集群中同时也支持创建InnoDB表，例如使用DTS迁移数据时，可能会出现迁移的表引擎仍然为InnoDB。若需要将其转换为X-Engine表，请参见InnoDB引擎转换为X-Engine引擎。

  • 您可以通过如下命令查看当前数据库的默认引擎：

    show variables like '%default_storage_engine%';

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

  create table t1(c1 int primary key , c2 int) ENGINE=xengine;

参数说明