全部产品
Search
文档中心

Tablestore:Kueri terms

更新时间:Jul 02, 2025

Kueri terms mirip dengan kueri term, tetapi mendukung beberapa terms. Sebaris data akan dikembalikan jika setidaknya salah satu kata kunci cocok persis dengan nilai bidang. Kueri terms dapat digunakan seperti Operator IN dalam pernyataan SQL.

Prasyarat

Parameter

Parameter

Deskripsi

NamaTabel

Nama tabel data.

NamaIndeks

Nama indeks pencarian.

Kueri

Jenis kueri. Atur jenis kueri ke TermsQuery.

NamaBidang

Nama bidang yang ingin Anda cocokkan.

Terms

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

Sebaris data akan dikembalikan jika setidaknya salah satu kata kunci cocok persis dengan nilai bidang.

Batas

Jumlah maksimum baris yang ingin Anda kembalikan dalam kueri saat ini.

Untuk hanya menanyakan jumlah baris yang memenuhi kondisi kueri tanpa data spesifik, atur parameter Batas ke 0.

KolomUntukDiambil

Menentukan apakah akan mengembalikan semua kolom dari setiap baris yang memenuhi kondisi kueri. Anda dapat mengonfigurasi ReturnAll, Kolom, dan ReturnAllFromIndex untuk parameter ini.

Nilai default ReturnAll adalah false, yang menentukan bahwa tidak semua kolom dikembalikan. Anda dapat menggunakan salah satu metode berikut untuk menentukan kolom yang ingin Anda kembalikan. Jika Anda tidak menggunakan metode berikut untuk menentukan kolom yang ingin Anda kembalikan, hanya kolom kunci utama yang dikembalikan.

  • Konfigurasikan Kolom untuk menentukan kolom yang ingin Anda kembalikan.

  • Atur ReturnAllFromIndex ke true untuk mengembalikan semua kolom dari indeks pencarian.

Jika Anda mengatur ReturnAll ke true, semua kolom akan dikembalikan.

Contoh

Berikut ini adalah contoh kode sampel untuk menanyakan baris di mana nilai kolom Col_Keyword dalam tabel cocok persis dengan kata kunci "SearchIndex" atau "Sample":

/// <summary>
/// Cari tabel untuk baris di mana nilai kolom Col_Keyword cocok persis dengan "SearchIndex" atau "Sample". 
/// </summary>
/// <param name="otsClient"></param>
public static void TermsQuery(OTSClient otsClient)
{
    TermsQuery termsQuery = new TermsQuery();
    termsQuery.FieldName = "Col_Keyword";
    termsQuery.Terms = new List<ColumnValue>
    {
        new ColumnValue("SearchIndex"),
        new ColumnValue("Sample")
    };

    SearchQuery searchQuery = new SearchQuery();
    searchQuery.Query = termsQuery;

    SearchRequest searchRequest = new SearchRequest(TableName, IndexName, searchQuery);
    // Anda dapat menentukan parameter ColumnsToGet untuk mengembalikan kolom yang Anda tentukan, semua kolom dalam baris yang memenuhi kondisi kueri, atau semua kolom dalam indeks pencarian. Jika Anda tidak menentukan parameter ini, hanya kolom kunci utama yang dikembalikan. 
    searchRequest.ColumnsToGet = new ColumnsToGet
    {
        // Tentukan bahwa semua kolom dalam indeks pencarian dikembalikan. 
        ReturnAllFromIndex = true
        // Tentukan kolom yang ingin Anda kembalikan. 
        //Columns = new List<string>() { Long_type_col, Text_type_col, Keyword_type_col }
        // Tentukan bahwa semua kolom dikembalikan. 
        //ReturnAll = true         
    };

    SearchResponse searchResponse = otsClient.Search(searchRequest);

    Console.WriteLine(JsonConvert.SerializeObject(searchResponse));
}

FAQ

Referensi

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

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

    Fitur collapse (distinct) dapat digunakan untuk meruntuhkan set hasil berdasarkan kolom tertentu, sehingga data dari tipe yang ditentukan muncul hanya sekali dalam hasil kueri. Untuk informasi lebih lanjut, lihat Collapse (distinct).

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

  • Jika Anda ingin memperoleh 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 Pemindaian paralel.