Tablestore:Pengurutan dan paging

Pengurutan satu bidang

Mengurutkan hasil berdasarkan nilai dalam satu bidang.

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

Pengurutan multi-bidang

Mengurutkan hasil terlebih dahulu berdasarkan nilai dalam satu bidang, lalu berdasarkan nilai dalam bidang lainnya.

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

Bidang fallback

Saat mengurutkan berdasarkan bidang bertipe Long, Double, atau Date, Anda dapat mengatur parameter missingField untuk menentukan bidang lain dengan tipe yang sama sebagai nilai fallback jika suatu baris tidak memiliki nilai pada bidang utama pengurutan.

/**
* Urutkan hasil dalam urutan descending berdasarkan nilai pada bidang Col_Long. 
* Jika suatu baris tidak memiliki nilai pada bidang Col_Long (tipe Long), 
* nilai dari bidang Col_Long_sec (tipe Long) digunakan sebagai gantinya untuk pengurutan.
*/
SearchQuery searchQuery = new SearchQuery();
FieldSort fieldSort = new FieldSort("Col_Long");
// Tentukan bidang Col_Long_sec sebagai fallback untuk pengurutan saat nilai pada bidang Col_Long tidak tersedia.
fieldSort.setMissingField("Col_Long_sec");
fieldSort.setOrder(SortOrder.DESC); 

Nilai yang hilang

Parameter missingValue menentukan posisi pengurutan untuk dokumen yang tidak memiliki bidang pengurutan. Anda dapat mengatur parameter ini untuk mengontrol di mana dokumen tersebut muncul dalam hasil.

Perilaku pengurutan adalah sebagai berikut:

• Jika missingValue diatur ke FieldSort.FIRST_WHEN_MISSING, dokumen dengan nilai yang hilang selalu ditempatkan di awal hasil, terlepas dari urutan pengurutan (ascending atau descending).

• Jika missingValue diatur ke FieldSort.LAST_WHEN_MISSING atau null, dokumen dengan nilai yang hilang selalu ditempatkan di akhir hasil, terlepas dari urutan pengurutan.

  /**
  * Urutkan hasil dalam urutan descending berdasarkan nilai pada bidang Col_Long (tipe Long).
  * Jika suatu baris tidak memiliki nilai pada bidang Col_Long, tempatkan dokumen tersebut di awal hasil.
  */
  SearchQuery searchQuery = new SearchQuery();
  FieldSort fieldSort = new FieldSort("Col_Long");
  // Tempatkan dokumen dengan nilai yang hilang di awal.
  fieldSort.setMissingValue(FieldSort.FIRST_WHEN_MISSING);
  fieldSort.setOrder(SortOrder.DESC);
  searchQuery.setSort(new Sort(Arrays.asList(fieldSort)));

Bidang bernilai ganda

Untuk bidang bernilai ganda, seperti bidang bertipe array atau nested, Anda dapat menggunakan parameter mode untuk menentukan elemen mana yang digunakan untuk pengurutan.

Urutkan berdasarkan nilai tertentu dalam array bernilai ganda.

// Asumsikan Anda memiliki dua baris, doc1 dan doc2. Keduanya memiliki field1 bertipe array.
// Nilai field1 pada doc1 adalah [2,3]. Nilai field1 pada doc2 adalah [1,3,4].
// Anda dapat mengatur parameter mode untuk menentukan nilai mana dalam array yang digunakan untuk pengurutan.
{
    // Ketika mode diatur ke SortMode.MAX, urutan pengurutan adalah doc2 (diurutkan berdasarkan 4), lalu doc1 (diurutkan berdasarkan 3).
    FieldSort fieldSort = new FieldSort("field1", SortOrder.DESC);
    fieldSort.setMode(SortMode.MAX);
}
{
    // Ketika mode diatur ke SortMode.MIN, urutan pengurutan adalah doc1 (diurutkan berdasarkan 2), lalu doc2 (diurutkan berdasarkan 1).
    FieldSort fieldSort = new FieldSort("field1", SortOrder.DESC);
    fieldSort.setMode(SortMode.MIN);
}

Anda juga dapat mengurutkan sub-baris dari bidang bertipe nested.

// Asumsikan Anda memiliki dua baris, doc1 dan doc2. Keduanya memiliki field1 bertipe nested.
// Nilai field1 pada doc1 adalah [{"name":"b", "age":1},{"name":"a", "age":7}].
// Nilai field1 pada doc2 adalah [{"name":"a", "age":1},{"name":"c", "age":1},{"name":"d", "age":5}].

{
    // Urutkan semua sub-baris dan gunakan parameter mode untuk menentukan nilai mana yang digunakan untuk pengurutan.
    // Ketika mode diatur ke SortMode.MAX dan Anda mengurutkan berdasarkan bidang age, hasilnya adalah doc1 (diurutkan berdasarkan 7), lalu doc2 (diurutkan berdasarkan 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);
}
{
    // Urutkan hanya sub-baris di mana age=1, dan gunakan parameter mode untuk menentukan nilai mana yang digunakan.
    {
        // Ketika mode diatur ke SortMode.MAX dan Anda mengurutkan berdasarkan bidang name, hasilnya adalah doc2 (diurutkan berdasarkan "c"), lalu doc1 (diurutkan berdasarkan "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);
    }
    {
        // Ketika mode diatur ke SortMode.MIN dan Anda mengurutkan berdasarkan bidang name, hasilnya adalah doc1 (diurutkan berdasarkan "b"), lalu doc2 (diurutkan berdasarkan "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);
    }
}