Update a single row of data by using the Tablestore Node.js SDK - Tablestore

Appelez updateRow dans le SDK Tablestore pour Node.js afin de modifier les valeurs des colonnes d'attribut, d'ajouter des colonnes d'attribut, de supprimer une version spécifique ou de supprimer entièrement une colonne d'attribut.

Prérequis

Initialiser un client Tablestore

Méthode

updateRow: function updateRow(params, callback)

Paramètres

Nom	Type	Description
tableName (Obligatoire)	string	Nom de la table de données.
primaryKey (Obligatoire)	Array	Noms et valeurs des colonnes de clé primaire. Les types de données des colonnes de clé primaire peuvent être STRING, INTEGER ou BINARY. Le nombre et les types de clés primaires doivent correspondre à ceux de la table de données.
updateOfAttributeColumns (Obligatoire)	Array	Colonnes d'attribut à mettre à jour et type d'opération.
condition (Obligatoire)	TableStore.Condition	Condition de mise à jour. Pour plus d'informations, consultez Mise à jour conditionnelle.
returnContent (Facultatif)	object	Données à renvoyer. returnType (Facultatif) `number` : Type de retour. TableStore.ReturnType.NONE : Valeur par défaut. Aucune donnée n'est renvoyée. TableStore.ReturnType.Primarykey : Renvoie les colonnes de clé primaire. TableStore.ReturnType.AfterModify : Renvoie les valeurs de colonne après la mise à jour. Cette option est utilisée pour les compteurs atomiques.
transactionId (Facultatif)	string	ID identifiant de manière unique une transaction locale. Pour plus d'informations, consultez Transaction locale.

Exemples

L'exemple suivant modifie la colonne d'attribut col1 en changed_val1 pour la ligne dont la clé primaire est row1 dans la table test_table.

var params = {
    tableName: 'test_table',
    primaryKey: [{ 'id': 'row1' }],
    // An update condition is required to update a row. TableStore.RowExistenceExpectation.IGNORE means that the row existence is not checked.
    condition: new TableStore.Condition(TableStore.RowExistenceExpectation.IGNORE, null)
};
params.updateOfAttributeColumns = [
    { 'PUT': [{ 'col1': 'changed_val1' }] }
]

client.updateRow(params, function (err, data) {
    if (err) {
        console.log('Update row failed with error:', err);
        return;
    }
    console.log('RequestId: ', data.RequestId);
    console.log('Read CU Cost: ', data.consumed.capacityUnit.read);
    console.log('Write CU Cost: ', data.consumed.capacityUnit.write);
});

Vous pouvez également effectuer les opérations suivantes sur la ligne.

Ajouter une colonne d'attribut.

params.updateOfAttributeColumns = [
    { 'PUT': [{ 'col2': 'val2' }] }
]

Définir le numéro de version pour une colonne d'attribut.

params.updateOfAttributeColumns = [
    { 'PUT': [{ 'col2': 'val2', 'timestamp': Date.now() }] }
]

Supprimer les données d'une version spécifique d'une colonne d'attribut.

params.updateOfAttributeColumns = [
    { 'DELETE': [{ 'col2': TableStore.Long.fromNumber(1496826473186) }] },
]

Supprimer toutes les données d'une colonne d'attribut.

params.updateOfAttributeColumns = [
    { 'DELETE_ALL': ['col2'] }
]

Références

Mettre à jour des données par lot