全部产品
Search
文档中心

表格存储:通配符查询

更新时间:Jul 22, 2024

通配符查询中,要匹配的值可以是一个带有通配符的字符串,目前支持星号(*)和半角问号(?)两种通配符。要匹配的值中可以用星号(*)代表任意字符序列,或者用问号(?)代表任意单个字符,且支持以星号(*)或半角问号(?)开头。例如查询“table*e”,可以匹配到“tablestore”。

如果查询的模式为*word*(等价于SQL中的WHERE field_a LIKE '%word%'),则您可以使用性能更好的模糊查询,具体实现方法请参见模糊查询。该方案不会随数据量变大而导致性能下降。

说明

如果要实现NOT LIKE功能,则WildcardQuery需要和BoolQuery中的must_not_queries结合使用。

前提条件

参数

参数

描述

table_name

数据表名称。

index_name

多元索引名称。

offset

本次查询的开始位置。

limit

本次查询需要返回的最大数量。

get_total_count

是否返回匹配的总行数,默认为false,表示不返回表中数据的总行数。

设置get_total_count为true后会影响查询性能。

query_type

设置查询类型为QueryTypeConst::WILDCARD_QUERY

field_name

列名称。

value

带有通配符的字符串,字符串长度不能超过32个字符。

sort

按照指定方式排序。更多信息,请参见排序和翻页

columns_to_get

是否返回所有列,包含return_type和return_names设置。

  • 当设置return_type为ColumnReturnTypeConst::RETURN_SPECIFIED时,可以通过return_names指定返回的列。

  • 当设置return_type为ColumnReturnTypeConst::RETURN_ALL时,表示返回所有列。

  • 当设置return_type为ColumnReturnTypeConst::RETURN_ALL_FROM_INDEX时,表示返回多元索引中的所有列。

  • 当设置return_type为ColumnReturnTypeConst::RETURN_NONE时,表示不返回所有列,只返回主键列。

示例

以下示例用于使用通配符查询表中keyword列值匹配"key*"的数据。

$request = array(
    'table_name' => 'php_sdk_test',
    'index_name' => 'php_sdk_test_search_index',
    'search_query' => array(
        'offset' => 0,
        'limit' => 2,
        'get_total_count' => true,
        'query' => array(
            'query_type' => QueryTypeConst::WILDCARD_QUERY,
            'query' => array(
                'field_name' => 'keyword',
                'value' => 'key*'
            )
        ),
        'sort' => array(
            array(
                'field_sort' => array(
                    'field_name' => 'keyword',
                    'order' => SortOrderConst::SORT_ORDER_ASC
                )
            ),
        )
    ),
    'columns_to_get' => array(
        'return_type' => ColumnReturnTypeConst::RETURN_SPECIFIED,
        'return_names' => array('keyword')
    )
);
$response = $otsClient->search($request);

常见问题

相关文档