Tablestore:範囲クエリ

1. [インデックス] タブに移動します。

   1. Tablestore コンソールにログインします。

   2. 上部メニューで、リソースグループとリージョンを選択します。

   3. [概要] ページで、管理するインスタンスの名前をクリックするか、インスタンスの [操作] 列にある [インスタンスの管理] をクリックします。

   4. [インスタンス詳細] タブの [テーブル] タブで、データテーブルの名前をクリックするか、データテーブルの [操作] 列にある [インデックス] をクリックします。

2. [インデックス] タブで、データのクエリに使用する検索インデックスを見つけ、[操作] 列の [データ管理] をクリックします。

3. [データクエリ] ダイアログボックスで、データをクエリできます。

   1. デフォルトでは、システムはすべての属性列を返します。特定の属性列を返すには、[すべての列] をオフにし、返す属性列を指定します。複数の属性列はコンマ (,) で区切ります。

      説明

      デフォルトでは、システムはデータテーブルのすべてのプライマリキー列を返します。

   2. ビジネス要件に基づいて、[And]、[Or]、または [Not] 論理演算子を選択します。

      [And] 論理演算子を選択した場合、すべてのクエリ条件を満たすデータが返されます。[Or] 演算子を選択し、単一のクエリ条件を指定した場合、クエリ条件を満たすデータが返されます。Or 論理演算子を選択し、複数のクエリ条件を指定した場合、いずれかのクエリ条件を満たすデータが返されます。[Not] 論理演算子を選択した場合、クエリ条件を満たさないデータが返されます。

   3. インデックスフィールドを選択し、[追加] をクリックします。

   4. インデックスフィールドのクエリタイプを [範囲クエリ (RangeQuery)] に設定し、クエリ範囲を指定します。

      クエリ範囲は左閉じ、右開き ([start, end)) です。

   5. デフォルトでは、ソート機能は無効になっています。特定のフィールドに基づいてクエリ結果をソートする場合は、[ソート] をオンにし、クエリ結果のソート基準となるフィールドとソート順序を指定します。

   6. デフォルトでは、集計機能は無効になっています。特定のフィールドの統計を収集する場合は、[統計の収集] をオンにし、統計を収集するフィールドを指定してから、統計の収集に必要な情報を設定します。

4. [OK] をクリックします。

   クエリ条件を満たすデータが、[インデックス] タブに指定した順序で表示されます。

コマンドラインインターフェイスで search コマンドを実行して、検索インデックスを使用してデータをクエリできます。詳細については、「検索インデックス」をご参照ください。

1. search コマンドを実行して、search_index 検索インデックスを使用してテーブルからデータをクエリします。このコマンドは、すべてのインデックス付き列を返します。

   search -n search_index --return_all_indexed

2. システムプロンプトに従ってクエリ条件を入力します。以下に例を示します。

   {
       "Offset": -1,
       "Limit": 10,
       "Collapse": null,
       "Sort": null,
       "GetTotalCount": true,
       "Token": null,
       "Query": {
           "Name": "RangeQuery",
           "Query": {
               "FieldName": "col_long",
               "From": 1,
               "To": 100,
               "IncludeLower": true,
               "IncludeUpper": false
           }
       }
   }

範囲クエリは、Java SDK、Go SDK、Python SDK、Node.js SDK、.NET SDK、または PHP SDK を使用して実行できます。このトピックでは、Java SDK を例として使用します。

次の例では、price フィールド内の Long 型の値で、半開区間 [100, 500) に含まれるものをクエリします。このクエリは最大 10 行を返し、一致した行の総数を取得します。

String tableName = "example_table";
String indexName = "example_index";

RangeQuery rangeQuery = new RangeQuery();
rangeQuery.setFieldName("price");
rangeQuery.greaterThanOrEqual(ColumnValue.fromLong(100L));
rangeQuery.lessThan(ColumnValue.fromLong(500L));

SearchQuery searchQuery = new SearchQuery();
searchQuery.setQuery(rangeQuery);
searchQuery.setLimit(10);
searchQuery.setTrackTotalCount(SearchQuery.TRACK_TOTAL_COUNT);

SearchRequest request = new SearchRequest(tableName, indexName, searchQuery);
SearchRequest.ColumnsToGet columnsToGet = new SearchRequest.ColumnsToGet();
columnsToGet.setReturnAll(true);
request.setColumnsToGet(columnsToGet);

SearchResponse response = client.search(request);
System.out.println(response.getTotalCount());
System.out.println(response.getRows());