Todos los productos
Search

Este producto

    Tablestore:Lectura de una sola fila

    Centro de documentos

    Tablestore:Lectura de una sola fila

    Última actualización: Sep 03, 2026

    Llame a getRow en el SDK de Node.js para Tablestore para leer una sola fila. Use claves principales, rangos de versiones y filtros de columnas para controlar la respuesta.

    Notas

    Proporcione la clave principal completa, incluido el valor de la columna de clave principal con incremento automático.

    Requisitos previos

    Initialize a Tablestore client

    Método

    getRow: function getRow(params, callback)

    Parameters

    Nombre

    Tipo

    Descripción

    tableName (Obligatorio)

    string

    Nombre de la tabla.

    primaryKey (Obligatorio)

    Array

    Columnas de clave principal, incluidos sus nombres y valores.

    • Tipos de datos compatibles: STRING, INTEGER y BINARY.

    • La cantidad y los tipos de columnas de clave principal deben coincidir con el esquema de la tabla.

    maxVersions (Opcional)

    number

    Número máximo de versiones por devolver. Valor predeterminado: 1.

    • Si hay más versiones coincidentes que el máximo especificado, se devuelven primero las más recientes.

    timeRange (Opcional)

    object

    Rango de versiones para consultar.

    • Cada columna de atributo puede tener varias versiones. Solo se devuelven las versiones dentro del rango especificado.

    columnsToGet (Opcional)

    Array

    Columnas por leer. Pueden ser columnas de clave principal o de atributo.

    • Si no se establece, se devuelve la fila completa.

    • Si la fila no contiene ninguna de las columnas especificadas, se devuelve null.

    columnFilter (Opcional)

    TableStore.ColumnCondition

    Condición de filtro. Filters.

    • Cuando se establecen tanto columnsToGet como columnFilter, primero se seleccionan las columnas y luego se filtran.

    transactionId (Opcional)

    string

    ID de la transacción local. Local transactions.

    Ejemplos

    Lea una fila con el valor de clave principal 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));
});

    • Establezca un rango de tiempo. Solo se devolverán las versiones dentro de este rango.

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

    • Especifique las columnas de atributo por leer.

      params.columnsToGet = ['col2']

    Referencias