Todos os produtos
Search

Este produto

    Tablestore:Consulta com curinga

    Central de documentação

    Tablestore:Consulta com curinga

    Última atualização: Jul 03, 2026

    Em consultas com curinga, use os caracteres asterisco () e ponto de interrogação (?) para buscar dados. O asterisco () corresponde a uma string de qualquer comprimento no início, meio ou fim do termo de busca. O ponto de interrogação (?) substitui um único caractere em uma posição específica. A string pode começar com asterisco () ou ponto de interrogação (?). Por exemplo, ao buscar pela string "tablee", o termo "tablestore" será encontrado.

    Se o padrão de consulta for *word* (equivalente a WHERE field_a LIKE '%word%' em SQL), use o recurso de consultas com curinga baseadas em token para obter melhor desempenho. Essa abordagem mantém a performance mesmo com o aumento do volume de dados.

    Nota

    Para usar o operador NOT LIKE, combine WildcardQuery com must_not_queries do BoolQuery.

    Pré-requisitos

    Parâmetros

    Parâmetro

    Descrição

    table_name

    Nome da tabela de dados.

    index_name

    Nome do índice de busca.

    offset

    Posição inicial da consulta atual.

    limit

    Número máximo de linhas retornadas pela consulta atual.

    get_total_count

    Define se o número total de linhas correspondentes às condições da consulta deve ser retornado. O valor padrão é false, indicando que a contagem total não será incluída na resposta.

    Definir get_total_count como true impacta negativamente o desempenho da consulta.

    query_type

    Tipo da consulta. Defina este parâmetro como QueryTypeConst::WILDCARD_QUERY.

    field_name

    Nome da coluna a ser consultada.

    value

    String com caracteres curinga. O tamanho máximo permitido é de 32 caracteres.

    sort

    Método de ordenação das linhas na resposta. Para mais informações, consulte Ordenação e paginação.

    columns_to_get

    Determina quais colunas retornar para cada linha correspondente. Configure return_type e return_names conforme necessário.

    • Use return_names para especificar as colunas desejadas quando return_type for definido como ColumnReturnTypeConst::RETURN_SPECIFIED.

    • Todas as colunas serão retornadas se return_type for ColumnReturnTypeConst::RETURN_ALL.

    • Ao definir return_type como ColumnReturnTypeConst::RETURN_ALL_FROM_INDEX, todas as colunas presentes no índice de busca são incluídas no resultado.

    • Apenas as colunas de chave primária aparecem na resposta quando return_type é ColumnReturnTypeConst::RETURN_NONE.

    Exemplos

    O código abaixo demonstra como consultar dados que correspondem à condição key* na coluna keyword de uma tabela.

    $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);

    Perguntas frequentes

    Referências