BoolQuery查询条件包含一个或者多个子查询条件,根据子查询条件来判断一行数据是否满足查询条件。每个子查询条件可以是任意一种Query类型,包括BoolQuery。

前提条件

  • 已初始化Client。具体操作,请参见初始化
  • 已创建数据表并写入数据。
  • 已在数据表上创建多元索引。具体操作,请参见创建多元索引

参数

参数说明
TableName数据表名称。
IndexName多元索引名称。
MustQueries多个Query列表,行数据必须满足所有的子查询条件才算匹配,等价于And操作符。
MustNotQueries多个Query列表,行数据必须不能满足任何的子查询条件才算匹配,等价于Not操作符。
FilterQueries多个Query列表,行数据必须满足所有的子Filter才算匹配,Filter类似于Query,区别是Filter不会根据满足的Filter个数进行相关性算分。
ShouldQueries多个Query列表,可以满足,也可以不满足,等价于Or操作符。

行数据应该至少满足ShouldQueries子查询条件的最小匹配个数才算匹配。

如果满足的ShouldQueries子查询条件个数越多,则整体的相关性分数更高。

MinimumShouldMatchShouldQueries子查询条件的最小匹配个数。当同级没有其他Query,只有ShouldQueries时,默认值为1;当同级已有其他Query,例如MustQueries、MustNotQueries和FilterQueries时,默认值为0。

示例

通过BoolQuery进行多条件组合查询。

/**
 * 通过BoolQuery进行多条件组合查询。
 */
func BoolQuery(client *tablestore.TableStoreClient, tableName string, indexName string) {
    searchRequest := &tablestore.SearchRequest{}
    searchRequest.SetTableName(tableName)
    searchRequest.SetIndexName(indexName)

    /**
     * 查询条件一:RangeQuery,Col_Long的列值大于3。
     */
    rangeQuery := &search.RangeQuery{}
    rangeQuery.FieldName = "Col_Long"
    rangeQuery.GT(3)

    /**
     * 查询条件二:MatchQuery,Col_Keyword的列值要匹配"hangzhou"。
     */
    matchQuery := &search.MatchQuery{}
    matchQuery.FieldName = "Col_Keyword"
    matchQuery.Text = "hangzhou"

    {
        /**
         * 构造一个BoolQuery,设置查询条件是必须同时满足"查询条件一"和"查询条件二"。
         */
        boolQuery := &search.BoolQuery{
            MustQueries: []search.Query{
                rangeQuery,
                matchQuery,
            },
        }
        searchQuery := search.NewSearchQuery()
        searchQuery.SetQuery(boolQuery)
        searchRequest.SetSearchQuery(searchQuery)
        searchResponse, err := client.Search(searchRequest)
        if err != nil {
            fmt.Printf("%#v", err)
            return
        }
        fmt.Println("IsAllSuccess: ", searchResponse.IsAllSuccess) //查看返回结果是否完整。
        fmt.Println("TotalCount: ", searchResponse.TotalCount) //打印匹配的总行数,非返回行数。
        fmt.Println("RowCount: ", len(searchResponse.Rows))
    }
    {
        /**
         * 构造一个BoolQuery,设置查询条件是至少满足"条件一"和"条件二"中的一个。
         */
        boolQuery := &search.BoolQuery{
            ShouldQueries: []search.Query{
                rangeQuery,
                matchQuery,
            },
            MinimumShouldMatch: proto.Int32(1),
        }
        searchQuery := search.NewSearchQuery()
        searchQuery.SetQuery(boolQuery)
        searchRequest.SetSearchQuery(searchQuery)
        searchResponse, err := client.Search(searchRequest)
        if err != nil {
            fmt.Printf("%#v", err)
            return
        }
        fmt.Println("IsAllSuccess: ", searchResponse.IsAllSuccess) //查看返回结果是否完整。
        fmt.Println("TotalCount: ", searchResponse.TotalCount) //打印匹配的总行数,非返回行数。
        fmt.Println("RowCount: ", len(searchResponse.Rows))
    }
}