Tablestore の DDL 操作は、既存のデータテーブルまたは検索インデックスに対して SQL マッピングを作成し、マッピングテーブルのスキーマとメタデータを管理します。
DDL 文の概要
|
文 |
エンジン |
説明 |
|
CREATE TABLE |
tablestore |
データテーブルのマッピングを作成します。SQL エンジンは、クエリに最適なインデックスを自動的に選択します。 |
|
CREATE TABLE |
searchindex |
検索インデックスのマッピングを作成します。SQL エンジンは、指定された検索インデックスを使用してクエリを実行します。 |
|
ALTER TABLE |
- |
既存のマッピングテーブルの属性列を追加または削除します。 |
|
DROP MAPPING TABLE |
- |
基になるデータテーブルやインデックスに影響を与えることなく、マッピングを削除します。 |
|
DESCRIBE |
- |
マッピングテーブルのフィールド名、データ型、プライマリキーフラグ、および NULL 値の許容有無を返します。 |
|
SHOW INDEX |
- |
マッピングテーブルに関連付けられているインデックス情報 (プライマリキー、セカンダリインデックス、検索インデックスを含む) を返します。 |
|
SHOW TABLES |
- |
現在のインスタンス内のすべてのマッピングテーブルを一覧表示します。 |
従来のリレーショナルデータベースとは異なり、Tablestore の CREATE TABLE は物理テーブルを作成しません。代わりに、既存のデータテーブルまたは検索インデックスに対する SQL アクセスマッピングを作成します。DROP MAPPING TABLE はマッピングのみを削除し、基になるデータはそのまま残ります。
データテーブルマッピングの作成
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}';
パラメーター
|
パラメーター |
必須 |
説明 |
|
IF NOT EXISTS |
いいえ |
指定した場合、マッピングテーブルが既に存在していてもエラーは返されません。指定しない場合、 |
|
table_name |
はい |
マッピングテーブル名。この名前はデータテーブル名と一致する必要があります。 |
|
column_name |
はい |
列名。SQL の列名は、データテーブルの列名と一致する必要があります (大文字と小文字は区別されません)。たとえば、データテーブルの列が |
|
data_type |
はい |
列の SQL データ型。データ型は、データテーブルの列のデータ型と一致する必要があります。プライマリキー列は BIGINT、VARCHAR(1024)、VARBINARY(1024) のみをサポートします。属性列は、DOUBLE、BOOL、MEDIUMTEXT、MEDIUMBLOB もサポートします。すべての型マッピングについては、「SQL のデータ型マッピング」をご参照ください。 |
|
NOT NULL | NULL |
いいえ |
列が NULL 値を許可するかどうか。プライマリキー列のデフォルトは NOT NULL です。属性列のデフォルトは NULL です。値が必須の属性列には NOT NULL を指定します。 |
|
PRIMARY KEY |
はい |
プライマリキー定義。プライマリキーは、順序と型がデータテーブルのプライマリキー列と一致する必要があります。 |
|
ENGINE |
いいえ |
実行エンジンの種類。デフォルトは |
|
consistency |
いいえ |
クエリ結果の整合性レベル。有効な値は |
|
allow_inaccurate_aggregation |
いいえ |
クエリパフォーマンスと引き換えに集計の精度を許容するかどうか。デフォルトは |
例
プライマリキー列 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, 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}';
パラメーター
|
パラメーター |
必須 |
説明 |
|
IF NOT EXISTS |
いいえ |
指定した場合、マッピングテーブルが既に存在していてもエラーは返されません。 |
|
user_defined_name |
はい |
カスタムマッピングテーブル名。名前はデータテーブルまたはインデックス名と一致する必要はありません。 |
|
column_name |
はい |
列名。プライマリキー定義は不要です。検索インデックスマッピングテーブルは VARCHAR 型をサポートしていません。文字列型の列には MEDIUMTEXT を使用してください。 |
|
index_name |
はい |
検索インデックス名。ENGINE_ATTRIBUTE で指定します。インデックスは既に存在している必要があります。 |
|
table_name |
はい |
検索インデックスが属するデータテーブル名。ENGINE_ATTRIBUTE で指定します。 |
例
データテーブル 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 文は、既存のマッピングテーブルの属性列を追加または削除します。
-
まず
CREATE TABLE文を実行してデータテーブル用のマッピングテーブルを作成し、次にALTER TABLE文を使用して属性列を更新します。 -
各文は 1 つの列を追加または削除します。複数の列を変更するには、文を複数回実行します。
-
ALTER TABLEはマッピングテーブルのスキーマのみを更新し、データテーブルのストレージ構造には影響しません。 -
プライマリキー列は追加または削除できません。
-
この文を実行した後、SQL エンジンは非同期でリフレッシュし、完了までに最大 30 秒かかります。リフレッシュ中のクエリは、新しい列を返さない場合があります。
構文
ALTER TABLE table_name option column_name [data_type];
パラメーター
|
パラメーター |
必須 |
説明 |
|
table_name |
はい |
マッピングテーブル名。 |
|
option |
はい |
操作の種類: |
|
column_name |
はい |
列名。列を追加する場合、名前は既存の列名と重複してはなりません。列名の大文字小文字のルールは |
|
data_type |
|
列の SQL データ型。データ型は、データテーブルの対応する列と一致する必要があります。 |
例
マッピングテーブルに属性列を追加します。
ALTER TABLE exampletable ADD COLUMN col_a BOOL;
ALTER TABLE exampletable ADD COLUMN col_b DOUBLE;
マッピングテーブルから属性列を削除します。
ALTER TABLE exampletable DROP COLUMN content;
マッピングの削除
DROP MAPPING TABLE 文は、1 つ以上のマッピングテーブルを削除します。
この文は SQL マッピングのみを削除します。基になるデータテーブルとそのデータは影響を受けません。
構文
DROP MAPPING TABLE [IF EXISTS] table_name, ...;
パラメーター
|
パラメーター |
必須 |
説明 |
|
table_name |
はい |
マッピングテーブル名。複数のテーブル名はコンマ (,) で区切ります。 |
|
IF EXISTS |
いいえ |
指定した場合、マッピングテーブルが存在しない場合でもエラーは返されません。指定しない場合、 |
例
DROP MAPPING TABLE IF EXISTS exampletable;
テーブル詳細の表示
DESCRIBE 文は、マッピングテーブルのフィールド名、データ型、NULL値の許容有無、およびプライマリキーフラグを返します。
構文
DESCRIBE table_name;
パラメーター
|
パラメーター |
必須 |
説明 |
|
table_name |
はい |
マッピングテーブル名。 |
例
exampletable マッピングテーブルの詳細を表示します。
DESCRIBE exampletable;
出力には次の列が含まれます。
|
列 |
例 |
説明 |
|
Field |
pk1 |
フィールド名。 |
|
Type |
varchar(1024) |
フィールドの SQL データ型。 |
|
Null |
NO |
フィールドが NULL 値を許可するかどうか。プライマリキー列の場合は NO。属性列の場合は YES。 |
|
Key |
PRI |
プライマリキーフラグ。PRI はプライマリキー列を示します。空の値は属性列を示します。 |
インデックス詳細の表示
SHOW INDEX 文は、プライマリキー、セカンダリインデックス、検索インデックスなど、マッピングテーブルに関連付けられているインデックスを返します。
構文
SHOW INDEX {FROM | IN} table_name;
パラメーター
|
パラメーター |
必須 |
説明 |
|
table_name |
はい |
マッピングテーブル名。 |
例
データテーブルマッピングのインデックスを表示します (プライマリキー、セカンダリインデックス、検索インデックスを返します):
SHOW INDEX IN exampletable;
Index_type 列はインデックスの種類を示します。プライマリキーインデックスの場合は空の値、セカンダリインデックスの場合は GlobalIndex、検索インデックスの場合は SearchIndex です。
検索インデックスマッピングのインデックスを表示します:
SHOW INDEX IN search_exampletable1;
検索インデックスマッピングテーブルの場合、SHOW INDEX はプライマリキーインデックスとして _system_hidden_pk_field (システムが生成した隠しプライマリキー) を返します。各列には、LONG、KEYWORD、TEXT などの Search_type の値も表示されます。
マッピングテーブルの表示
SHOW TABLES は、現在のインスタンス内のすべてのマッピングテーブルを一覧表示します。
構文
SHOW TABLES;
出力例:
+------------------------+
| Tables_in_myinstance |
+------------------------+
| exampletable |
+------------------------+
| search_exampletable1 |
+------------------------+
一般的なエラー
DDL 文が失敗した場合、次のエラーが発生することがあります。
|
エラーメッセージ |
文 |
原因と解決策 |
|
Table 'instance.table' doesn't exist |
|
データテーブルが存在しません。 |
|
Table 'instance.table' already exists |
|
マッピングは既に存在します。このエラーを抑制するには、 |
|
Unknown mapping table 'instance.table' |
|
マッピングが存在しません。このエラーを抑制するには、 |
|
Unsupported alter non-mapping table |
|
対象のテーブル用のマッピングテーブルが |