Usar o Tablestore SDK for Java para atualizar as configurações de uma tabela - Tablestore: Central de Documentação do Alibaba Cloud

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

Pré-requisitos

Inicialize um cliente. Para mais informações, consulte Inicializar um cliente Tablestore.

Método

public UpdateTableResponse updateTable(UpdateTableRequest request) throws TableStoreException, ClientException

Parâmetros de UpdateTableRequest

tableName (obrigatório) String: nome da tabela de dados.

tableOptionsForUpdate (opcional) TableOptions: informações de configuração. A tabela a seguir descreve os parâmetros incluídos em tableOptionsForUpdate.

Parâmetro	Tipo	Descrição
timeToLive (opcional)	OptionalValue<Integer>	Tempo de vida (TTL) dos dados na tabela. Unidade: segundos. Se definido como -1, os dados nunca expiram. Caso contrário, o valor mínimo é 86400 (um dia). Dados cujo período de retenção excede o TTL são excluídos automaticamente. Para usar recursos de índice de pesquisa ou índice secundário, defina este parâmetro como -1 ou defina allowUpdate como false.
maxVersions (opcional)	OptionalValue<Integer>	Número máximo de versões retidas para dados em cada coluna de atributo. Para criar um índice de pesquisa ou índice secundário na tabela de dados, defina este parâmetro como 1.
maxTimeDeviation (opcional)	OptionalValue<Long>	Desvio máximo de versão. Unidade: segundos. A diferença entre a hora atual do sistema e o timestamp dos dados gravados deve estar dentro do desvio máximo de versão. Caso contrário, a gravação falha. Intervalo de versão válido para dados em uma coluna de atributo: `[max(Data written time - Max version offset, Data written time - TTL), Data written time + Max version offset)`.
allowUpdate (opcional)	OptionalValue<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) StreamSpecification: informações de configuração do Stream. A tabela a seguir descreve os parâmetros incluídos em StreamSpecification.

Parâmetro

Tipo

Descrição

enableStream (obrigatório)

boolean

Indica se o Stream deve ser ativado.

expirationTime (opcional)

OptionalValue<Integer>

Período de validade do Stream, que indica a duração de retenção dos logs incrementais. Unidade: horas. Valor máximo: 168 (sete dias).

Configure este parâmetro obrigatoriamente quando enableStream for definido como true.

reservedThroughputForUpdate (opcional) ReservedThroughput: throughput de leitura/gravação reservado. Unidade: unidades de capacidade (CUs). Valor padrão: 0. Configure este parâmetro apenas para instâncias de alto desempenho no modo CU.

Nota

Ao chamar o método updateTable(), configure pelo menos um dos seguintes parâmetros: tableOptionsForUpdate, streamSpecification ou reservedThroughputForUpdate.
Ao configurar tableOptionsForUpdate, especifique pelo menos um dos seguintes parâmetros: timeToLive, maxVersions, maxTimeDeviation ou allowUpdate.

Código de exemplo

O exemplo a seguir mostra como atualizar as configurações da tabela test_table:

public static void updateTableExample(SyncClient client) {
    UpdateTableRequest request = new UpdateTableRequest("test_table");
    // Set the reserved read throughput to 0 CU and the reserved write throughput to 0 CU.
    ReservedThroughput reservedThroughput = new ReservedThroughput(0, 0);
    request.setReservedThroughputForUpdate(reservedThroughput);

    TableOptions tableOptions = new TableOptions();
    // Specify the maximum number of versions that can be retained for data in an attribute column.
    tableOptions.setMaxVersions(3);
    // Specify the TTL in seconds.
    tableOptions.setTimeToLive(86400);
    // Specify the max version offset in seconds.
    tableOptions.setMaxTimeDeviation(86400);
    // Specify whether to allow updates.
    tableOptions.setAllowUpdate(false);
    request.setTableOptionsForUpdate(tableOptions);

    // Enable Stream and set the Stream validity period to seven days.
    StreamSpecification streamSpecification = new StreamSpecification(true, 168);
    request.setStreamSpecification(streamSpecification);
    
    // Call the updateTable method to modify the table configurations.
    client.updateTable(request);
}

Referências

Para mais informações, consulte Modificar as configurações de uma tabela de séries temporais.