Tablestore:結果のソートとページング

単一カラムのソート

単一カラムの値で結果をソートします。

SearchQuery searchQuery = new SearchQuery();
searchQuery.setSort(new Sort(Arrays.asList(new FieldSort("col", SortOrder.ASC))));

複数カラムのソート

1 つのカラムの値でソートした後、別のカラムの値でソートします。

SearchQuery searchQuery = new SearchQuery();
searchQuery.setSort(new Sort(Arrays.asList(
    new FieldSort("col1", SortOrder.ASC), new FieldSort("col2", SortOrder.ASC))));

フォールバックソート

Long、 Double、または Date カラムでソートする場合は、missingFieldパラメータを使用して、同じ型のフォールバックカラムを指定できます。このフォールバックは、プライマリのソートカラムに値が存在しない行に対して使用されます。

/**
* `Col_Long` を降順でソートします。行に `Col_Long` の値がない場合は、代わりに `Col_Long_sec` の値を使用します。
*/
SearchQuery searchQuery = new SearchQuery();
FieldSort fieldSort = new FieldSort("Col_Long");
// `Col_Long` の欠損値に対するフォールバックとして `Col_Long_sec` を指定します。
fieldSort.setMissingField("Col_Long_sec");
fieldSort.setOrder(SortOrder.DESC); 

欠損値のソート

ドキュメントにソートフィールドが存在しない場合は、missingValueパラメータを使用して、ソート結果内での位置を制御できます。

ソート動作は次のとおりです：

• missingValueをFieldSort.FIRST_WHEN_MISSINGに設定すると、ソート順序 (昇順または降順) に関係なく、欠損値のあるドキュメントは常に結果の先頭に配置されます。

• missingValueをFieldSort.LAST_WHEN_MISSINGに設定するか、未設定 (null) の場合、ソート順序に関係なく、欠損値のあるドキュメントは常に結果の末尾に配置されます。

  /**
   * `Col_Long` を降順でソートします。`Col_Long` の値が欠損しているドキュメントを結果の先頭に配置します。
   */
  SearchQuery searchQuery = new SearchQuery();
  FieldSort fieldSort = new FieldSort("Col_Long");
  // 欠損値のあるドキュメントを先頭に配置します。
  fieldSort.setMissingValue(FieldSort.FIRST_WHEN_MISSING);
  fieldSort.setOrder(SortOrder.DESC);
  searchQuery.setSort(new Sort(Arrays.asList(fieldSort)));

複数値フィールドのソート

配列やネスト型フィールドなどの複数値フィールドでは、modeパラメータを使用して、コレクション内のどの値をソートに使用するかを指定できます。

配列内の指定した値でソートします。

// 行 doc1 と doc2 には、field1 という名前の配列フィールドが含まれています。doc1 の field1 の値は [2,3]、doc2 の値は [1,3,4] です。
// mode パラメータを設定して、配列内のどの値をソートに使用するかを指定できます。
{
    // mode を SortMode.MAX に設定した場合、結果は doc2 (4 でソート) の後に doc1 (3 でソート) となります。
    FieldSort fieldSort = new FieldSort("field1", SortOrder.DESC);
    fieldSort.setMode(SortMode.MAX);
}
{
    // mode を SortMode.MIN に設定した場合、結果は doc1 (2 でソート) の後に doc2 (1 でソート) となります。
    FieldSort fieldSort = new FieldSort("field1", SortOrder.DESC);
    fieldSort.setMode(SortMode.MIN);
}

ネスト型のサブフィールド内の値でソートすることもできます。

// 行 doc1 と doc2 には、field1 という名前のネスト型フィールドが含まれています。
// doc1 の field1 の値は [{"name":"b", "age":1},{"name":"a", "age":7}] です。
// doc2 の field1 の値は [{"name":"a", "age":1},{"name":"c", "age":1},{"name":"d", "age":5}] です。

{
    // すべてのサブ行をソートし、mode パラメータでどの値をソートに使用するかを指定します。
    // mode を SortMode.MAX に設定し、age フィールドでソートした場合、結果は doc1 (7 でソート) の後に doc2 (5 でソート) となります。
    FieldSort fieldSort = new FieldSort("field1.age", SortOrder.DESC);
    fieldSort.setMode(SortMode.MAX);
    String path = "field1";
    NestedFilter nestedFilter = new NestedFilter(path, QueryBuilders.matchAll().build());
    fieldSort.setNestedFilter(nestedFilter);
}
{
    // age=1 のサブ行のみをソートし、mode パラメータでどの値をソートに使用するかを指定します。
    {
        // mode を SortMode.MAX に設定し、name フィールドでソートした場合、結果は doc2 ("c" でソート) の後に doc1 ("b" でソート) となります。
        FieldSort fieldSort = new FieldSort("field1.name", SortOrder.DESC);
        fieldSort.setMode(SortMode.MAX);
        String path = "field1";
        NestedFilter nestedFilter = new NestedFilter(path, QueryBuilders.term("field1.age",1).build());
        fieldSort.setNestedFilter(nestedFilter);
    }
    {
        // mode を SortMode.MIN に設定し、name フィールドでソートした場合、結果は doc1 ("b" でソート) の後に doc2 ("a" でソート) となります。
        FieldSort fieldSort = new FieldSort("field1.name", SortOrder.DESC);
        fieldSort.setMode(SortMode.MIN);
        String path = "field1";
        NestedFilter nestedFilter = new NestedFilter(path, QueryBuilders.term("field1.age",1).build());
        fieldSort.setNestedFilter(nestedFilter);
    }
}