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
Sebuah instance OTSClient telah diinisialisasi. Untuk informasi lebih lanjut, lihat Inisialisasi instance OTSClient.
Tabel data telah dibuat dan data telah ditulis ke tabel tersebut. Untuk informasi lebih lanjut, lihat Buat tabel data dan Tulis data.
Indeks pencarian telah dibuat untuk tabel data. Untuk informasi lebih lanjut, lihat Buat indeks pencarian.
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.
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.