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

Pré-requisitos

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

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 os dados.
queryType	Tipo de consulta. Defina como `TableStore.QueryType.RANGE_QUERY` para consultas de intervalo.
fieldName	Nome do campo a consultar.
rangeFrom	Limite inferior do intervalo de consulta. A inclusão deste valor depende de `includeLower`.
rangeTo	Limite superior do intervalo de consulta. A inclusão deste valor depende de `includeUpper`.
includeLower	Define se `rangeFrom` deve ser incluído nos resultados. `true` equivale a `>=`; `false` equivale a `>`.
includeUpper	Define se `rangeTo` deve ser incluído nos resultados. `true` equivale a `<=`; `false` equivale a `<`.
getTotalCount	Indica se o número total de linhas correspondentes à consulta 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 suportados e use `returnNames` para especificar as colunas quando `returnType` for `RETURN_SPECIFIED`. Se definir returnType como TableStore.ColumnReturnType.RETURN_SPECIFIED, configure returnNames para especificar as colunas desejadas. Ao definir o parâmetro returnType como TableStore.ColumnReturnType.RETURN_ALL, todas as colunas são retornadas. Caso o parâmetro returnType seja TableStore.ColumnReturnType.RETURN_ALL_FROM_INDEX, todas as colunas do índice de pesquisa serão retornadas. Quando o parâmetro returnType é definido como TableStore.ColumnReturnType.RETURN_NONE, apenas as colunas de chave primária são retornadas.

Perguntas frequentes

Referências

Os índices de pesquisa suportam os seguintes tipos de consulta: 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, consulta vetorial e consulta exists. Selecione o tipo adequado às necessidades do seu negócio para consultar dados.

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 Ordenação e paginação.

Caso precise agrupar o conjunto de resultados com base em uma coluna específica, use o recurso collapse (distinct). Assim, 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, 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 Agregação e Consulta SQL.
Se precisar obter rapidamente todas as linhas que atendem às condições da consulta sem ordená-las, chame as operações ParallelScan e ComputeSplits para usar o recurso de varredura paralela. Para mais informações, consulte Varredura paralela.