Actualización de la configuración de tablas - Tablestore - Centro de documentación de Alibaba Cloud

Este tema describe cómo actualizar la configuración de tablas mediante el SDK de Tablestore para Node.js.

Requisitos previos

Descripción del método

updateTable: function describeTable(params, callback)

Descripción del parámetro params

tableName (obligatorio) string: Nombre de la tabla de datos.

tableOptions (obligatorio) object: Información de configuración de la tabla, que incluye los siguientes parámetros.

Parámetro	Tipo	Descripción
timeToLive (opcional)	number	Tiempo de vida (TTL) de los datos en la tabla de series temporales. Unidad: segundos. Si establece el valor en -1, los datos nunca caducan. De lo contrario, el valor mínimo es 86400 (un día). Los datos que superan el TTL se purgan automáticamente. Para usar la función de índice de búsqueda o índice secundario, debe establecer el TTL en -1 o configurar el parámetro allowUpdate como false.
maxVersions (opcional)	number	Número máximo de versiones. Para usar la función de índice de búsqueda o índice secundario, debe establecer el número máximo de versiones en 1.
maxTimeDeviation (opcional)	number	Desviación máxima de versión. Unidad: segundos. La diferencia entre la marca de tiempo de los datos escritos y la hora actual del sistema debe estar dentro del rango de desviación máxima de versión. De lo contrario, la escritura de datos fallará. El rango de versiones válido para los datos de columnas de atributos es `[max(hora de escritura de datos - desviación máxima de versión, hora de escritura de datos - TTL), hora de escritura de datos + desviación máxima de versión)`.
allowUpdate (opcional)	boolean	Especifica si se permiten actualizaciones. Si establece el valor en false, no podrá actualizar datos mediante el método `updateRow()`.

streamSpecification (opcional) object: Información de configuración de Stream, que incluye los siguientes parámetros.

Parámetro

Tipo

Descripción

enableStream (opcional)

boolean

Especifica si se habilita Stream. Valor predeterminado: false.

expirationTime (opcional)

number

Tiempo de caducidad de Stream, que indica la duración de retención del registro incremental. Unidad: horas. Valor máximo: 168 (siete días).

Si enableStream se establece en true, debe configurar expirationTime.

reservedThroughput (opcional) object: reserved read and write throughput, en unidades de capacidad (CU). Solo las instancias de alto rendimiento en modo CU pueden configurarse con valores distintos de cero.

Nota

Al llamar al método updateTable(), debe establecer tableOptions.
Al configurar tableOptions, debe establecer como mínimo uno de los siguientes parámetros: timeToLive, maxVersions, maxTimeDeviation o allowUpdate.

Código de ejemplo

A continuación se muestra un código de ejemplo que demuestra cómo modificar la configuración de la tabla 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);
});