全部產品
Search
文件中心

:範圍查詢

更新時間:Nov 13, 2024

本文介紹如何使用Java SDK實現多元索引的範圍查詢,您可以指定範圍條件查詢需要的資料。

前提條件

參數說明

參數

說明

query

設定查詢類型為範圍查詢RangeQuery,包括以下內容:

  • fieldName:要匹配的欄位。

    說明

    對於Text類型的欄位,只要欄位值分詞後存在滿足範圍條件的詞條即可。

  • from:起始位置的值。

    設定範圍條件時,大於(>)可以使用greaterThan表示,大於等於(>=)可以使用greaterThanOrEqual表示。

  • to:結束位置的值。

    設定範圍條件時,小於(<)可以使用lessThan表示;小於等於(<=)可以使用lessThanOrEqual表示。

  • includeLower:當設定範圍條件為大於(>)起始位置的值時,結果是否包含起始位置的值。預設值為 false,即不包含起始位置的值。

  • includeUpper:當設定範圍條件為小於(<)結束位置的值時,結果是否包含結束位置的值。預設值為 false,即不包含結束位置的值。

sort

按照指定方式排序,詳情請參見排序和翻頁

getTotalCount

是否返回匹配的總行數。預設值為false,表示不返回。

返回匹配的總行數會影響查詢效能。

tableName

資料表名稱。

indexName

多元索引名稱。

columnsToGet

是否返回所有列,包含returnAll和columns設定。

returnAll預設值為false,表示不返回所有列,此時可以通過columns指定返回的列;如果未通過columns指定返回的列,則只返回主鍵列。

當設定returnAll為true時,表示返回所有列。

樣本

private static void rangeQuery(SyncClient client) {
    SearchQuery searchQuery = new SearchQuery();
    RangeQuery rangeQuery = new RangeQuery(); //設定查詢類型為RangeQuery。
    
    /**
     * 樣本1:查詢 Col_Long > 3
     */
    rangeQuery.setFieldName("Col_Long");
    rangeQuery.greaterThan(ColumnValue.fromLong(3));
    
    /**
     * //樣本2:查詢 '2020-01-01 10:55:12' <= Col_Date_String < '2021-03-03 08:20:50'
     * //Col_Date_String列在資料表中的資料類型為"字串(String)",映射到多元索引的資料類型為"日期時間類型(Date)"、時間格式為"yyyy-MM-dd HH:mm:ss"。
     * rangeQuery.setFieldName("Col_Date_String");
     * rangeQuery.greaterThanOrEqual(ColumnValue.fromString("2020-01-01 10:55:12"));
     * rangeQuery.lessThan(ColumnValue.fromString("2021-03-03 08:20:50"));
     */
     
    /**
     * //樣本3:查詢 Col_Date_Long > 1731036722(時間戳記-秒)
     * //Col_Date_Long列在資料表中的資料類型為"整型(Integer)",映射到多元索引的資料類型為"日期時間類型(Date)"、預定義格式為"秒時間戳記"。
     * rangeQuery.setFieldName("Col_Date_Long");
     * rangeQuery.greaterThan(ColumnValue.fromLong(1731036722));
     */
     
    searchQuery.setQuery(rangeQuery);
    searchQuery.setGetTotalCount(true); //設定返回匹配的總行數。
    SearchRequest searchRequest = new SearchRequest("<TABLE_NAME>", "<SEARCH_INDEX_NAME>", searchQuery);
    //通過設定columnsToGet參數可以指定返回的列或返回所有列,如果不設定此參數,則預設只返回主鍵列。
    //SearchRequest.ColumnsToGet columnsToGet = new SearchRequest.ColumnsToGet();
    //設定為返回所有列。
    //columnsToGet.setReturnAll(true);
    //設定為返回指定列。
    //columnsToGet.setColumns(Arrays.asList("ColName1","ColName2"));
    //searchRequest.setColumnsToGet(columnsToGet);
    SearchResponse resp = client.search(searchRequest);
    
    //System.out.println("TotalCount: " + resp.getTotalCount());//列印匹配到的總行數,非返回行數。
    System.out.println("Row: " + resp.getRows());
}

常見問題

相關文檔