Uma consulta de intervalo recupera dados de uma tabela com base em um intervalo especificado. Para um campo do tipo Text, há correspondência se qualquer token no valor do campo atender à condição de intervalo.
Interface
Use a operação Search ou ParallelScan para executar uma consulta de intervalo. O tipo de consulta é RangeQuery.
Parâmetros
|
Parâmetro |
Descrição |
|
fieldName |
O campo usado para correspondência. |
|
from |
O valor da posição inicial. Ao definir a condição de intervalo, use |
|
to |
O valor da posição final. Ao definir a condição de intervalo, use |
|
includeLower |
Indica se o valor |
|
includeUpper |
Indica se o valor |
|
query |
Defina o tipo de consulta como RangeQuery. |
|
sort |
Ordena os resultados em uma ordem específica. Para mais informações, consulte Sorting and pagination. |
|
getTotalCount |
Indica se o sistema deve retornar o número total de linhas correspondentes. O valor padrão é false, o que indica que o total não é retornado. Retornar o número total de linhas correspondentes afeta o desempenho da consulta. |
|
tableName |
O nome da tabela de dados. |
|
indexName |
O nome do índice de pesquisa. |
|
columnsToGet |
Indica se o sistema deve retornar todas as colunas. Inclui as configurações Por padrão, Se definir |
Uso
Use o console, a interface de linha de comando ou um kit de desenvolvimento de software (SDK) para executar uma consulta de intervalo. Antes de executar a consulta, faça os seguintes preparativos:
-
Tenha uma conta Alibaba Cloud ou um usuário RAM com permissões para executar operações no Tablestore. Para obter informações sobre como conceder permissões de operação do Tablestore a um usuário RAM, consulte Use a RAM policy to grant permissions to a RAM user.
Se quiser usar os SDKs do Tablestore ou a CLI do Tablestore para executar uma consulta, crie um par de AccessKey para sua conta Alibaba Cloud ou usuário RAM. Para mais informações, consulte Crie um AccessKey.
Crie uma tabela de dados. Para mais informações, consulte Operations on tables.
Crie um índice de pesquisa para a tabela de dados. Para mais informações, consulte Crie um índice de pesquisa.
Se quiser usar os SDKs do Tablestore para executar uma consulta, inicialize uma instância OTSClient. Para mais informações, consulte Initialize a Tablestore client.
Se quiser usar a CLI do Tablestore para executar uma consulta, baixe e inicie a CLI do Tablestore e configure as informações da instância que deseja acessar e da tabela de dados. Para mais informações, consulte Baixe o Tablestore CLI, Start the Tablestore CLI and configure access information e Data table operations.
Regras de faturamento
Ao usar um índice de pesquisa para consultar dados, há cobrança pelo throughput de leitura consumido. Para mais informações, consulte Billable items of search indexes.
Perguntas frequentes
Referências
-
Ao usar um índice de pesquisa para consultar dados, use os seguintes métodos de consulta: term query, terms query, match all query, match query, match phrase query, prefix query, range query, wildcard query, fuzzy query, Boolean query, geo query, nested query, KNN vector query e exists query. Selecione os métodos de consulta de acordo com os requisitos do seu negócio para consultar dados em várias dimensões.
Ordene ou pagine as linhas que atendem às condições de consulta usando os recursos de ordenação e paginação. Para mais informações, consulte Sorting and paging.
Use o recurso de colapso (distinct) para agrupar o conjunto de resultados com base em uma coluna específica. Assim, os dados do tipo especificado aparecem apenas uma vez nos resultados da consulta. Para mais informações, consulte Collapse (remove duplicates).
Para analisar dados em uma tabela de dados, use o recurso de agregação da operação Search ou execute instruções SQL. Por exemplo, obtenha os valores mínimo e máximo, a soma e o número total de linhas. Para mais informações, consulte Aggregation e SQL query.
Para obter todas as linhas que atendem às condições de consulta sem precisar ordená-las, chame as operações ParallelScan e ComputeSplits para usar o recurso de varredura paralela. Para mais informações, consulte Parallel scan.