.NET SDK萬用字元查詢 -

萬用字元查詢中，要匹配的值可以是一個帶有萬用字元的字串，目前支援星號（*）和半形問號（?）兩種萬用字元。要匹配的值中可以用星號（*）代表任一字元序列，或者用問號（?）代表任意單個字元，且支援以星號（*）或半形問號（?）開頭。例如查詢“table*e”，可以匹配到“tablestore”。

如果查詢的模式為*word*（等價於SQL中的WHERE field_a LIKE '%word%'），則您可以使用效能更好的模糊查詢，具體實現方法請參見模糊查詢。該方案不會隨資料量變大而導致效能下降。

說明

如果要實現NOT LIKE功能，則WildcardQuery需要和BoolQuery中的mustNotQueries結合使用。

前提條件

已初始化OTSClient。具體操作，請參見初始化OTSClient。
已建立資料表並寫入資料。具體操作，請參見建立資料表和寫入資料。
已在資料表上建立多元索引。具體操作，請參見建立多元索引。

參數

參數	描述
Query	設定查詢類型為WildcardQuery。
FieldName	列名稱。
Value	帶有萬用字元的字串，字串長度不能超過32個字元。
TableName	資料表名稱。
IndexName	多元索引名稱。
GetTotalCount	是否返回匹配的總行數，預設為false，表示不返回表中資料的總行數。設定GetTotalCount為true後會影響查詢效能。
ColumnsToGet	是否返回所有列。包含ReturnAll和Columns以及ReturnAllFromIndex設定。 ReturnAll預設為false，表示不返回所有列。此時可以通過如下任一設定返回所需列。如果未設定Columns和ReturnAllFromIndex，則只返回主鍵列。設定Columns指定返回的列。設定ReturnAllFromIndex為true返回多元索引中的所有列。當設定ReturnAll為true時，表示返回所有列。

樣本

以下樣本用於使用萬用字元查詢表中Keyword_type_col列的值中匹配"Search*"的資料。

/// <summary>
/// 使用萬用字元查詢，查詢表中Keyword_type_col列的值中匹配"Search*"的資料。
/// </summary>
/// <param name="otsClient"></param>
public static void WildcardQuery(OTSClient otsClient)
{
    var searchQuery = new SearchQuery();
    //設定查詢類型為WildcardQuery，要匹配的值支援萬用字元。
    searchQuery.Query = new WildcardQuery(Keyword_type_col, "*Search*");
    //設定返回匹配的總行數。
    searchQuery.GetTotalCount = true;
    var request = new SearchRequest(TableName, IndexName, searchQuery);
    //通過ColumnsToGet參數可以設定返回多元索引中所有列、返回指定列或返回所有列，如果不設定此參數，則預設只返回主鍵列。
    request.ColumnsToGet = new ColumnsToGet()
    {
        //設定為返回多元索引中所有列。
        ReturnAllFromIndex = true
        //設定為返回指定列。
        //Columns = new List<string>() { Long_type_col, Text_type_col, Keyword_type_col }
        //設定為返回所有列。
        //ReturnAll = true
    };

    var response = otsClient.Search(request);

    Console.WriteLine("Total Count:" + response.TotalCount); //列印匹配到的總行數，非返回行數。
}

：萬用字元查詢

前提條件

參數

樣本

常見問題

相關文檔