Usar o SDK do Tablestore para Node.js para realizar uma consulta por intervalo - Tablestore: Central de Documentação do Alibaba Cloud

Pré-requisitos

Uma instância OTSClient foi inicializada. Para mais informações, consulte Initialize an OTSClient instance.
Uma tabela de dados foi criada e contém dados gravados. Para mais informações, consulte Create data tables e Write data.
Um índice de pesquisa foi criado para a tabela de dados. Para mais informações, consulte Create a search index.

Exemplos

O exemplo a seguir recupera linhas em que Col_Long é maior ou igual a 1 e menor que 10 (1 <= Col_Long < 10), ordenadas por Col_Long em ordem decrescente.

client.search({
    tableName: TABLE_NAME,
    indexName: INDEX_NAME,
    searchQuery: {
        offset: 0,
        limit: 10,          // Set to 0 to return only the row count, not the data.
        query: {
            queryType: TableStore.QueryType.RANGE_QUERY,
            query: {
                fieldName: "Col_Long",
                rangeFrom: 1,
                includeLower: true,     // >= rangeFrom (equivalent to >=)
                rangeTo: 10,
                includeUpper: false     // < rangeTo (equivalent to <)
            }
        },
        getTotalCount: true // Returns the total row count. May affect query performance.
    },
    columnToGet: {
        // RETURN_ALL: all columns
        // RETURN_SPECIFIED: columns listed in returnNames
        // RETURN_ALL_FROM_INDEX: all columns in the search index
        // RETURN_NONE: primary key columns only
        returnType: TableStore.ColumnReturnType.RETURN_ALL
    }
}, function (err, data) {
    if (err) {
        console.log('error:', err);
        return;
    }
    console.log('success:', JSON.stringify(data, null, 2));
});

Parâmetros

Parâmetro	Descrição
tableName	Nome da tabela de dados.
indexName	Nome do índice de pesquisa.
offset	Número de linhas a ignorar antes de retornar os resultados. Valor padrão: 0.
limit	Número máximo de linhas a retornar. Defina como 0 para retornar apenas a contagem de linhas, sem dados.
queryType	Tipo de consulta. Defina como `TableStore.QueryType.RANGE_QUERY` para consultas por intervalo.
fieldName	Nome do campo a consultar.
rangeFrom	Limite inferior do intervalo de consulta. A inclusão desse valor depende de `includeLower`.
rangeTo	Limite superior do intervalo de consulta. A inclusão desse valor depende de `includeUpper`.
includeLower	Especifica se o valor de `rangeFrom` deve ser incluído nos resultados. `true` equivale a `>=`; `false` equivale a `>`.
includeUpper	Especifica se o valor de `rangeTo` deve ser incluído nos resultados. `true` equivale a `<=`; `false` equivale a `<`.
getTotalCount	Especifica se o número total de linhas correspondentes deve ser retornado. Valor padrão: false. Definir como `true` pode afetar o desempenho da consulta.
columnToGet	Colunas a retornar. Defina `returnType` com um dos valores compatíveis e use `returnNames` para especificar as colunas quando `returnType` estiver definido como `RETURN_SPECIFIED`. Se returnType for definido como TableStore.ColumnReturnType.RETURN_SPECIFIED, configure returnNames para indicar as colunas desejadas. Se returnType for definido como TableStore.ColumnReturnType.RETURN_ALL, o sistema retorna todas as colunas. Se returnType for definido como TableStore.ColumnReturnType.RETURN_ALL_FROM_INDEX, o sistema retorna todas as colunas do índice de pesquisa. Se returnType for definido como TableStore.ColumnReturnType.RETURN_NONE, o sistema retorna apenas as colunas de chave primária.

Perguntas frequentes

Referências

Os índices de pesquisa oferecem suporte aos seguintes tipos de consulta: term query, terms query, match all query, match query, match phrase query, prefix query, range query, wildcard query, Boolean query, geo query, nested query, vector query e exists query. Selecione o tipo de consulta mais adequado às suas necessidades de negócio.

Para ordenar ou paginar as linhas que atendem às condições da consulta, utilize o recurso de ordenação e paginação. Para mais informações, consulte Sorting and paging.

Para agrupar o conjunto de resultados com base em uma coluna específica, utilize o recurso de colapso (distinct). Dessa forma, os dados do tipo especificado aparecem apenas uma vez nos resultados da consulta. Para mais informações, consulte Collapse (distinct).
Para analisar dados em uma tabela de dados — como obter valores extremos, soma e número total de linhas — execute operações de agregação ou instruções SQL. Para mais informações, consulte Aggregation e SQL query.
Para obter rapidamente 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 Parallel scan.