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]}';

プライマリキー列が 1 つのテーブルの場合は、列定義で 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}';

パラメーター

例

プライマリキー列 colvalue (VARCHAR) と id (BIGINT)、および属性列 content (MEDIUMTEXT) を持つ exampletable のマッピングを作成します。

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 new_col1 BIGINT;
ALTER TABLE exampletable ADD COLUMN new_col2 MEDIUMTEXT;

マッピングテーブルから属性列を削除します。

ALTER TABLE exampletable DROP COLUMN content;

マッピングの削除

DROP MAPPING TABLE ステートメントは、一度に 1 つ以上のマッピングを削除します。

構文

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

パラメーター

例

DROP MAPPING TABLE IF EXISTS exampletable;

テーブル詳細の表示

DESCRIBE ステートメントは、マッピングテーブルのフィールド名、データ型、NULL 許容性、プライマリキーフラグを返します。

構文

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

一般的なエラー

DDL ステートメントが失敗すると、SQL エンジンは次のエラーを返します。原因となったステートメントとメッセージを使用して問題を特定してください。