Todos os produtos
Search
Central de documentação

Tablestore:Atualizar as configurações de uma tabela

Última atualização: Jul 03, 2026

Este tópico descreve como atualizar as configurações de tabela com o Tablestore SDK for Node.js.

Pré-requisitos

Inicializar um cliente Tablestore.

Descrição do método

updateTable: function describeTable(params, callback) 

Descrição do parâmetro params

  • tableName (obrigatório) string: Nome da tabela de dados.

  • tableOptions (obrigatório) object: Informações de configuração da tabela, incluindo os seguintes parâmetros.

    Parâmetro

    Tipo

    Descrição

    timeToLive (opcional)

    number

    Tempo de vida (TTL) dos dados na tabela de séries temporais. Unidade: segundos.

    • Se definido como -1, os dados nunca expiram. Caso contrário, o valor mínimo é 86400 (um dia). Dados que excedem o TTL são removidos automaticamente.

    • Para usar o recurso de índice de pesquisa ou índice secundário, defina o TTL como -1 ou o parâmetro allowUpdate como false.

    maxVersions (opcional)

    number

    Número máximo de versões.

    Para usar o índice de pesquisa ou o índice secundário, defina o número máximo de versões como 1.

    maxTimeDeviation (opcional)

    number

    Desvio máximo de versão. Unidade: segundos.

    • A diferença entre o timestamp dos dados gravados e a hora atual do sistema deve estar dentro do intervalo de desvio máximo de versão. Caso contrário, a gravação falha.

    • O intervalo de versão válido para dados de coluna de atributo é [max(data write time - maximum version offset, data write time - TTL), data write time + maximum version offset).

    allowUpdate (opcional)

    boolean

    Indica se as atualizações são permitidas.

    • Se definido como false, não é possível atualizar dados com o método updateRow().

  • streamSpecification (opcional) object: Informações de configuração do Stream, incluindo os seguintes parâmetros.

    Parâmetro

    Tipo

    Descrição

    enableStream (opcional)

    boolean

    Indica se o Stream deve ser ativado. Valor padrão: false.

    expirationTime (opcional)

    number

    Tempo de expiração do Stream, indicando a duração da retenção de logs incrementais. Unidade: horas. Valor máximo: 168 (sete dias).

    Se enableStream estiver definido como true, defina expirationTime.

  • reservedThroughput (opcional) object: throughput reservado de leitura e gravação, em unidades de capacidade (CUs). Apenas instâncias de alto desempenho no modo CU aceitam valores diferentes de zero.

Nota
  • Ao chamar o método updateTable(), defina tableOptions.

  • Ao configurar tableOptions, especifique pelo menos um dos seguintes parâmetros: timeToLive, maxVersions, maxTimeDeviation ou allowUpdate.

Código de exemplo

O código de exemplo a seguir demonstra como modificar as configurações da tabela 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);
});