Tablestore:Sorting dan paging

Skenario

Index presorting

Secara default, Tablestore mengurutkan data dalam search index berdasarkan urutan sortir yang telah ditentukan sebelumnya, yang disebut index presorting (IndexSort). Saat Anda mengkueri data, IndexSort menentukan urutan default hasil yang dikembalikan.

Saat membuat search index, Anda dapat menyesuaikan IndexSort. Jika tidak menentukan pengaturan ini, indeks akan menggunakan primary key sort sebagai default.

Tentukan metode sorting saat mengkueri data

Sorting hanya dapat diaktifkan untuk bidang-bidang yang memiliki parameter EnableSortAndAgg diatur ke true.

Anda dapat menentukan metode sorting untuk setiap kueri. Kueri berbasis search index mendukung metode sorting berikut, serta memungkinkan penentuan beberapa metode sorting berdasarkan prioritas yang berbeda.

ScoreSort

var searchQuery = new SearchQuery();
searchQuery.Sort = new Sort(new List<ISorter>() { new ScoreSort() });

PrimaryKeySort

Anda dapat menggunakan PrimaryKeySort untuk mengurutkan hasil kueri berdasarkan nilai primary key.

// Urutkan hasil kueri berdasarkan nilai primary key secara ascending. 
var searchQuery = new SearchQuery();
searchQuery.Sort = new Sort(new List<ISorter>() { new PrimaryKeySort() });

// Urutkan hasil kueri berdasarkan nilai primary key secara descending. 
var searchQuery = new SearchQuery();
searchQuery.Sort = new Sort(new List<ISorter>() { new PrimaryKeySort(SortOrder.DESC) });

FieldSort

Anda dapat menggunakan FieldSort untuk mengurutkan hasil kueri berdasarkan nilai satu atau beberapa kolom tertentu.

var searchQuery = new SearchQuery();
var fieldSort = new FieldSort("col", SortOrder.ASC);
searchQuery.Sort = new Sort(new List<ISorter>() { fieldSort });

var searchQuery = new SearchQuery();
var col1Sort = new FieldSort("col", SortOrder.ASC);
var col2Sort = new FieldSort("co2", SortOrder.ASC);
searchQuery.Sort = new Sort(new List<ISorter>() { col1Sort, col2Sort });

GeoDistanceSort

Anda dapat menggunakan GeoDistanceSort untuk mengurutkan hasil kueri berdasarkan lokasi geografis.

var searchQuery = new SearchQuery();
var geoDistanceSort = new GeoDistanceSort("geoCol", new List<string>(){"0","0"});
searchQuery.Sort = new Sort(new List<ISorter>() { geoDistanceSort });

Tentukan metode paging

Anda dapat mengonfigurasi parameter Limit dan Offset atau menggunakan token untuk melakukan paging terhadap baris dalam respons.

Paging berdasarkan parameter Limit dan Offset

Untuk informasi tentang cara meningkatkan nilai maksimum parameter Limit, lihat Bagaimana cara meningkatkan nilai parameter limit menjadi 1000 saat saya memanggil operasi Search dari fitur search index untuk mengkueri data?.

Jika tidak mengonfigurasi parameter Limit dan Offset saat menggunakan metode ini, nilai default Limit adalah 10 dan nilai default Offset adalah 0.

var searchQuery = new SearchQuery();
searchQuery.Query = new MatchAllQuery();
searchQuery.Limit = 100;
searchQuery.Offset = 100;

Paging berdasarkan token

Kami merekomendasikan penggunaan token untuk deep paging karena metode ini tidak memiliki batasan kedalaman paging.

Jika Tablestore tidak dapat membaca semua data yang memenuhi kondisi kueri, Tablestore akan mengembalikan NextToken. Anda dapat menggunakan NextToken untuk melanjutkan pembacaan data berikutnya.

Secara default, Anda hanya dapat melakukan paging mundur saat menggunakan token. Namun, Anda dapat menyimpan cache dan menggunakan token sebelumnya untuk melakukan paging maju karena token tetap valid selama kueri berlangsung.

Saat menggunakan token, metode sorting mengikuti metode yang digunakan pada permintaan sebelumnya. Tablestore mengurutkan data berdasarkan parameter IndexSort secara default atau berdasarkan metode yang Anda tentukan. Anda tidak dapat mengubah metode sorting atau mengonfigurasi parameter Offset saat menggunakan token. Data dikembalikan secara berurutan per halaman.

/// <summary>
/// Pada contoh ini, token digunakan untuk melakukan paging terhadap baris dalam respons dan Tablestore membaca semua data serta mengembalikannya dalam bentuk daftar. 
/// </summary>
/// <param name="otsClient"></param>
public static SearchResponse ReadMoreRowsWithToken(OTSClient otsClient)
{
    var searchQuery = new SearchQuery();
    searchQuery.Query = new MatchAllQuery();

    var request = new SearchRequest(TableName, IndexName, searchQuery);

    var response = otsClient.Search(request);
    var rows = response.Rows;
    while (response.NextToken != null) // Jika NextToken bernilai null dalam respons, berarti semua data telah dibaca. 
    {
        request.SearchQuery.Token = response.NextToken;
        response = otsClient.Search(request);
        rows.AddRange(response.Rows);
    }

    return response;
}

FAQ

• Apa yang harus saya lakukan jika tidak ada data yang ditemukan saat memanggil operasi Search?

• Bagaimana cara meningkatkan nilai parameter limit menjadi 1000 saat saya memanggil operasi Search dari fitur search index untuk mengkueri data?

• Mengapa token menjadi tidak valid saat pagination digunakan dalam kueri berbasis search index?

Referensi

• Saat menggunakan search index untuk mengkueri data, Anda dapat menggunakan metode kueri berikut: term query, terms query, match all query, match query, match phrase query, prefix query, range query, wildcard query, Boolean query, geo query, nested query, dan exists query. Anda dapat menggunakan berbagai metode kueri untuk mengkueri data dari berbagai dimensi sesuai kebutuhan bisnis Anda.

  Anda dapat mengurutkan atau melakukan paging terhadap baris-baris yang memenuhi kondisi kueri dengan menggunakan fitur sorting dan paging. Untuk informasi lebih lanjut, lihat Sorting dan paging.

  Anda dapat menggunakan fitur collapse (distinct) untuk menciutkan set hasil berdasarkan kolom tertentu. Dengan cara ini, data jenis tertentu hanya muncul sekali dalam hasil kueri. Untuk informasi lebih lanjut, lihat Collapse (distinct).

• Jika ingin menganalisis data dalam tabel data, Anda dapat menggunakan fitur agregasi dari operasi Search atau mengeksekusi pernyataan SQL. Misalnya, Anda dapat memperoleh nilai minimum dan maksimum, jumlah total, serta jumlah baris. Untuk informasi lebih lanjut, lihat Agregasi dan SQL query.

• Jika ingin memperoleh semua baris yang memenuhi kondisi kueri tanpa perlu mengurutkannya, Anda dapat memanggil operasi ParallelScan dan ComputeSplits untuk menggunakan fitur pemindaian paralel. Untuk informasi lebih lanjut, lihat Pemindaian paralel.