全部产品
Search
文档中心

Tablestore:Kueri terms

更新时间:Jul 06, 2025

Kueri terms berfungsi mirip dengan kueri term, tetapi memungkinkan Anda menentukan beberapa kata kunci dalam satu kueri untuk mencari baris data yang cocok dengan setidaknya salah satu kata kunci. Mekanisme pencocokan ini setara dengan Operator IN dalam SQL.

Prasyarat

Parameter

Parameter

Deskripsi

NamaTabel

Nama dari tabel data.

NamaIndeks

Nama dari indeks pencarian.

Kueri

Jenis kueri. Atur jenis kueri menjadi TermsQuery.

NamaBidang

Nama bidang yang ingin Anda kueri.

Terms

Kata kunci yang digunakan untuk mencocokkan nilai bidang saat Anda melakukan kueri terms.

Satu baris data akan dikembalikan jika setidaknya salah satu kata kunci cocok dengan nilai bidang.

Batas

Jumlah maksimum baris yang ingin Anda dapatkan dari kueri saat ini.

Untuk hanya menghitung jumlah baris yang memenuhi kondisi kueri tanpa mengembalikan data spesifik, Anda dapat mengatur Batas ke 0.

KolomUntukDiambil

Menentukan apakah akan mengembalikan semua kolom dari setiap baris yang memenuhi kondisi kueri. Anda dapat menentukan parameter ReturnAll dan Kolom.

Secara default, parameter ReturnAll diatur ke false, yang menunjukkan bahwa tidak semua kolom dikembalikan. Jika parameter ReturnAll diatur ke false, Anda dapat menggunakan parameter Kolom untuk menentukan kolom yang ingin Anda kembalikan. Jika Anda tidak menentukan parameter Kolom, hanya kolom kunci utama yang dikembalikan.

Jika Anda mengatur parameter ReturnAll ke true, semua kolom dalam baris yang cocok akan dikembalikan.

Contoh

Kode sampel berikut menunjukkan cara mengkueri baris di mana nilai kolom Col_Keyword persis cocok dengan "hangzhou" atau "tablestore".

/**
 * Query the rows in which the value of the Col_Keyword column exactly matches "hangzhou" or "tablestore" in the table. 
 */
func TermsQuery(client *tablestore.TableStoreClient, tableName string, indexName string) {
    searchRequest := &tablestore.SearchRequest{}
    searchRequest.SetTableName(tableName)
    searchRequest.SetIndexName(indexName)
    query := &search.TermsQuery{}   // Set the query type to TermsQuery. 
    query.FieldName = "Col_Keyword" // Set the field used to match the query conditions. 
    terms := make([]interface{}, 0)
    terms = append(terms, "hangzhou")
    terms = append(terms, "tablestore")
    query.Terms = terms // Set the keywords used in the query to match the column values. 
    searchQuery := search.NewSearchQuery()
    searchQuery.SetQuery(query)
    searchQuery.SetLimit(100)
    searchRequest.SetSearchQuery(searchQuery)
    // Return all columns in the rows that meet the query conditions. 
    searchRequest.SetColumnsToGet(&tablestore.ColumnsToGet{
        ReturnAll: true,
    })
    searchResponse, err := client.Search(searchRequest)
    if err != nil {
        fmt.Printf("%#v", err)
        return
    }
    fmt.Println("IsAllSuccess: ", searchResponse.IsAllSuccess) // Check whether all rows that meet the query conditions are returned. 
    fmt.Println("RowCount: ", len(searchResponse.Rows))
    for _, row := range searchResponse.Rows {
        jsonBody, err := json.Marshal(row)
        if err != nil {
            panic(err)
        }
        fmt.Println("Row: ", string(jsonBody))
    }
}

Pertanyaan Umum

Referensi

  • Saat menggunakan indeks pencarian untuk mengkueri data, Anda dapat menggunakan metode kueri berikut: kueri term, kueri terms, kueri match all, kueri match, kueri match phrase, kueri prefix, kueri rentang, kueri wildcard, kueri geo, kueri Boolean, kueri vektor KNN, kueri nested, dan kueri exists. Metode kueri ini dapat digunakan untuk mengkueri data dari berbagai dimensi sesuai dengan kebutuhan bisnis Anda.

    Anda dapat mengurutkan atau membagi halaman baris yang memenuhi kondisi kueri dengan menggunakan fitur pengurutan dan paginasi. Untuk informasi lebih lanjut, lihat Pengurutan dan Paginasi.

    Anda dapat menggunakan fitur collapse (distinct) untuk menggabungkan set hasil berdasarkan kolom tertentu. Dengan cara ini, data dari tipe yang ditentukan muncul hanya sekali dalam hasil kueri. Untuk informasi lebih lanjut, lihat Collapse (Distinct).

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

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