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

Tablestore:マッピングテーブルの作成

最終更新日:Oct 23, 2026

Tablestore SDK for Python を使用して、既存のデータテーブルまたは検索インデックス用のマッピングテーブルを作成し、データへの SQL アクセスを有効にできます。

前提条件

  • Tablestore SDK for Python をインストールし、クライアントを初期化します。

  • SQL クエリにはバージョン 5.4.2 以降が必要です。最新バージョンの使用を推奨します。

説明

Tablestore は、データテーブルの SQL マッピングテーブルを自動作成しません。SQL を使用してデータテーブルにアクセスするには、先に CREATE TABLE ステートメントを実行してマッピングテーブルを作成する必要があります。exe_sql_query メソッドを呼び出して CREATE TABLE ステートメントを実行し、既存のデータテーブルまたは検索インデックス用のマッピングテーブルを作成します。

def exe_sql_query(self, query)

データテーブルの場合、マッピングテーブルはデータテーブルと同じ名前である必要があります。フィールド名は大文字と小文字を区別せず、フィールド型はデータテーブルのフィールド型に対応している必要があります。検索インデックスの場合は、マッピングテーブル名をカスタマイズでき、ENGINE と ENGINE_ATTRIBUTE を使用してデータテーブルと検索インデックスを指定できます。

CREATE TABLE ステートメントの構文、フィールド型、パラメーターについては、DDL operations をご参照ください。

次の例は、example_table データテーブル用のマッピングテーブルを作成します。

query = """
CREATE TABLE example_table (
    pk VARCHAR(1024), long_value BIGINT, double_value DOUBLE,
    string_value MEDIUMTEXT, bool_value BOOL, PRIMARY KEY(pk)
)
"""
client.exe_sql_query(query)

パラメーター

exe_sql_query メソッドには、次のパラメーターが含まれます。

名前

タイプ

説明

query (必須)

String

実行する CREATE TABLE ステートメントで、マッピングテーブル名、フィールド、プライマリキー、クエリエンジンを定義します。データテーブルのマッピングと検索インデックスのマッピングでは、構文が異なります。

シナリオ例

検索インデックス用マッピングテーブルの作成

ENGINE を searchindex に設定し、ENGINE_ATTRIBUTE でデータテーブルと検索インデックスを指定します。次の例では、example_table データテーブルの example_index 検索インデックスに対し、example_search_table マッピングテーブルを作成します。

query = """
CREATE TABLE example_search_table (
    pk MEDIUMTEXT, long_value BIGINT, string_value MEDIUMTEXT
) ENGINE='searchindex'
ENGINE_ATTRIBUTE='{"index_name":"example_index","table_name":"example_table"}'
"""
client.exe_sql_query(query)

よくある質問

Table 'instance.table' doesn't exist エラーが返される

原因:指定したデータテーブルまたは検索インデックスが存在しません。CREATE TABLE ステートメントはマッピングテーブルのみを作成します。

解決策:名前を確認し、データテーブルまたは検索インデックスが存在することを確認してから、ステートメントを再実行してください。

Table 'instance.table' already exists エラーが返される

原因:マッピングテーブルがすでに存在します。これは CREATE TABLE ステートメントで作成されました。

解決策:重複作成エラーを防ぐには、IF NOT EXISTS を使用してください。マッピングテーブルのスキーマを変更するには、まず DESCRIBE ステートメントを実行してスキーマを確認し、その後 ALTER TABLE ステートメントを使用してマッピングテーブルを変更してください。