Tablestore：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   |
+------------------------+

常見錯誤