Anda dapat menggunakan fitur kueri cocok semua untuk mencocokkan seluruh baris dalam tabel, baik untuk menanyakan jumlah total baris maupun mengembalikan beberapa baris acak.
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 |
Kueri | Jenis kueri. Atur parameter ini ke MatchAllQuery. |
NamaTabel | Nama tabel data. |
NamaIndeks | Nama indeks pencarian. |
Batas | Jumlah maksimum baris yang ingin Anda kembalikan dalam kueri saat ini. Untuk menanyakan hanya jumlah baris yang memenuhi kondisi kueri tanpa data spesifik, atur parameter ini ke 0. |
DapatkanJumlahTotal | Menentukan apakah akan mengembalikan jumlah total baris yang memenuhi kondisi kueri. Nilai default: false, yang menunjukkan bahwa jumlah total baris yang memenuhi kondisi kueri tidak dikembalikan. Jika Anda mengatur parameter ini ke true, kinerja kueri akan terganggu. |
ColumnsToGet | Menentukan apakah akan mengembalikan semua kolom dalam baris yang memenuhi kondisi kueri. Anda dapat menentukan parameter ReturnAll, Columns, dan ReturnAllFromIndex. Nilai default dari 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 dikembalikan. |
Contoh
Kode sampel berikut menunjukkan cara menanyakan jumlah total baris dalam tabel.
/// <summary>
/// Lakukan kueri cocok semua untuk menanyakan jumlah total baris dalam tabel.
/// </summary>
/// <param name="otsClient"></param>
public static void MatchAllQuery(OTSClient otsClient)
{
var searchQuery = new SearchQuery();
searchQuery.Query = new MatchAllQuery();
searchQuery.GetTotalCount = true; // Atur parameter GetTotalCount ke true untuk mengembalikan jumlah total baris yang memenuhi kondisi kueri.
/*
* Dalam hasil kueri cocok semua, nilai parameter TotalCount menunjukkan jumlah total baris dalam tabel.
* Untuk menanyakan hanya jumlah baris yang memenuhi kondisi kueri tanpa data spesifik, atur parameter Limit ke 0.
*/
searchQuery.Limit = 0;
var request = new SearchRequest(TableName, IndexName, searchQuery);
var response = otsClient.Search(request);
// Periksa apakah semua baris yang memenuhi kondisi kueri dikembalikan. Jika nilai parameter isAllSuccess adalah false, Tablestore mungkin gagal menanyakan data pada beberapa server, dan tidak semua baris yang memenuhi kondisi kueri dikembalikan.
Console.WriteLine("IsAllSuccess:" + response.IsAllSuccess);
Console.WriteLine("Total Count:" + response.TotalCount);
}Pertanyaan Umum
Bagaimana cara saya menanyakan jumlah total baris dalam tabel?
Referensi
Saat menggunakan indeks pencarian untuk menanyakan data, Anda dapat memilih dari metode kueri berikut: kueri tepat, kueri terms, kueri cocok semua, kueri cocok, kueri frasa cocok, kueri awalan, kueri rentang, kueri wildcard, kueri Boolean, kueri geo, kueri bersarang, dan kueri eksis. Metode ini memungkinkan Anda menanyakan data dari berbagai dimensi sesuai dengan kebutuhan bisnis Anda.
Anda dapat mengurutkan atau membagi halaman hasil 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 tipe data yang ditentukan hanya muncul sekali dalam hasil kueri. Untuk informasi lebih lanjut, lihat Collapse (distinct).
Untuk analisis data dalam tabel, Anda dapat menggunakan fitur agregasi operasi Pencarian atau menjalankan pernyataan SQL. Misalnya, Anda bisa mendapatkan 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 pengurutan, Anda dapat menggunakan operasi ParallelScan dan ComputeSplits melalui fitur pemindaian paralel. Untuk informasi lebih lanjut, lihat Pemindaian Paralel.