BoolQuery查詢條件包含一個或者多個子查詢條件,根據子查詢條件來判斷一行資料是否滿足查詢條件。每個子查詢條件可以是任意一種Query類型,包括BoolQuery。
介面
多條件組合查詢的介面為Search或者ParallelScan,具體的Query類型為BoolQuery。
使用
您可以使用如下語言的SDK實現多條件組合查詢。
參數
參數 | 說明 |
---|---|
mustQueries | 多個Query列表,行資料必須滿足所有的子查詢條件才算匹配,等價於And操作符。 |
mustNotQueries | 多個Query列表,行資料必須不能滿足任何的子查詢條件才算匹配,等價於Not操作符。 |
filterQueries | 多個Query列表,行資料必須滿足所有的子filter才算匹配,filter類似於query,區別是filter不會根據滿足的filterQueries個數進行相關性算分。 |
shouldQueries | 多個Query列表,可以滿足,也可以不滿足,等價於Or操作符。
一行資料應該至少滿足shouldQueries子查詢條件的最小匹配個數才算匹配。 如果滿足的shouldQueries子查詢條件個數越多,則整體的相關性分數更高。 |
minimumShouldMatch | shouldQueries子查詢條件的最小匹配個數。當同級沒有其他Query,只有shouldQueries時,預設值為1;當同級已有其他Query,例如mustQueries、mustNotQueries和filterQueries時,預設值為0。 |
getTotalCount | 是否返回匹配的總行數,預設為false,表示不返回。
返回匹配的總行數會影響查詢效能。 |
tableName | 資料表名稱。 |
indexName | 多元索引名稱。 |
columnsToGet | 是否返回所有列,包含returnAll和columns設定。
returnAll預設為false,表示不返回所有列,此時可以通過columns指定返回的列;如果未通過columns指定返回的列,則只返回主鍵列。 當設定returnAll為true時,表示返回所有列。 |
樣本
- 樣本1
通過BoolQuery進行And條件查詢。
/** * 通過BoolQuery進行And條件查詢。 * @param client */ public static void andQuery(SyncClient client){ /** * 查詢條件一:RangeQuery,Col_Long的列值大於3。 */ RangeQuery rangeQuery = new RangeQuery(); rangeQuery.setFieldName("Col_Long"); rangeQuery.greaterThan(ColumnValue.fromLong(3)); /** * 查詢條件二:MatchQuery,Col_Keyword的列值要匹配"hangzhou"。 */ MatchQuery matchQuery = new MatchQuery(); matchQuery.setFieldName("Col_Keyword"); matchQuery.setText("hangzhou"); SearchQuery searchQuery = new SearchQuery(); { /** * 構造一個BoolQuery,設定查詢條件為必須同時滿足"查詢條件一"和"查詢條件二"。 */ BoolQuery boolQuery = new BoolQuery(); boolQuery.setMustQueries(Arrays.asList(rangeQuery, matchQuery)); searchQuery.setQuery(boolQuery); //searchQuery.setGetTotalCount(true);//設定返回匹配的總行數。 SearchRequest searchRequest = new SearchRequest("sampleTable", "sampleSearchIndex", 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()); } }
- 樣本2
通過BoolQuery進行Or條件查詢。
/** * 通過BoolQuery進行Or條件查詢。 * @param client */ public static void orQuery(SyncClient client) { /** * 查詢條件一:RangeQuery,Col_Long的列值大於3。 */ RangeQuery rangeQuery = new RangeQuery(); rangeQuery.setFieldName("Col_Long"); rangeQuery.greaterThan(ColumnValue.fromLong(3)); /** * 查詢條件二:MatchQuery,Col_Keyword的列值要匹配"hangzhou"。 */ MatchQuery matchQuery = new MatchQuery(); matchQuery.setFieldName("Col_Keyword"); matchQuery.setText("hangzhou"); SearchQuery searchQuery = new SearchQuery(); { /** * 構造一個BoolQuery,設定查詢條件為至少滿足"條件一"和"條件二"中的一個條件。 */ BoolQuery boolQuery = new BoolQuery(); boolQuery.setShouldQueries(Arrays.asList(rangeQuery, matchQuery)); boolQuery.setMinimumShouldMatch(1); //設定至少滿足一個條件。 searchQuery.setQuery(boolQuery); //searchQuery.setGetTotalCount(true);//設定返回匹配的總行數。 SearchRequest searchRequest = new SearchRequest("sampleTable", "sampleSearchIndex", 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()); } }
- 樣本3
通過BoolQuery進行Not條件查詢。
/** * 通過BoolQuery進行Not條件查詢。 * @param client */ public static void notQuery(SyncClient client) { /** * 查詢條件一:MatchQuery,Col_Keyword的列值要匹配"hangzhou"。 */ MatchQuery matchQuery = new MatchQuery(); matchQuery.setFieldName("Col_Keyword"); matchQuery.setText("hangzhou"); SearchQuery searchQuery = new SearchQuery(); { /** * 構造一個BoolQuery,設定查詢條件為不滿足"查詢條件一"。 */ BoolQuery boolQuery = new BoolQuery(); boolQuery.setMustNotQueries(Arrays.asList(matchQuery)); searchQuery.setQuery(boolQuery); //searchQuery.setGetTotalCount(true);//設定返回匹配的總行數。 SearchRequest searchRequest = new SearchRequest("sampleTable", "sampleSearchIndex", 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()); } }
- 樣本4
含有子BoolQuery的組合查詢。使用多條件組合查詢實現(col2<4 or col3<5) or (col2 = 4 and (col3 = 5 or col3 =6)),每個and或or相當於一個BoolQuery,多個運算式的and或or就是多個BoolQuery的組合。
/** * (col2<4 or col3<5) or (col2 = 4 and (col3 = 5 or col3 =6)) * 使用多條件組合查詢上述運算式,每個and或or相當於一個BoolQuery,多個運算式的and或or就是多個BoolQuery的組合。 * @param client */ private static void boolQuery2(SyncClient client){ //條件1為col2<4。 RangeQuery rangeQuery1 = new RangeQuery(); rangeQuery1.setFieldName("col2"); rangeQuery1.lessThan(ColumnValue.fromLong(4)); //條件2為col3<5。 RangeQuery rangeQuery2 = new RangeQuery(); rangeQuery2.setFieldName("col3"); rangeQuery2.lessThan(ColumnValue.fromLong(5)); //條件3為col2=4。 TermQuery termQuery = new TermQuery(); termQuery.setFieldName("col2"); termQuery.setTerm(ColumnValue.fromLong(4)); //條件4為col3 = 5 or col3 = 6。 TermsQuery termsQuery = new TermsQuery(); termsQuery.setFieldName("col3"); termsQuery.addTerm(ColumnValue.fromLong(5)); termsQuery.addTerm(ColumnValue.fromLong(6)); SearchQuery searchQuery = new SearchQuery(); List<Query> queryList1 = new ArrayList<>(); queryList1.add(rangeQuery1); queryList1.add(rangeQuery2); //組合條件1為col2<4 OR col3<5。 BoolQuery boolQuery1 = new BoolQuery(); boolQuery1.setShouldQueries(queryList1); //組合條件2為col2=4 and (col3=5 or col3=6)。 List<Query> queryList2 = new ArrayList<>(); queryList2.add(termQuery); queryList2.add(termsQuery); BoolQuery boolQuery2 = new BoolQuery(); boolQuery2.setMustQueries(queryList2); //總組合條件為(col2<4 OR col3<5) or (col2=4 and (col3=5 or col3=6))。 List<Query> queryList3 = new ArrayList<>(); queryList3.add(boolQuery1); queryList3.add(boolQuery2); BoolQuery boolQuery = new BoolQuery(); boolQuery.setShouldQueries(queryList3); searchQuery.setQuery(boolQuery); //searchQuery.setGetTotalCount(true);//設定返回匹配的總行數。 SearchRequest searchRequest = new SearchRequest("sampleTable", "sampleSearchIndex", searchQuery); //通過設定columnsToGet參數可以指定返回的列或返回所有列,如果不設定此參數,則預設只返回主鍵列。 //SearchRequest.ColumnsToGet columnsToGet = new SearchRequest.ColumnsToGet(); //columnsToGet.setReturnAll(true); //設定為返回所有列。 //columnsToGet.setColumns(Arrays.asList("ColName1","ColName2")); //設定為返回指定列。 //searchRequest.setColumnsToGet(columnsToGet); SearchResponse response = client.search(searchRequest); //System.out.println("TotalCount: " + resp.getTotalCount()); //列印匹配到的總行數,非返回行數。 System.out.println(response.getRows()); }