PHP SDK通配符查询_表格存储(Tablestore)-阿里云帮助中心

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

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

说明

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

前提条件

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

参数

参数	描述
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);

通配符查询

前提条件

参数

示例

常见问题

相关文档