Tablestore：Pengurutan dan halaman dalam

Skenario

Pra-pengurutan indeks

Secara default, data dalam indeks pencarian diurutkan berdasarkan pengaturan pra-pengurutan dari parameter IndexSort. Saat menggunakan indeks pencarian untuk mengquery data, pengaturan ini menentukan urutan default hasil query.

Saat membuat indeks pencarian, Anda dapat menentukan pengaturan pra-pengurutan dengan mengonfigurasi parameter IndexSort. Jika tidak ditentukan, data diurutkan berdasarkan nilai kunci utama.

Tentukan metode pengurutan saat mengquery data

Pengurutan hanya dapat diaktifkan untuk bidang dengan parameter EnableSortAndAgg disetel ke true.

Anda dapat menentukan metode pengurutan untuk setiap query. Query berbasis indeks pencarian mendukung beberapa metode pengurutan berikut, yang dapat dikombinasikan berdasarkan prioritas.

ScoreSort

// Komentar dalam bahasa Indonesia
// Urutkan hasil query dalam urutan menurun berdasarkan skor.
searchQuery := search.NewSearchQuery()
searchQuery.SetSort(&search.Sort{
    []search.Sorter{
        &search.ScoreSort{
            Order: search.SortOrder_DESC.Enum(), // Urutkan hasil query dalam urutan menurun berdasarkan skor. 
        },
    },
})

PrimaryKeySort

Gunakan PrimaryKeySort untuk mengurutkan hasil query berdasarkan nilai kunci utama.

// Komentar dalam bahasa Indonesia
// Urutkan hasil query berdasarkan nilai kunci utama dalam urutan naik.
searchQuery := search.NewSearchQuery()
searchQuery.SetSort(&search.Sort{
    []search.Sorter{
        &search.PrimaryKeySort{
            Order: search.SortOrder_ASC.Enum(),
        },
    },
})

FieldSort

Gunakan FieldSort untuk mengurutkan hasil query berdasarkan nilai satu atau lebih kolom tertentu.

// Komentar dalam bahasa Indonesia
// Urutkan hasil query berdasarkan nilai kolom Col_Long dalam urutan menurun.
searchQuery.SetSort(&search.Sort{
    []search.Sorter{
        &search.FieldSort{
            FieldName: "Col_Long",
            Order:     search.SortOrder_DESC.Enum(),
        },
    },
})

// Komentar dalam bahasa Indonesia
// Urutkan hasil query berdasarkan nilai col1 dalam urutan naik dan col2 dalam urutan menurun.
searchQuery.SetSort(&search.Sort{
    []search.Sorter{
        &search.FieldSort{
            FieldName: "col1",
            Order:     search.SortOrder_ASC.Enum(),
        },
        &search.FieldSort{
            FieldName: "col2",
            Order:     search.SortOrder_DESC.Enum(),
        },
    },
})

GeoDistanceSort

Gunakan GeoDistanceSort untuk mengurutkan hasil query berdasarkan lokasi geografis.

// Komentar dalam bahasa Indonesia
// Tentukan nama bidang GEOPOINT dan koordinat titik pusat.
searchQuery.SetSort(&search.Sort{
    []search.Sorter{
        &search.GeoDistanceSort{
            FieldName: "location",   // Tentukan nama bidang GEOPOINT. 
            Points:    []string{"40,-70"}, // Tentukan pasangan koordinat titik pusat. 
        },
    },
})

Tentukan metode halaman dalam

Anda dapat mengonfigurasi parameter Limit dan Offset atau menggunakan token untuk membagi baris dalam respons menjadi halaman-halaman.

Halaman dalam berdasarkan parameter Limit dan Offset

Jika tidak menentukan nilai untuk parameter Limit dan Offset, nilai default akan digunakan. Nilai default parameter Limit adalah 10, dan nilai default parameter Offset adalah 0.

// Komentar dalam bahasa Indonesia
// Setel Limit menjadi 10 dan Offset menjadi 10.
searchQuery := search.NewSearchQuery()
searchQuery.SetLimit(10)
searchQuery.SetOffset(10) 

Halaman dalam berdasarkan token

Kami merekomendasikan penggunaan token untuk halaman dalam yang dalam karena metode ini tidak memiliki batasan pada kedalaman halaman.

Jika Tablestore tidak dapat membaca semua data yang memenuhi kondisi query, Tablestore mengembalikan NextToken. Gunakan NextToken untuk melanjutkan membaca data berikutnya.

Secara default, Anda hanya bisa mundur saat menggunakan token. Namun, Anda dapat menyimpan dan menggunakan token sebelumnya untuk maju karena token valid selama query.

Saat menggunakan token, metode pengurutan sama dengan metode yang digunakan dalam permintaan sebelumnya. Tablestore mengurutkan data berdasarkan parameter IndexSort secara default atau berdasarkan metode yang Anda tentukan. Anda tidak dapat menentukan metode pengurutan atau mengonfigurasi parameter Offset saat menggunakan token. Data dikembalikan halaman demi halaman secara berurutan, yang dapat menghasilkan query yang lambat.

// Komentar dalam bahasa Indonesia
// Gunakan token untuk membaca data halaman demi halaman.
func QueryRowsWithToken(client *tablestore.TableStoreClient, tableName string, indexName string) {
    querys := []search.Query{
        &search.MatchAllQuery{},
        &search.TermQuery{
            FieldName: "Col_Keyword",
            Term:      "tablestore",
        },
    }
    for _, query := range querys {
        fmt.Printf("Test query: %#v\n", query)
        searchRequest := &tablestore.SearchRequest{}
        searchRequest.SetTableName(tableName)
        searchRequest.SetIndexName(indexName)
        searchQuery := search.NewSearchQuery()
        searchQuery.SetQuery(query)
        searchQuery.SetLimit(10)
        searchQuery.SetGetTotalCount(true)
        searchRequest.SetSearchQuery(searchQuery)
        searchResponse, err := client.Search(searchRequest)
        if err != nil {
            fmt.Printf("%#v", err)
            return
        }
        rows := searchResponse.Rows
        requestCount := 1
        for searchResponse.NextToken != nil {           
            {  
	              // Jika Anda ingin menyimpan NextToken atau mentransfer NextToken ke halaman frontend, Anda dapat menggunakan Base64 untuk mengkodekan NextToken menjadi string. 
	              // Token bukanlah string. Jika Anda menggunakan string(NextToken) untuk mengkodekan token menjadi string, informasi tentang token hilang. 
	              tokenAsString := base64.StdEncoding.EncodeToString(searchResponse.NextToken)
	              // Dekode string menjadi byte. 
	              tokenAsByte, err := base64.StdEncoding.DecodeString(tokenAsString)
	              if err != nil {
		                fmt.Printf("len:%d, %#v",len(tokenAsByte), err)
		                return
	              }
            }
            searchQuery.SetToken(searchResponse.NextToken)
            searchResponse, err = client.Search(searchRequest)
            if err != nil {
                fmt.Printf("%#v", err)
                return
            }
            requestCount++
            for _, r := range searchResponse.Rows {
                rows = append(rows, r)
            }
        }
        fmt.Println("IsAllSuccess: ", searchResponse.IsAllSuccess)
        fmt.Println("TotalCount: ", searchResponse.TotalCount)
        fmt.Println("RowsSize: ", len(rows))
        fmt.Println("RequestCount: ", requestCount)
    }
}