Todos os produtos
Search

Este produto

    Tablestore:Read a single row

    Central de documentação

    Tablestore:Read a single row

    Última atualização: Jun 30, 2026

    Chame getRow no SDK do Tablestore para Node.js para ler uma única linha. Use chaves primárias, intervalos de versão e filtros de coluna para controlar a resposta.

    Observações

    Forneça a chave primária completa, incluindo o valor da coluna de chave primária com incremento automático.

    Pré-requisitos

    Inicializar um cliente do Tablestore

    Método

    getRow: function getRow(params, callback)

    Parameters

    Name

    Type

    Description

    tableName (Required)

    string

    Nome da tabela.

    primaryKey (Required)

    Array

    Colunas de chave primária, incluindo nomes e valores.

    • Tipos de dados compatíveis: STRING, INTEGER e BINARY.

    • A quantidade e os tipos das colunas de chave primária devem corresponder ao esquema da tabela.

    maxVersions (Optional)

    number

    Número máximo de versões a retornar. Padrão: 1.

    • Se o número de versões correspondentes exceder o máximo especificado, as versões mais recentes serão retornadas primeiro.

    timeRange (Optional)

    object

    Intervalo de versões para consulta.

    • Cada coluna de atributo pode ter várias versões. O sistema retorna apenas as versões dentro do intervalo especificado.

    columnsToGet (Optional)

    Array

    Colunas a ler. Podem ser colunas de chave primária ou de atributo.

    • Se não definido, a linha inteira será retornada.

    • Caso a linha não contenha nenhuma das colunas especificadas, null será retornado.

    columnFilter (Optional)

    TableStore.ColumnCondition

    Condição de filtro. Filtros.

    • Quando columnsToGet e columnFilter são definidos simultaneamente, as colunas são selecionadas primeiro e depois filtradas.

    transactionId (Optional)

    string

    ID da transação local. Transações locais.

    Exemplos

    Leia uma linha com valor de chave primária row1:

    var params = {
    tableName: 'test_table',
    primaryKey: [{ 'id': 'row1' }]
};

client.getRow(params, function (err, data) {
    if (err) {
        console.log('Get row failed with error: ', err);
        return;
    }
    console.log('Read CU Cost: ', data.consumed.capacityUnit.read);
    console.log('Write CU Cost: ', data.consumed.capacityUnit.write);
    console.log('Row Data: ', JSON.stringify(data.row));
});

    • Defina um intervalo de tempo. Somente versões dentro desse intervalo serão retornadas.

      params.timeRange = {
    startTime: (Date.now() - 86400 * 1000).toString(),
    endTime: Date.now().toString()
}

    • Especifique as colunas de atributo a ler.

      params.columnsToGet = ['col2']

    Referências