Gunakan Tablestore SDK untuk .NET guna menjalankan kueri wildcard - Tablestore

Saat menjalankan kueri wildcard, Anda dapat menggunakan karakter wildcard tanda bintang (*) dan tanda tanya (?) dalam kueri untuk mencari data. Tanda bintang (*) cocok dengan string apa pun yang memiliki panjang berapa pun, baik di awal, tengah, maupun akhir istilah pencarian. Tanda tanya (?) cocok dengan satu karakter pada posisi tertentu. String yang dicocokkan dapat dimulai dengan tanda bintang (*) atau tanda tanya (?). Misalnya, jika Anda mencari string "table*e", maka "tablestore" dapat ditemukan.

Jika pola kueri adalah *word* (setara dengan WHERE field_a LIKE '%word%' dalam SQL), Anda dapat menggunakan fitur kueri wildcard berbasis token untuk performa yang lebih baik. Performa tidak menurun seiring peningkatan volume data.

Catatan

Untuk menggunakan operator NOT LIKE, Anda harus menggabungkan WildcardQuery dengan mustNotQueries dari BoolQuery.

Prasyarat

Instans OTSClient telah diinisialisasi. Untuk informasi selengkapnya, lihat Inisialisasi instans OTSClient.
Tabel data telah dibuat dan data telah ditulis ke tabel tersebut. Untuk informasi selengkapnya, lihat Membuat tabel data dan Menulis data.
Indeks pencarian telah dibuat untuk tabel data. Untuk informasi selengkapnya, lihat Buat indeks pencarian.

Parameter

Parameter	Deskripsi
Query	Jenis kueri. Tetapkan parameter ini ke WildcardQuery.
FieldName	Nama kolom yang ingin Anda kueri.
Value	String yang berisi karakter wildcard. Panjang string tidak boleh melebihi 32 karakter.
TableName	Nama tabel data.
IndexName	Nama indeks pencarian.
GetTotalCount	Menentukan apakah jumlah total baris yang memenuhi kondisi kueri dikembalikan. Nilai default: false. Jika Anda menetapkan parameter ini ke true, performa kueri akan menurun.
ColumnsToGet	Menentukan apakah semua kolom dalam baris yang memenuhi kondisi kueri dikembalikan. Anda dapat menentukan parameter ReturnAll, Columns, dan ReturnAllFromIndex. Nilai default ReturnAll adalah false, yang berarti tidak semua kolom dikembalikan. Anda dapat menggunakan salah satu metode berikut untuk menentukan kolom yang ingin dikembalikan. Jika Anda tidak menggunakan metode berikut, hanya kolom kunci primer yang dikembalikan. Konfigurasikan Columns untuk menentukan kolom yang ingin dikembalikan. Tetapkan ReturnAllFromIndex ke true untuk mengembalikan semua kolom dari indeks pencarian. Jika Anda menetapkan ReturnAll ke true, semua kolom akan dikembalikan.

Contoh

Kode contoh berikut menunjukkan cara mengkueri baris yang nilai kolom Keyword_type_col-nya sesuai dengan "Search*" dalam sebuah tabel.

/// <summary>
/// Kueri baris yang nilai kolom Keyword_type_col-nya sesuai dengan "Search*" dalam sebuah tabel.
/// </summary>
/// <param name="otsClient"></param>
public static void WildcardQuery(OTSClient otsClient)
{
    var searchQuery = new SearchQuery();
    // Tetapkan jenis kueri ke WildcardQuery dan tentukan string yang berisi satu atau beberapa karakter wildcard untuk menjalankan kueri wildcard.
    searchQuery.Query = new WildcardQuery(Keyword_type_col, "*Search*");
    // Kembalikan jumlah total baris yang memenuhi kondisi kueri.
    searchQuery.GetTotalCount = true;
    var request = 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 primer yang dikembalikan.
    request.ColumnsToGet = new ColumnsToGet()
    {
        // Kembalikan semua kolom dalam indeks pencarian.
        ReturnAllFromIndex = true
        // Kembalikan kolom yang Anda tentukan.
        //Columns = new List<string>() { Long_type_col, Text_type_col, Keyword_type_col }
        // Kembalikan semua kolom dalam baris yang memenuhi kondisi kueri.
        //ReturnAll = true
    };

    var response = otsClient.Search(request);

    Console.WriteLine("Total Count:" + response.TotalCount); // Tampilkan jumlah total baris yang memenuhi kondisi kueri, bukan jumlah baris yang dikembalikan.
}

FAQ

Referensi

Saat menggunakan indeks pencarian untuk mengkueri data, Anda dapat menggunakan metode kueri berikut: kueri tepat, kueri istilah, Pencocokan semua kueri, kueri cocok, permintaan pencocokan frasa, kueri awalan, kueri rentang, kueri wildcard, Boolean query, kueri geografis, kueri bersarang, dan kueri eksistensi. Anda dapat menggunakan berbagai metode kueri ini untuk mengkueri data dari berbagai dimensi sesuai kebutuhan bisnis Anda.

Anda dapat mengurutkan atau menerapkan paginasi pada baris yang memenuhi kondisi kueri dengan menggunakan fitur pengurutan dan paginasi. Untuk informasi selengkapnya, lihat Pengurutan dan paginasi.

Anda dapat menggunakan fitur collapse (distinct) untuk menciutkan set hasil berdasarkan kolom tertentu sehingga data jenis tertentu hanya muncul sekali dalam hasil kueri. Untuk informasi selengkapnya, lihat Collapse (distinct).
Untuk menganalisis data dalam tabel data, Anda dapat menggunakan fitur agregasi dari operasi Search atau mengeksekusi pernyataan SQL, seperti memperoleh nilai minimum dan maksimum, jumlah total, serta jumlah baris. Untuk informasi selengkapnya, lihat Agregasi dan Kueri SQL.
Untuk memperoleh semua baris yang memenuhi kondisi kueri tanpa perlu mengurutkannya, Anda dapat memanggil operasi ParallelScan dan ComputeSplits untuk menggunakan fitur pemindaian paralel. Untuk informasi selengkapnya, lihat Pemindaian paralel.