Anda dapat menggunakan kueri tepat untuk menanyakan baris-baris di mana nilai dari suatu kolom tertentu cocok persis dengan kata kunci yang ditentukan. Kueri ini mirip dengan pencocokan string berdasarkan kondisi eksak. Jika kolom TEXT digunakan untuk mencocokkan kata kunci dan setidaknya salah satu token dalam baris cocok persis dengan kata kunci, maka baris tersebut memenuhi kondisi kueri. Kata kunci tidak dipecah menjadi token.
Prasyarat
Sebuah instance OTSClient telah diinisialisasi. Untuk informasi lebih lanjut, lihat Inisialisasi Instance OTSClient.
Tabel data telah dibuat dan data telah ditulis ke tabel data. 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 |
NamaKolom | Nama kolom yang ingin Anda cocokkan. |
Kata Tepat | Kata kunci yang digunakan untuk mencocokkan nilai kolom saat Anda melakukan kueri tepat. Kata ini tidak dipecah menjadi token. Sebaliknya, seluruh kata digunakan untuk mencocokkan nilai-nilai kolom. Jika tipe kolom adalah TEXT, Tablestore akan memecah string dan menggunakan token-token tersebut untuk mencocokkan kata kunci. Baris memenuhi kondisi kueri jika setidaknya salah satu token dalam baris cocok persis dengan kata kunci. Misalnya, jika nilai kolom bertipe TEXT dalam sebuah baris adalah "tablestore is cool", nilainya dapat dipecah menjadi "tablestore", "is", dan "cool". Baris tersebut memenuhi kondisi kueri jika Anda menentukan "tablestore", "is", atau "cool" sebagai kata kunci untuk mencocokkan nilai kolom. |
DapatkanJumlahTotal | Menentukan apakah jumlah total baris yang memenuhi kondisi kueri dikembalikan. Nilai default parameter ini adalah false, yang menentukan bahwa jumlah total baris yang memenuhi kondisi kueri tidak dikembalikan. Jika Anda mengatur parameter ini ke true, performa kueri akan terpengaruh. |
Kueri | Tipe kueri. Untuk menggunakan kueri tepat, atur parameter ini ke TermQuery. |
NamaTabel | Nama tabel data. |
NamaIndeks | Nama indeks pencarian. |
KolomUntukDiambil | Menentukan apakah semua kolom dari setiap baris yang memenuhi kondisi kueri dikembalikan. Anda dapat mengonfigurasi ReturnAll, Columns, 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-kolom yang ingin Anda kembalikan. Jika Anda tidak menggunakan metode berikut untuk menentukan kolom-kolom yang ingin Anda kembalikan, hanya kolom kunci utama yang dikembalikan.
Jika Anda mengatur ReturnAll ke true, semua kolom dikembalikan. |
Contoh
Berikut adalah contoh kode untuk menanyakan baris-baris di mana nilai kolom Keyword_type_col cocok persis dengan SearchIndex:
/// <summary>
/// Cari tabel untuk baris-baris di mana nilai kolom Keyword_type_col cocok persis dengan SearchIndex.
/// </summary>
/// <param name="otsClient"></param>
public static void TermQuery(OTSClient otsClient)
{
var searchQuery = new SearchQuery();
// Tentukan bahwa jumlah total baris yang memenuhi kondisi kueri dikembalikan.
searchQuery.GetTotalCount = true;
// Atur tipe kueri ke TermQuery, kolom yang ingin Anda cocokkan ke Keyword_type_col, dan kata kunci ke SearchIndex.
searchQuery.Query = new TermQuery("Keyword_type_col", new ColumnValue("SearchIndex"));
var request = new SearchRequest(TableName, IndexName, searchQuery);
// Anda dapat mengonfigurasi parameter ColumnsToGet untuk menentukan kolom-kolom yang ingin Anda kembalikan, tentukan bahwa semua kolom dikembalikan, atau tentukan bahwa semua kolom dalam indeks pencarian dikembalikan. Jika Anda tidak mengonfigurasi parameter ini, hanya kolom kunci utama yang dikembalikan.
request.ColumnsToGet = new ColumnsToGet()
{
// Tentukan bahwa semua kolom dalam indeks pencarian dikembalikan.
ReturnAllFromIndex = true
// Tentukan kolom-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
};
var response = otsClient.Search(request);
// Periksa nilai NextToken.
}Pertanyaan Umum
Referensi
Saat menggunakan indeks pencarian untuk menanyakan data, Anda dapat menggunakan metode kueri berikut: kueri tepat, 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-baris yang memenuhi kondisi kueri menggunakan fitur Pengurutan dan paging. Untuk informasi lebih lanjut, lihat Pengurutan dan Paging.
Fitur collapse (distinct) dapat digunakan 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).
Untuk menganalisis data dalam tabel data, Anda dapat menggunakan fitur agregasi operasi Search atau menjalankan pernyataan SQL. Misalnya, Anda dapat memperoleh nilai minimum, maksimum, jumlah, dan total 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 Pemindaian Paralel.