Todos os produtos
Search

Este produto

    Tablestore:Consulta de intervalo

    Central de documentação

    Tablestore:Consulta de intervalo

    Última atualização: Jul 03, 2026

    Use a consulta de intervalo para buscar dados dentro de um intervalo especificado. Se o tipo do campo for TEXT, os valores serão tokenizados. Uma linha atenderá às condições da consulta quando pelo menos um dos tokens corresponder ao intervalo definido.

    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 a retornar na consulta atual.

    Para obter apenas a contagem de linhas correspondentes, sem recuperar os dados específicos, defina este parâmetro como 0.

    get_total_count

    Indica se o total de linhas correspondentes às condições da consulta deve ser retornado. O valor padrão é false, ou seja, a contagem total não é retornada.

    Definir este parâmetro como true pode comprometer o desempenho da consulta.

    query_type

    Tipo de consulta. Para usar a consulta de intervalo, defina este parâmetro como QueryTypeConst::RANGE_QUERY.

    field_name

    Nome do campo a ser correspondido.

    range_from

    Valor inicial do intervalo da consulta.

    range_to

    Valor final do intervalo da consulta.

    include_lower

    Define se o valor do parâmetro range_from deve ser incluído na resposta. Este parâmetro é do tipo Boolean.

    include_upper

    Define se o valor do parâmetro range_to deve ser incluído na resposta. Este parâmetro é do tipo Boolean.

    sort

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

    columns_to_get

    Especifique se todas as colunas de cada linha correspondente devem ser retornadas. Configure os campos return_type e column_names para este parâmetro.

    • Se return_type for definido como ColumnReturnTypeConst::RETURN_SPECIFIED, use return_names para indicar as colunas a serem retornadas.

    • Ao definir return_type como ColumnReturnTypeConst::RETURN_ALL, todas as colunas serão retornadas.

    • Caso return_type seja ColumnReturnTypeConst::RETURN_ALL_FROM_INDEX, todas as colunas presentes no índice de busca serão retornadas.

    • Quando return_type é ColumnReturnTypeConst::RETURN_NONE, apenas as colunas de chave primária são retornadas.

    Exemplos

    O código de exemplo abaixo demonstra como consultar linhas em que o valor da coluna long seja maior ou igual a 100 e menor que 101. Neste exemplo, as linhas da resposta são ordenadas em ordem crescente com base no valor da coluna keyword.

    $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::RANGE_QUERY,
            'query' => array(
                'field_name' => 'long',
                'range_from' => 100,
                'include_lower' => true,
                'range_to' => 101,
                'include_upper' => false
            )
        ),
        '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('double', 'long', 'keyword')
    )
);
$response = $otsClient->search($request);

    Perguntas frequentes

    Referências