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 フィールド (Long 型) の値がない場合、
* 代わりに Col_Long_sec フィールド (Long 型) の値がソートに使用されます。
*/
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 フィールド (Long 型) の値に基づいて結果を降順でソートします。
  * 行に Col_Long フィールドの値がない場合、そのドキュメントを結果の末尾に配置します。
  */
  SearchQuery searchQuery = new SearchQuery();
  FieldSort fieldSort = new FieldSort("Col_Long");
  // 欠損値を持つドキュメントを最後に配置します。
  fieldSort.setMissingValue(FieldSort.LAST_WHEN_MISSING);
  fieldSort.setOrder(SortOrder.DESC);
  searchQuery.setSort(new Sort(Arrays.asList(fieldSort)));

複数値フィールド

配列型やネスト型フィールドなどの複数値フィールドの場合、mode パラメータを使用して、ソートに使用する要素を指定できます。

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

// doc1 と doc2 の 2 つの行があるとします。どちらも配列型の field1 があります。
// doc1 の field1 の値は [2,3] です。doc2 の field1 の値は [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 の 2 つの行があるとします。どちらもネスト型の 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);
    }
}