Python SDK擷取總行數或隨機返回資料 -

全匹配查詢（MatchAllQuery）可以匹配所有行，常用於查詢表中資料總行數，或者隨機返回幾條資料。

前提條件

已初始化OTSClient。具體操作，請參見初始化OTSClient。
已建立資料表並寫入資料。具體操作，請參見建立資料表和寫入資料。
已在資料表上建立多元索引。具體操作，請參見建立多元索引。

參數

參數	描述
query	設定查詢類型為MatchAllQuery。
table_name	資料表名稱。
index_name	多元索引名稱。
limit	本次查詢需要返回的最大數量。如果只為了擷取行數，無需擷取具體資料，可以設定limit=0，即不返回任意一行資料。
get_total_count	是否返回匹配的總行數，預設為false，表示不返回。返回匹配的總行數會影響查詢效能。
columns_to_get	是否返回所有列。當設定return_type為ColumnReturnType.SPECIFIED時，可以通過column_names指定返回的列。當設定return_type為ColumnReturnType.ALL時，表示返回所有列。當設定return_type為ColumnReturnType.NONE時，表示不返回所有列，只返回主鍵列。

樣本

以下樣本用於查詢表中資料的總行數。

5.2.1及之後版本

使用5.2.1及之後的SDK版本時，預設的返回結果為SearchResponse對象，請求樣本如下：

query=MatchAllQuery()
all_rows=[]
next_token=None
first_page=True

while first_page or next_token:
    search_response=client.search(table_name, index_name,
        SearchQuery(query,next_token=next_token,limit=100,get_total_count=True),
        columns_to_get=ColumnsToGet(['k','t','g','ka','la'],ColumnReturnType.SPECIFIED))
    all_rows.extend(search_response.rows)
    first_page=False
for row in all_rows:
    print(row)

print('Totalrows:', len(all_rows))

如果需要返回Tuple類型結果，您可以使用如下請求樣本實現。

query=MatchAllQuery()
all_rows=[]
next_token=None
first_page=True

while first_page or next_token:
    rows, next_token, total_count, is_all_succeed, agg_results, group_by_results =client.search(table_name, index_name,
        SearchQuery(query,next_token=next_token,limit=100,get_total_count=True),
        columns_to_get=ColumnsToGet(['k','t','g','ka','la'],ColumnReturnType.SPECIFIED)).v1_response()
    all_rows.extend(rows)
    first_page=False
for row in all_rows:
    print(row)

print('Totalrows:', len(all_rows))

5.2.1之前版本

使用5.2.1之前的SDK版本時，預設的返回結果為Tuple類型，請求樣本如下：

query=MatchAllQuery()
all_rows=[]
next_token=None
first_page=True
while first_page or next_token:
    rows, next_token, total_count, is_all_succeed = client.search(table_name, index_name,
        SearchQuery(query, next_token=next_token, limit=100, get_total_count=True),
        columns_to_get=ColumnsToGet(['k', 't', 'g', 'ka', 'la'], ColumnReturnType.SPECIFIED))
    all_rows.extend(rows)
    first_page=False
for row in all_rows:
    print(row)

print('Total rows:', len(all_rows))