多条件组合查询 - SDK 参考| 阿里云

前提条件

已初始化OTSClient，详情请参见初始化。
已创建数据表并写入数据。
已在数据表上创建多元索引，详情请参见创建多元索引。

参数


参数	说明
must_queries	多个Query列表，行数据必须满足所有的子查询条件才算匹配，等价于And操作符。
must_not_queries	多个Query列表，行数据必须不能满足任何的子查询条件才算匹配，等价于Not操作符。
filter_queries	多个Query列表，行数据必须满足所有的子filter才算匹配，filter类似于query，区别是filter不会根据满足的filter个数进行相关性算分。
should_queries	多个Query列表，可以满足，也可以不满足，等价于Or操作符。行数据应该至少满足should_queries子查询条件的最小匹配个数才算匹配。如果满足的should_queries子查询条件个数越多，则整体的相关性分数更高。
minimum_should_match	should_queries子查询条件的最小匹配个数。默认值为1。
table_name	数据表名称。
index_name	多元索引名称。

示例

5.2.1及之后版本

使用5.2.1及之后的SDK版本时，默认的返回结果为SearchResponse对象，请求示例如下：

# k > 'key100' and (l > 110 and l < 200) and not (k = 'key121')
# and should_queries(k > 'key120' or l < 300, minimum_should_match=2)
bool_query = BoolQuery(
    must_queries=[
        RangeQuery('k', range_from='key100', include_lower=False),
        //多条件组合查询。
        BoolQuery(
            //设置需要满足的子查询条件。
            must_queries=[
                RangeQuery('l', range_from=110, include_lower=False),
                RangeQuery('l', range_to=200, include_upper=False)
            ],
        )
    ],
    //设置需要排除的子查询条件。
    must_not_queries=[
        TermQuery('k', 'key121')
    ],
    should_queries=[
        RangeQuery('k', range_from='key120', include_lower=False),
        RangeQuery('l', range_to=300, include_upper=130)
    ],
    minimum_should_match=2
)

//构造完整查询语句，包括排序的列，返回前100行以及返回查询结果总的行数。
search_response = client.search(
    table_name, index_name, 
    SearchQuery(
        bool_query, 
        sort=Sort(sorters=[FieldSort('l', SortOrder.ASC)]), 
        limit=100, 
        get_total_count=True), 
    ColumnsToGet(return_type=ColumnReturnType.ALL)
)

如果需要返回Tuple类型结果，您可以使用如下请求示例实现。

# k > 'key100' and (l > 110 and l < 200) and not (k = 'key121')
# and should_queries(k > 'key120' or l < 300, minimum_should_match=2)
bool_query = BoolQuery(
    must_queries=[
        RangeQuery('k', range_from='key100', include_lower=False),
        //多条件组合查询。
        BoolQuery(
            //设置需要满足的子查询条件。
            must_queries=[
                RangeQuery('l', range_from=110, include_lower=False),
                RangeQuery('l', range_to=200, include_upper=False)
            ],
        )
    ],
    //设置需要排除的子查询条件。
    must_not_queries=[
        TermQuery('k', 'key121')
    ],
    should_queries=[
        RangeQuery('k', range_from='key120', include_lower=False),
        RangeQuery('l', range_to=300, include_upper=130)
    ],
    minimum_should_match=2
)

//构造完整查询语句，包括排序的列，返回前100行以及返回查询结果总的行数。
rows, next_token, total_count, is_all_succeed, agg_results, group_by_results = client.search(
    table_name, index_name, 
    SearchQuery(
        bool_query, 
        sort=Sort(sorters=[FieldSort('l', SortOrder.ASC)]), 
        limit=100, 
        get_total_count=True), 
    ColumnsToGet(return_type=ColumnReturnType.ALL)
).v1_response()

5.2.1之前版本

使用5.2.1之前的SDK版本时，默认的返回结果为Tuple类型，请求示例如下：

# k > 'key100' and (l > 110 and l < 200) and not (k = 'key121')
# and should_queries(k > 'key120' or l < 300, minimum_should_match=2)
bool_query = BoolQuery(
    must_queries=[
        RangeQuery('k', range_from='key100', include_lower=False),
        //多条件组合查询。
        BoolQuery(
            //设置需要满足的子查询条件。
            must_queries=[
                RangeQuery('l', range_from=110, include_lower=False),
                RangeQuery('l', range_to=200, include_upper=False)
            ],
        )
    ],
    //设置需要排除的子查询条件。
    must_not_queries=[
        TermQuery('k', 'key121')
    ],
    should_queries=[
        RangeQuery('k', range_from='key120', include_lower=False),
        RangeQuery('l', range_to=300, include_upper=130)
    ],
    minimum_should_match=2
)

//构造完整查询语句，包括排序的列，返回前100行以及返回查询结果总的行数。
rows, next_token, total_count, is_all_succeed = client.search(
    table_name, index_name, 
    SearchQuery(
        bool_query, 
        sort=Sort(sorters=[FieldSort('l', SortOrder.ASC)]), 
        limit=100, 
        get_total_count=True), 
    ColumnsToGet(return_type=ColumnReturnType.ALL)
)