全部產品
Search
文件中心

Tablestore:通過 SQL 查詢資料

更新時間:Aug 07, 2026

通過 Python SDK 執行 SELECT 語句,查詢映射表中的資料。

前提條件

功能說明

調用 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(必選)

String

要執行的 SELECT 語句,用於指定映射表、返回列、查詢條件和返回行數等。

傳回值

exe_sql_query 方法返回一個三元組,包含以下元素。

元素

類型

說明

row_list

List[Row]

查詢結果行列表。每個 Row 對象的 attribute_columns 屬性包含列名和值。

table_capacity_units

List[Tuple]

各資料表消耗的讀寫 CU。每個元組包含資料表名稱和 CapacityUnit 對象。

search_capacity_units

List[Tuple]

各多元索引消耗的讀寫 CU。每個元組包含多元索引名稱和 CapacityUnit 對象。