Tablestore Node.js SDK update table configurations - Tablestore

Prérequis

Description de la méthode

updateTable: function describeTable(params, callback)

Description du paramètre params

tableName (obligatoire) string : nom de la table de données.

tableOptions (obligatoire) object : informations de configuration de la table, comprenant les paramètres suivants.

Paramètre	Type	Description
timeToLive (facultatif)	number	Durée de vie (TTL) des données dans la table de séries temporelles. Unité : secondes. Si vous définissez la valeur sur -1, les données n'expirent jamais. Sinon, la valeur minimale est de 86 400 (un jour). Les données dont la durée de vie dépasse le TTL sont automatiquement supprimées. Pour utiliser l'index de recherche ou l'index secondaire, définissez le TTL sur -1 ou le paramètre allowUpdate sur false.
maxVersions (facultatif)	number	Nombre maximal de versions. Pour utiliser l'index de recherche ou l'index secondaire, définissez le nombre maximal de versions sur 1.
maxTimeDeviation (facultatif)	number	Écart maximal de version. Unité : secondes. La différence entre l'horodatage des données écrites et l'heure système actuelle doit se situer dans la plage de l'écart maximal de version. Sinon, l'écriture des données échoue. La plage de versions valide pour les données de colonne d'attribut est `[max(data write time - maximum version offset, data write time - TTL), data write time + maximum version offset)`.
allowUpdate (facultatif)	boolean	Indique si les mises à jour sont autorisées. Si vous définissez la valeur sur false, vous ne pouvez pas mettre à jour les données à l'aide de la méthode `updateRow()`.

streamSpecification (facultatif) object : informations de configuration Stream, comprenant les paramètres suivants.

Paramètre

Type

Description

enableStream (facultatif)

boolean

Indique s'il faut activer Stream. Valeur par défaut : false.

expirationTime (facultatif)

number

Durée d'expiration du Stream, indiquant la durée de conservation des journaux incrémentiels. Unité : heures. Valeur maximale : 168 (sept jours).

Si enableStream est défini sur true, vous devez définir expirationTime.

reservedThroughput (facultatif) object : débit réservé en lecture et en écriture, en unités de capacité (CU). Seules les instances haute performance en mode CU acceptent des valeurs non nulles.

Remarque

Lors de l'appel à la méthode updateTable(), vous devez définir tableOptions.
Lors de la définition de tableOptions, spécifiez au moins l'un des paramètres suivants : timeToLive, maxVersions, maxTimeDeviation ou allowUpdate.

Exemple de code

L'exemple de code suivant montre comment modifier les configurations de la table test_table.

var params = {
    tableName: 'test_table',
    tableOptions: {
        // Set the TTL to 86400 seconds
        timeToLive: 86400,
        // Set the maximum number of versions
        maxVersions: 3,
        // Set the maximum version offset to 86400 seconds
        maxTimeDeviation: 86400,
        // Specify whether to allow updates
        allowUpdate: false
    },
    // Set the reserved read throughput to 0 CUs and the reserved write throughput to 0 CUs (Only high-performance instances in CU mode support setting non-zero values for reserved read and write throughput)
    reservedThroughput: {
        capacityUnit: {
            read: 0,
            write: 0
        }
    },
    // Enable Stream and set the Stream expiration time to 7 days
    streamSpecification: {
        enableStream: true,
        expirationTime: 168
    }
};

client.updateTable(params, function (err, data) {
    if (err) {
        console.error('error:', err);
        return;
    }
    console.log('success:', data);
});