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

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

Pré-requisitos

Instância OTSClient inicializada. Para mais informações, consulte Inicializar uma instância OTSClient.
Tabela de dados criada e com dados gravados. Para mais informações, consulte Criar tabelas de dados e Gravar dados.
Índice de busca criado para a tabela de dados. Para mais informações, consulte Criar índices de busca.

Parâmetros

Parâmetro	Descrição
GetTotalCount	Define se o sistema deve retornar o número total de linhas que atendem às condições da consulta. O valor padrão é false, indicando que a contagem total não será retornada. Definir este parâmetro como true pode comprometer o desempenho da consulta.
Query	Tipo da consulta. Para utilizar a consulta de intervalo, defina este parâmetro como RangeQuery.
FieldName	Nome do campo a ser correspondido.
From	Valor inicial da consulta.
To	Valor final da consulta.
IncludeLower	Indica se a resposta deve incluir as linhas cujo valor da coluna correspondente seja igual ao valor do parâmetro From. O tipo de valor deste parâmetro é Boolean.
IncludeUpper	Indica se a resposta deve incluir as linhas cujo valor da coluna correspondente seja igual ao valor do parâmetro To. O tipo de valor deste parâmetro é Boolean.
TableName	Nome da tabela de dados.
IndexName	Nome do índice de busca.
ColumnsToGet	Determina quais colunas retornar para cada linha que atenda às condições da consulta. É possível configurar ReturnAll, Columns e ReturnAllFromIndex neste parâmetro. Por padrão, `ReturnAll` é `false`, o que significa que apenas as colunas de chave primária são retornadas. Para retornar colunas adicionais, use uma das seguintes opções: Defina `Columns` para especificar quais colunas retornar. Defina `ReturnAllFromIndex` como `true` para retornar todas as colunas do índice de busca. Defina `ReturnAll` como `true` para retornar todas as colunas da tabela de dados.

Exemplos

O código de exemplo a seguir demonstra como consultar linhas em que o valor da coluna Long_type_col seja maior ou igual a 0 e menor que 6. Neste exemplo, o sistema também retorna o número total de linhas que atendem às condições da consulta.

/// <summary>
/// Search the table for rows in which the value of the Long_type_col column is greater than or equal to 0 and less than 6. 
/// </summary>
/// <param name="otsClient"></param>
public static void RangeQuery(OTSClient otsClient)
{
    var searchQuery = new SearchQuery();
    // Specify that the total number of rows that meet the query conditions is returned. 
    searchQuery.GetTotalCount = true;
    var rangeQuery = new RangeQuery(Long_type_col, new ColumnValue(0), new ColumnValue(6));
    // Specify that the rows in which the value of the column that you want to match is equal to the value of the From parameter are included in the response. 
    rangeQuery.IncludeLower = true;
    searchQuery.Query = rangeQuery;
    var request = new SearchRequest(TableName, IndexName, searchQuery);
    // You can configure the ColumnsToGet parameter to specify the columns that you want to return, specify that all columns are returned, or specify that all columns in the search index are returned. If you do not configure this parameter, only the primary key columns are returned. 
    request.ColumnsToGet = new ColumnsToGet()
    {
        // Specify that all columns in the search index are returned. 
        ReturnAllFromIndex = true
        // Specify the columns that you want to return. 
        //Columns = new List<string>() { Long_type_col, Text_type_col, Keyword_type_col }
        // Specify that all columns are returned. 
        //ReturnAll = true
    };

    var response = otsClient.Search(request);

    Console.WriteLine("Total Count:" + response.TotalCount); // Specify that the total number of rows that meet the query conditions instead of the number of rows that are returned is displayed. 
}

Perguntas frequentes

Referências

Ao usar um índice de busca para consultar dados, utilize os seguintes métodos: consulta de termo, consulta de termos, consulta match all, consulta match, consulta match phrase, consulta de prefixo, consulta de intervalo, consulta wildcard, consulta Boolean, consulta geográfica, consulta aninhada e consulta exists. Combine diferentes métodos para consultar dados sob múltiplas dimensões conforme suas necessidades de negócio.

Os recursos de ordenação e paginação permitem classificar ou paginar as linhas que atendem às condições da consulta. Para mais informações, consulte Ordenação e paginação.

O recurso collapse (distinct) agrupa o conjunto de resultados com base em uma coluna específica, garantindo que dados do tipo especificado apareçam apenas uma vez nos resultados da consulta. Para mais informações, consulte Collapse (distinct).
Para analisar dados em uma tabela de dados, utilize o recurso de agregação da operação Search ou execute instruções SQL. Isso permite obter valores mínimos e máximos, somas e contagens totais de linhas. Para mais informações, consulte Agregação e Consulta SQL.
Caso precise obter todas as linhas que atendem às condições da consulta sem necessidade de ordenação, chame as operações ParallelScan e ComputeSplits para usar o recurso de varredura paralela. Para mais informações, consulte Varredura paralela.