通配符查询_使用_多元索引_功能介绍_表格存储 Tablestore

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

限制

带有通配符的字符串长度不能超过10字节。

接口

通配符查询的接口为Search或者ParallelScan，具体的Query类型为WildcardQuery。

使用

您可以使用如下语言的SDK实现通配符查询。

参数


参数	描述
fieldName	列名称。
value	带有通配符的字符串，字符串长度不能超过10字节。
query	设置查询类型为WildcardQuery。
tableName	数据表名称。
indexName	多元索引名称。
columnsToGet	是否返回所有列。 ReturnAll默认为false，表示不返回所有列，此时可以通过ColumnsToGet指定返回的列；如果未通过ColumnsToGet指定返回的列，则只返回主键列。当设置ReturnAll为true时，表示返回所有列。
getTotalCount	是否返回匹配的总行数。返回匹配的总行数会影响查询性能。

示例

/**
 * 使用通配符查询，查询表中Col_Keyword列的值中匹配"hang*u"的数据。
 * @param client
 */
private static void wildcardQuery(SyncClient client) {
    SearchQuery searchQuery = new SearchQuery();
    WildcardQuery wildcardQuery = new WildcardQuery(); //设置查询类型为WildcardQuery。
    wildcardQuery.setFieldName("Col_Keyword");
    wildcardQuery.setValue("hang*u"); //wildcardQuery支持通配符。
    searchQuery.setQuery(wildcardQuery);
    SearchRequest searchRequest = new SearchRequest(TABLE_NAME, INDEX_NAME, searchQuery);

    SearchRequest.ColumnsToGet columnsToGet = new SearchRequest.ColumnsToGet();
    columnsToGet.setReturnAll(true); //设置为返回所有列。
    searchRequest.setColumnsToGet(columnsToGet);

    SearchResponse resp = client.search(searchRequest);

    System.out.println("TotalCount: " + resp.getTotalCount()); //打印匹配到的总行数，非返回行数。
    System.out.println("Row: " + resp.getRows());
}