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

Utilize a match all query para corresponder a todas as linhas de uma tabela de dados. Esse recurso é útil para contar o total de linhas ou obter uma amostra aleatória.

Pré-requisitos

Uma instância do OTSClient foi inicializada. Para mais informações, consulte Inicializar uma instância do OTSClient.
Uma tabela de dados foi criada e os dados foram gravados nela. Para mais informações, consulte Criar tabelas de dados e Gravar dados.
Um índice de busca foi criado para a tabela de dados. Para mais informações, consulte Criar um índice de busca.

Parâmetros

Parâmetro	Descrição
tableName	Nome da tabela de dados.
indexName	Nome do índice de busca.
offset	Posição inicial da consulta.
limit	Número máximo de linhas a serem retornadas. Para retornar apenas a contagem de linhas sem os dados, defina este valor como 0.
query	Tipo de consulta. Defina como `TableStore.QueryType.MATCH_ALL_QUERY` para realizar uma match all query.
getTotalCount	Indica se deve retornar o número total de linhas que correspondem às condições da consulta. Valor padrão: `false`. Definir este parâmetro como `true` reduz o desempenho da consulta.
columnToGet	Colunas a serem retornadas para cada linha correspondente. Configure usando `returnType` e `returnNames`. Se você definir returnType como TableStore.ColumnReturnType.RETURN_SPECIFIED, será necessário configurar 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 definido como TableStore.ColumnReturnType.RETURN_ALL_FROM_INDEX, todas as colunas do índice de busca são retornadas. Quando o parâmetro returnType é definido como TableStore.ColumnReturnType.RETURN_NONE, apenas as colunas de chave primária são retornadas.

Exemplos

O exemplo abaixo utiliza uma match all query para contar o número total de linhas em uma tabela de dados:

/**
 * Perform a match all query to get the total row count of a data table.
 */
client.search({
    tableName: TABLE_NAME,
    indexName: INDEX_NAME,
    searchQuery: {
        offset: 0,
        limit: 10, // Set to 0 to return only the row count without data.
        query: {
            queryType: TableStore.QueryType.MATCH_ALL_QUERY
        },
        getTotalCount: true // Set to true to return the total number of matched rows. Default: false.
    },
    columnToGet: { // RETURN_SPECIFIED: specified columns only; RETURN_ALL: all columns; RETURN_ALL_FROM_INDEX: all columns in the search index; RETURN_NONE: primary key columns only.
        returnType: TableStore.ColumnReturnType.RETURN_SPECIFIED,
        returnNames: ["Col_1", "Col_2", "Col_3"]
    }
}, function (err, data) {
    if (err) {
        console.log('error:', err);
        return;
    }
    console.log('success:', JSON.stringify(data, null, 2));
});

FAQ

Como consulto o número total de linhas em uma tabela?

Referências

Os índices de busca suportam os 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 adequado aos seus requisitos de 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 de 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 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 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.