Tous les produits
Search

Ce produit

    Tablestore:Lire une ligne unique

    Centre de documentation

    Tablestore:Lire une ligne unique

    Dernière mise à jour :Aug 19, 2026

    Appelez getRow avec le SDK Node.js de Tablestore pour lire une seule ligne. Utilisez les clés primaires, les plages de versions et les filtres de colonnes pour contrôler la réponse.

    Notes

    Fournissez la clé primaire complète, y compris la valeur de la colonne de clé primaire à incrémentation automatique.

    Prérequis

    Initialiser un client Tablestore

    Méthode

    getRow: function getRow(params, callback)

    Paramètres

    Nom

    Type

    Description

    tableName (Obligatoire)

    string

    Nom de la table.

    primaryKey (Obligatoire)

    Array

    Colonnes de clé primaire, incluant les noms et les valeurs.

    • Types de données pris en charge : STRING, INTEGER et BINARY.

    • Le nombre et les types de colonnes de clé primaire doivent correspondre au schéma de la table.

    maxVersions (Facultatif)

    number

    Nombre maximal de versions à renvoyer. Valeur par défaut : 1.

    • Si le nombre de versions correspondantes dépasse le maximum spécifié, les versions les plus récentes sont renvoyées en priorité.

    timeRange (Facultatif)

    object

    Plage de versions à interroger.

    • Chaque colonne d'attribut peut comporter plusieurs versions. Seules les versions comprises dans la plage spécifiée sont renvoyées.

    columnsToGet (Facultatif)

    Array

    Colonnes à lire. Il peut s'agir de colonnes de clé primaire ou de colonnes d'attribut.

    • Si ce paramètre n'est pas défini, la ligne entière est renvoyée.

    • Si la ligne ne contient aucune des colonnes spécifiées, la valeur null est renvoyée.

    columnFilter (Facultatif)

    TableStore.ColumnCondition

    Condition de filtrage. Filtres.

    • Lorsque columnsToGet et columnFilter sont tous deux définis, les colonnes sont d'abord sélectionnées, puis filtrées.

    transactionId (Facultatif)

    string

    ID de transaction locale. Transactions locales.

    Exemples

    Lisez une ligne dont la valeur de clé primaire est 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));
});

    • Définissez une plage horaire. Seules les versions comprises dans cette plage sont renvoyées.

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

    • Spécifiez les colonnes d'attribut à lire.

      params.columnsToGet = ['col2']

    Références