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

Tablestore:SQLによるデータクエリ

最終更新日:Aug 07, 2026

Tablestore SDK for Python は、SELECT 文を実行してマッピングテーブルからデータをクエリします。

前提条件

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

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

  • アクセスするデータテーブルに対して、マッピングテーブルを作成しておきます。

説明

exe_sql_query メソッドを呼び出してSELECT 文を実行し、マッピングテーブルからデータをクエリします。

def exe_sql_query(self, query)

次の例では、example_table からプライマリキーがrow1 の行をクエリします。

query = (
    "SELECT pk, long_value, double_value, string_value, bool_value "
    "FROM example_table WHERE pk = 'row1' LIMIT 20"
)
row_list, table_capacity_units, search_capacity_units = client.exe_sql_query(query)

for row in row_list:
    print(dict(row.attribute_columns))

パラメーター

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

名前

説明

query (必須)

文字列

実行するSELECT 文。 この文では、マッピングテーブル、返す列、クエリ条件、および行数制限を指定します。

レスポンス

exe_sql_query メソッドは、次の要素を含むタプルを返します。

要素

説明

row_list

List[Row]

結果行のリスト。 各Row オブジェクトのattribute_columns 属性には、列名と値が含まれます。

table_capacity_units

List[Tuple]

データテーブルが消費した読み取りおよび書き込み CapacityUnit。 各タプルには、テーブル名とCapacityUnit オブジェクトが含まれます。

search_capacity_units

List[Tuple]

検索インデックスが消費した読み取りおよび書き込み CapacityUnit。 各タプルには、検索インデックス名とCapacityUnit オブジェクトが含まれます。