Use Tablestore SDK for PHP to perform a range query - Tablestore: Central de Documentação do Alibaba Cloud

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

Pré-requisitos

Inicialize uma instância do OTSClient. Para mais informações, consulte Inicializar uma instância do OTSClient.
Para começar, crie uma tabela de dados e insira dados nela. Para mais detalhes, acesse Criar uma tabela de dados e Inserir dados.
Depois, crie um índice de pesquisa para a tabela de dados. Para saber mais, veja Criar um índice de pesquisa.

Parâmetros

Parâmetro	Descrição
table_name	O nome da tabela de dados.
index_name	O nome do índice de pesquisa.
offset	A posição a partir da qual a consulta atual começa.
limit	O número máximo de linhas a serem retornadas pela consulta atual. Para consultar apenas a quantidade de linhas que atendem às condições, sem recuperar seus dados específicos, defina este parâmetro como 0.
get_total_count	Indica se a consulta retornará o número total de linhas que atendem às condições. O valor padrão é false, o que significa que a contagem total não será retornada. Nota: defina este parâmetro como true apenas se necessário, pois compromete o desempenho da consulta.
query_type	O tipo de consulta. Para usar a consulta de intervalo, defina este parâmetro como `QueryTypeConst::RANGE_QUERY`.
field_name	O nome do campo a ser correspondido.
range_from	O valor a partir do qual a consulta começa.
range_to	O valor em que a consulta termina.
include_lower	Determina se a resposta incluirá o valor do parâmetro range_from. O valor deste parâmetro é booleano.
include_upper	Especifica se a resposta incluirá o valor do parâmetro range_to. O valor deste parâmetro é booleano.
sort	O método usado para ordenar as linhas na resposta. Para mais detalhes, acesse Ordenação e paginação.
columns_to_get	Especifica se a consulta retornará todas as colunas de cada linha que atende às condições. Configure os campos return_type e column_names para este parâmetro. Ao definir return_type como `ColumnReturnTypeConst::RETURN_SPECIFIED`, especifique as colunas a serem retornadas usando return_names. Caso defina o parâmetro return_type como `ColumnReturnTypeConst::RETURN_ALL`, todas as colunas serão retornadas. Se return_type for definido como `ColumnReturnTypeConst::RETURN_ALL_FROM_INDEX`, todas as colunas no índice de pesquisa serão retornadas. Ao configurar o parâmetro return_type como `ColumnReturnTypeConst::RETURN_NONE`, apenas as colunas de chave primária serão retornadas.

Exemplos

O código de exemplo a seguir mostra como consultar as linhas em que o valor da coluna long é 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

Ao usar um índice de pesquisa para consultar dados, utilize os seguintes métodos de consulta: consulta de termo, consulta de termos, consulta de correspondência total, consulta de correspondência, consulta de frase correspondente, consulta de prefixo, consulta de intervalo, consulta de curinga, consulta booleana, consulta geográfica, consulta aninhada e consulta de existência. Use diferentes métodos de consulta para buscar dados de várias dimensões de acordo com os requisitos de negócio.

Para ordenar ou paginar as linhas que atendem às condições de consulta, use o recurso de ordenação e paginação. Para mais informações, consulte Ordenação e paginação.

Para agrupar o conjunto de resultados com base em uma coluna específica, use o recurso de colapso. Dessa forma, os dados do tipo especificado aparecem apenas uma vez nos resultados da consulta. Para mais detalhes, acesse Colapso (distinct).
Para analisar dados em uma tabela de dados, como obter os valores extremos, a soma e o número total de linhas, execute operações de agregação ou instruções SQL. Para saber mais, veja Agregação e Consulta SQL.
Para obter rapidamente todas as linhas que atendem às condições de consulta sem a necessidade de ordená-las, chame as operações ParallelScan e ComputeSplits para usar o recurso de varredura paralela. Para obter mais informações, consulte Varredura paralela.