すべてのプロダクト
Search
ドキュメントセンター

Tablestore:DDL 操作

最終更新日:Oct 23, 2026

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 already exists エラーが返されます。

table_name

はい

マッピングテーブル名。この名前はデータテーブル名と一致する必要があります。

column_name

はい

列名。SQL の列名は、データテーブルの列名と一致する必要があります (大文字と小文字は区別されません)。たとえば、データテーブルの列が Aa の場合、Aa、AA、aA、または aa を使用できます。

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

いいえ

実行エンジンの種類。デフォルトは tablestore で、SQL エンジンが自動的にインデックスを選択することを意味します。

consistency

いいえ

クエリ結果の整合性レベル。有効な値は strong (強力な整合性) と eventual (結果整合性、デフォルト) です。strong に設定すると、検索インデックスは結果整合性しか提供しないため、SQL エンジンは検索インデックスを選択しません。

allow_inaccurate_aggregation

いいえ

クエリパフォーマンスと引き換えに集計の精度を許容するかどうか。デフォルトは true です。false に設定すると、SQL エンジンは集計に検索インデックスを選択しません。検索インデックスマッピングテーブルの場合、このパラメーターは true に固定されます。

例

プライマリキー列 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

はい

操作の種類: ADD COLUMN は属性列を追加し、DROP COLUMN は属性列を削除します。

column_name

はい

列名。列を追加する場合、名前は既存の列名と重複してはなりません。列名の大文字小文字のルールは CREATE TABLE と同じです。

data_type

ADD COLUMN のみ

列の SQL データ型。データ型は、データテーブルの対応する列と一致する必要があります。DROP COLUMN には不要です。

例

マッピングテーブルに属性列を追加します。

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

いいえ

指定した場合、マッピングテーブルが存在しない場合でもエラーは返されません。指定しない場合、Unknown mapping table エラーが返されます。

例

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

はい

マッピングテーブル名。FROM と IN は交換可能です。

例

データテーブルマッピングのインデックスを表示します (プライマリキー、セカンダリインデックス、検索インデックスを返します):

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

CREATE TABLE

データテーブルが存在しません。CREATE TABLE は、既存のデータテーブルまたは検索インデックスのマッピングのみを作成します。事前にデータテーブルが作成されていることを確認してください。

Table 'instance.table' already exists

CREATE TABLE

マッピングは既に存在します。このエラーを抑制するには、IF NOT EXISTS を使用します。マッピングを再作成するには、まず DROP MAPPING TABLE を実行します。

Unknown mapping table 'instance.table'

DROP MAPPING TABLE

マッピングが存在しません。このエラーを抑制するには、IF EXISTS を使用します。

Unsupported alter non-mapping table

ALTER TABLE

対象のテーブル用のマッピングテーブルが CREATE TABLE 文で作成されていないため、ALTER TABLE はサポートされていません。