Tablestore Node.js SDK: Write a single row of data - Tablestore

Appelez la méthode putRow du SDK Tablestore pour Node.js afin d'insérer une ligne comportant des colonnes de clé primaire et des colonnes d'attribut facultatives dans une table de données.

Prérequis

Initialiser le client Tablestore

Méthode

putRow: function putRow(params, callback)

Description des paramètres

Nom	Type	Description
tableName (obligatoire)	string	Nom de la table.
primaryKey (obligatoire)	Array	Colonnes de clé primaire, incluant leurs noms et 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. Si une colonne de clé primaire est une colonne à incrémentation automatique, définissez sa valeur sur un espace réservé. Pour plus d'informations, consultez la rubrique colonne de clé primaire à incrémentation automatique.
attributeColumns (facultatif)	Array	Colonnes d'attribut, incluant leurs noms, valeurs et numéros de version. Types de données pris en charge : STRING, INTEGER, BINARY, DOUBLE et BOOLEAN. Le numéro de version est un horodatage généré automatiquement par le système par défaut. Vous pouvez également le spécifier manuellement. Pour plus d'informations, consultez la rubrique versions des données et cycle de vie.
condition (obligatoire)	TableStore.Condition	Condition d'écriture. Pour plus d'informations, consultez la rubrique mise à jour conditionnelle.
returnContent (facultatif)	object	Données à renvoyer. returnType (facultatif) `number` : Type de retour. TableStore.ReturnType.NONE (par défaut) : Ne renvoie aucune donnée. TableStore.ReturnType.Primarykey : Renvoie les colonnes de clé primaire. Utilisez cette option pour les colonnes de clé primaire à incrémentation automatique. TableStore.ReturnType.AfterModify : Renvoie les valeurs de colonne mises à jour. Utilisez cette option pour les compteurs atomiques.
transactionId (facultatif)	string	ID identifiant de manière unique une transaction locale. Pour plus d'informations, consultez la rubrique transaction locale.

Exemples

L'exemple suivant insère une ligne dans la table test_table avec la valeur de clé primaire row1.

var params = {
    tableName: 'test_table',
    primaryKey: [{ 'id': 'row1' }],
    // Specify a write condition when writing data. TableStore.RowExistenceExpectation.IGNORE means that the system does not check whether the row exists.
    condition: new TableStore.Condition(TableStore.RowExistenceExpectation.IGNORE, null)
};

client.putRow(params, function (err, data) {
    if (err) {
        console.log('Put 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);
});

Ajouter une colonne d'attribut.

params.attributeColumns = [{ 'col1': 'val1' }];

Spécifiez un numéro de version. Vous pouvez attribuer un numéro de version distinct à chaque colonne d'attribut.
```
params.attributeColumns = [{ 'col1': 'val1', 'timestamp': Date.now() }];
```

Références

Mettre à jour les données par lot