DDL 操作

DDL 语句概览

创建数据表映射关系

执行 CREATE TABLE 语句，使用 ENGINE='tablestore' 为已有数据表创建映射关系。创建后，SQL 引擎自动选择合适的索引（数据表主键、二级索引或多元索引）执行查询。

语法

CREATE TABLE [IF NOT EXISTS] table_name(
  column_name data_type [NOT NULL | NULL], ...
  PRIMARY KEY(key_part [, key_part])
)
ENGINE='tablestore',
ENGINE_ATTRIBUTE='{"consistency": consistency [,"allow_inaccurate_aggregation": allow_inaccurate_aggregation]}';

当表只有一个主键时，也可以将 PRIMARY KEY 直接标注在列定义上：

CREATE TABLE [IF NOT EXISTS] table_name(
  column_name data_type PRIMARY KEY,
  column_name data_type [NOT NULL | NULL], ...
)
ENGINE='tablestore',
ENGINE_ATTRIBUTE='{"consistency": consistency}';

参数

示例

为 exampletable 创建映射关系，包含主键列 colvalue（VARCHAR）和 id（BIGINT），以及属性列 content（MEDIUMTEXT）：

CREATE TABLE exampletable(colvalue VARCHAR(1024), id BIGINT, content MEDIUMTEXT, PRIMARY KEY(colvalue, id)) ENGINE='tablestore';

创建强一致性查询的映射关系：

CREATE TABLE exampletable2(id BIGINT(20), colvalue VARCHAR(1024), content MEDIUMTEXT, PRIMARY KEY(colvalue, id)) ENGINE_ATTRIBUTE='{"consistency": "strong"}';

创建多元索引映射关系

执行 CREATE TABLE 语句，使用 ENGINE='searchindex' 为已有多元索引创建映射关系。创建后，SQL 引擎通过指定的多元索引执行查询。

适用场景

• 需要使用多元索引的特有查询能力（如全文检索、向量检索、嵌套类型查询等）。

• 需要固定查询路由，确保每次查询都使用指定的多元索引，而非由 SQL 引擎自动选择。

语法

CREATE TABLE [IF NOT EXISTS] user_defined_name(
  column_name data_type [, column_name data_type]
)
ENGINE='searchindex',
ENGINE_ATTRIBUTE='{"index_name": index_name, "table_name": table_name}';

参数

示例

为 exampletable1 数据表的多元索引 exampletable1_index 创建映射表 search_exampletable1：

CREATE TABLE search_exampletable1(id BIGINT, colvalue MEDIUMTEXT, content MEDIUMTEXT) ENGINE='searchindex' ENGINE_ATTRIBUTE='{"index_name": "exampletable1_index", "table_name": "exampletable1"}';

使用 IF NOT EXISTS 避免重复创建报错：

CREATE TABLE IF NOT EXISTS search_exampletable1(id BIGINT, colvalue MEDIUMTEXT, content MEDIUMTEXT) ENGINE='searchindex' ENGINE_ATTRIBUTE='{"index_name": "exampletable1_index", "table_name": "exampletable1"}';

更新映射表属性列

执行 ALTER TABLE 语句为已有映射表添加或删除属性列。

语法

ALTER TABLE table_name option column_name [data_type];

参数

示例

为映射表添加属性列：

ALTER TABLE exampletable ADD COLUMN colvalue BIGINT;
ALTER TABLE exampletable ADD COLUMN content MEDIUMTEXT;

删除映射表的属性列：

ALTER TABLE exampletable DROP COLUMN colvalue;

删除映射关系

执行 DROP MAPPING TABLE 语句删除映射关系。支持同时删除多个映射关系。

语法

DROP MAPPING TABLE [IF EXISTS] table_name, ...;

参数

示例

DROP MAPPING TABLE IF EXISTS exampletable;

查询表的描述信息

执行 DESCRIBE 语句查询映射表的字段名称、字段类型、是否可为空、是否为主键等描述信息。

语法

DESCRIBE table_name;

参数

示例

查询 exampletable 映射表的描述信息：

DESCRIBE exampletable;

返回结果包含以下列：

查询索引描述信息

执行 SHOW INDEX 语句查询映射表关联的索引信息，包括主键索引、二级索引和多元索引。

语法

SHOW INDEX {FROM | IN} table_name;

参数

示例

查询数据表映射关系的索引信息（返回主键、二级索引、多元索引）：

SHOW INDEX IN exampletable;

返回结果中，Index_type 列标识索引类型：空值为主键索引，GlobalIndex 为二级索引，SearchIndex 为多元索引。

查询多元索引映射关系的索引信息：

SHOW INDEX IN search_exampletable1;

多元索引映射表的 SHOW INDEX 结果中，主键索引对应 _system_hidden_pk_field（系统隐藏主键），各列额外显示 Search_type（如 LONG、KEYWORD、TEXT）。

列出映射表

执行 SHOW TABLES 语句列出当前实例中所有映射表的名称。

语法

SHOW TABLES;

返回结果示例：

+------------------------+
| Tables_in_myinstance   |
+------------------------+
| exampletable           |
+------------------------+
| search_exampletable1   |
+------------------------+

常见错误