Todos os produtos
Search
Central de documentação

Tablestore:Consulta de intervalo

Última atualização: Sep 29, 2026

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 greaterThan para especificar maior que (>) ou greaterThanOrEqual para especificar maior ou igual a (>=).

to

O valor da posição final.

Ao definir a condição de intervalo, use lessThan para especificar menor que (<) ou lessThanOrEqual para especificar menor ou igual a (<=).

includeLower

Indica se o valor from será incluído nos resultados. O tipo é booleano.

includeUpper

Indica se o valor to será incluído nos resultados. O tipo é booleano.

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 returnAll e columns.

Por padrão, returnAll é false, o que significa que nem todas as colunas são retornadas. Use columns para especificar quais colunas retornar. Se não usar columns, apenas as colunas de chave primária serão retornadas.

Se definir returnAll como true, todas as colunas serão retornadas.

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:

Usar o console

  1. Acesse a aba Indexes.

    1. Faça login no console do Tablestore.

    2. Na barra de navegação superior, selecione um grupo de recursos e uma região.

    3. Na página Overview, clique no nome da instância que deseja gerenciar ou clique em Manage Instance na coluna Actions da instância.

    4. Na aba Tables de Instance Details, clique no nome da tabela de dados ou clique em Indexes na coluna Actions da tabela de dados.

  2. Na aba Indexes, localize o índice de pesquisa que deseja usar para consultar dados e clique em Manage Data na coluna Actions.

  3. Na caixa de diálogo Query Data, consulte os dados.

    1. Por padrão, o sistema retorna todas as colunas de atributo. Para retornar colunas de atributo específicas, desative All Columns e especifique as colunas de atributo que deseja retornar. Separe várias colunas de atributo com vírgulas (,).

      Nota

      Por padrão, o sistema retorna todas as colunas de chave primária da tabela de dados.

    2. Selecione o operador lógico And, Or ou Not de acordo com os requisitos do seu negócio.

      Se selecionar o operador lógico And, o sistema retornará os dados que atendem às condições de consulta. Se selecionar o operador Or e especificar uma única condição, o sistema retornará os dados que a atendem. Se selecionar o operador Or e especificar várias condições, o sistema retornará os dados que atendem a pelo menos uma delas. Se selecionar o operador lógico Not, o sistema retornará os dados que não atendem às condições de consulta.

    3. Selecione um campo de índice e clique em Add.

    4. Defina o tipo de consulta para o campo de índice como Range Query (RangeQuery) e especifique um intervalo de consulta.

      O intervalo de consulta é um intervalo fechado à esquerda e aberto à direita.

    5. Por padrão, o recurso de ordenação está desativado. Para ordenar os resultados da consulta com base em campos específicos, ative Sort e especifique os campos de ordenação e a ordem de classificação.

    6. Por padrão, o recurso de agregação está desativado. Para coletar estatísticas sobre um campo específico, ative Collect Statistics, especifique o campo desejado e configure as informações necessárias para a coleta.

  4. Clique em OK.

    O sistema exibe os dados que atendem às condições de consulta na ordem especificada na aba Indexes.

Usar a interface de linha de comando

Execute o comando search na interface de linha de comando para consultar dados usando um índice de pesquisa. Para mais informações, consulte Search index.

  1. Execute o comando search para consultar dados da tabela usando o índice de pesquisa search_index. Este comando retorna todas as colunas indexadas.

    search -n search_index --return_all_indexed
  2. Insira as condições de consulta conforme solicitado pelo sistema. Veja o exemplo a seguir:

    {
        "Offset": -1,
        "Limit": 10,
        "Collapse": null,
        "Sort": null,
        "GetTotalCount": true,
        "Token": null,
        "Query": {
            "Name": "RangeQuery",
            "Query": {
                "FieldName": "col_long",
                "From": 1,
                "To": 100,
                "IncludeLower": true,
                "IncludeUpper": false
            }
        }
    }

Usar um SDK

Use um Java SDK, Go SDK, Python SDK, Node.js SDK, .NET SDK ou PHP SDK para executar uma consulta de intervalo. Este tópico usa o Java SDK como exemplo.

O exemplo a seguir consulta valores Long no campo price dentro do intervalo semiaberto [100, 500). A consulta retorna até 10 linhas e o número total de correspondências.

String tableName = "example_table";
String indexName = "example_index";

RangeQuery rangeQuery = new RangeQuery();
rangeQuery.setFieldName("price");
rangeQuery.greaterThanOrEqual(ColumnValue.fromLong(100L));
rangeQuery.lessThan(ColumnValue.fromLong(500L));

SearchQuery searchQuery = new SearchQuery();
searchQuery.setQuery(rangeQuery);
searchQuery.setLimit(10);
searchQuery.setTrackTotalCount(SearchQuery.TRACK_TOTAL_COUNT);

SearchRequest request = new SearchRequest(tableName, indexName, searchQuery);
SearchRequest.ColumnsToGet columnsToGet = new SearchRequest.ColumnsToGet();
columnsToGet.setReturnAll(true);
request.setColumnsToGet(columnsToGet);

SearchResponse response = client.search(request);
System.out.println(response.getTotalCount());
System.out.println(response.getRows());

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.