すべてのプロダクト
Search

このプロダクト

    Tablestore:縮約 (個別)

    ドキュメントセンター

    Tablestore:縮約 (個別)

    最終更新日:Dec 28, 2024

    クエリの結果に特定の種類の大量のデータが含まれている場合、縮約 (個別) 機能を使用して、指定した列に基づいて結果セットを縮約できます。特定の種類のデータは、結果の種類の多様性を確保するために、クエリ結果に一度だけ表示されます。

    前提条件

    使用上の注意

    • 縮約 (個別) 機能を使用する場合、offset パラメーターと limit パラメーターを指定することによってのみページネーションを実行できます。

    • 結果セットを同時に集計および縮約する場合、結果セットは縮約される前に集計されます。

    • クエリの結果を縮約する場合、返される結果の総数は、offset パラメーターと limit パラメーターの値の合計によって決まります。最大 100,000 件の結果を返すことができます。

    • レスポンス内の行の総数は、縮約 (個別) 機能を使用する前にクエリ条件を満たす行の数を示します。結果セットが縮約された後、個別の値の総数をクエリすることはできません。

    パラメーター

    パラメーター

    説明

    query

    クエリの種類。このパラメーターは任意のクエリの種類に設定できます。

    collapse

    field_name フィールドで指定された列に基づいて結果セットを縮約します。

    field_name: 結果セットの縮約の基準となる列の名前。値が INTEGER、FLOATING-POINT、および KEYWORD タイプの列のみがサポートされています。

    offset

    現在のクエリが開始される位置。

    limit

    現在のクエリで返される行の最大数。

    行の特定のデータをクエリせずに、クエリ条件を満たす行の数のみをクエリするには、limit パラメーターを 0 に設定します。

    get_total_count

    クエリ条件を満たす行の総数を返すかどうかを指定します。このパラメーターのデフォルト値は false で、クエリ条件を満たす行の総数は返されません。

    このパラメーターを true に設定すると、クエリのパフォーマンスが低下します。

    table_name

    データテーブルの名前。

    index_name

    検索インデックスの名前。

    columns_to_get

    クエリ条件を満たす各行のすべての列を返すかどうかを指定します。このパラメーターには、return_type フィールドと column_names フィールドを設定できます。

    • return_type フィールドを ColumnReturnType.SPECIFIED に設定する場合は、column_names フィールドを使用して返す列を指定します。

    • return_type フィールドを ColumnReturnType.ALL に設定すると、すべての列が返されます。

    • return_type フィールドを ColumnReturnType.NONE に設定すると、プライマリキー列のみが返されます。

    例

    次のサンプルコードは、price 列の値が 1000 と一致する行をクエリする方法の例を示しています。この例では、結果セットは product_name 列の値に基づいて縮約されます。

    # price フィールドの値が 1000 であるすべての製品をクエリするためのクエリ条件を構築します。
query = TermQuery('price', 1000)

# 結果セットを "product_name" 列に基づいて縮約します。
collapse = Collapse('product_name')
search_response = client.search('<TABLE_NAME>', '<SEARCH_INDEX_NAME>',
                                SearchQuery(query, limit=100, get_total_count = False, collapse_field = collapse),
                                columns_to_get = ColumnsToGet(return_type = ColumnReturnType.ALL_FROM_INDEX))
print('request_id : %s' % search_response.request_id)
print('is_all_succeed : %s' % search_response.is_all_succeed)
print('total_count : %s' % search_response.total_count)
print('rows : %s' % search_response.rows)

    FAQ

    参考資料

    • 検索インデックスを使用してデータをクエリする場合、次のクエリメソッドを使用できます：用語クエリ、複数用語クエリ、すべて一致クエリ、一致クエリ、一致フレーズクエリ、プレフィックスクエリ、範囲クエリ、ワイルドカードクエリ、地理クエリ、ブールクエリ、KNN ベクタークエリ、ネストされたクエリ、および 存在クエリ。検索インデックスによって提供されるクエリメソッドを使用して、ビジネス要件に基づいて複数のディメンションからデータをクエリできます。

      並べ替え機能とページング機能を使用して、クエリ条件を満たす行を並べ替えたりページネーションしたりできます。詳細については、並べ替えとページング を参照してください。

      縮約 (個別) 機能を使用して、特定の列に基づいて結果セットを縮約できます。このようにして、指定されたタイプのデータはクエリ結果に一度だけ表示されます。詳細については、縮約 (個別) を参照してください。

    • データテーブルのデータを分析する場合、Search 操作の集計機能を使用するか、SQL ステートメントを実行できます。たとえば、最小値と最大値、合計、および行の総数を取得できます。詳細については、集計 および SQL クエリ を参照してください。

    • 行を並べ替えることなく、クエリ条件を満たすすべての行を取得する場合、ParallelScan 操作と ComputeSplits 操作を呼び出して並列スキャン機能を使用できます。詳細については、並列スキャン を参照してください。