全部产品
Search
文档中心

Tablestore:Lakukan kueri awalan

更新时间:Jul 02, 2025

Anda dapat menjalankan kueri awalan untuk menemukan data yang memiliki awalan tertentu. Jika kolom yang digunakan dalam kondisi kueri bertipe TEXT, nilai kolom tersebut akan di-tokenisasi. Sebuah baris memenuhi kondisi kueri jika nilai token dari kolom yang ditentukan berisi setidaknya satu istilah dengan awalan yang sesuai.

Prasyarat

Parameter

Parameter

Deskripsi

FieldName

Nama kolom yang ingin Anda tanyakan.

Prefix

Awalan yang digunakan untuk mencocokkan nilai kolom saat Anda melakukan kueri awalan.

Jika kolom yang digunakan untuk mencocokkan kondisi kueri bertipe TEXT, nilai kolom tersebut akan di-tokenisasi. Sebuah baris memenuhi kondisi kueri ketika nilai token dari kolom yang ditentukan berisi setidaknya satu istilah yang mengandung awalan yang ditentukan.

GetTotalCount

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, performa kueri akan terpengaruh.

Query

Tipe kueri. Atur parameter ini ke PrefixQuery.

TableName

Nama tabel data.

IndexName

Nama indeks pencarian.

ColumnsToGet

Menentukan apakah akan mengembalikan semua kolom dalam baris yang memenuhi kondisi kueri. Anda dapat menentukan parameter ReturnAll, Columns, dan ReturnAllFromIndex.

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 Columns 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 dikembalikan.

Contoh

Berikut adalah contoh kode yang menunjukkan cara menanyakan baris di mana nilai kolom Keyword_type_col berisi awalan "Search" dalam sebuah tabel.

/// <summary>
/// Query the rows in which the value of the Keyword_type_col column contains the "Search" prefix in a table. 
/// </summary>
/// <param name="otsClient"></param>
public static void PrefixQuery(OTSClient otsClient)
{
    var searchQuery = new SearchQuery();
    // Set the query type to PrefixQuery, the column that you want to match to Keyword_type_col, and the prefix to "Search". 
    searchQuery.Query = new PrefixQuery("Keyword_type_col", "Search");
    // Return the total number of rows that meet the query conditions. 
    searchQuery.GetTotalCount = true;
    var request = new SearchRequest(TableName, IndexName, searchQuery);
    // You can specify the ColumnsToGet parameter to return the columns that you specify, all columns in the rows that meet the query conditions, or all columns in the search index. If you do not specify this parameter, only the primary key columns are returned. 
    request.ColumnsToGet = new ColumnsToGet()
    {
        // Return all columns in the search index. 
        ReturnAllFromIndex = true
        // Return the columns that you specify. 
        //Columns = new List<string>() { Long_type_col, Text_type_col, Keyword_type_col }
        // Return all columns in the rows that meet the query conditions. 
        //ReturnAll = true         
    };

    var response = otsClient.Search(request);

    Console.WriteLine("Total Count:" + response.TotalCount); // Display the total number of rows that meet the query conditions instead of the number of returned rows. 
}

FAQ

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 awalan, kueri rentang, kueri wildcard, kueri Boolean, kueri geo, kueri nested, dan kueri exists. Metode kueri ini dapat digunakan untuk menanyakan data dari beberapa dimensi sesuai 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 merangkum set hasil berdasarkan kolom tertentu sehingga data dari jenis 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 dari 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 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.