Todos os produtos
Search
Central de documentação

Tablestore:Atualizar o TTL de um analytical store

Última atualização: Aug 04, 2026

Use o Tablestore SDK for Java para atualizar o TTL de um analytical store e estender a retenção de dados ou excluir dados históricos.

Pré-requisitos

Instale o Tablestore SDK for Java e inicialize um cliente de modelo de série temporal. As operações em analytical store exigem o Tablestore SDK for Java 5.15.0 ou posterior. Recomendamos o uso da versão mais recente.

Descrição do recurso

Chame o método updateTimeseriesAnalyticalStore para atualizar o TTL de um analytical store. Não é possível atualizar o modo de sincronização de dados de um analytical store.

public UpdateTimeseriesAnalyticalStoreResponse updateTimeseriesAnalyticalStore(UpdateTimeseriesAnalyticalStoreRequest request) throws TableStoreException, ClientException
Importante
  • Após a configuração de um TTL finito, os dados que excederem esse prazo tornam-se imediatamente ilegíveis e o Tablestore os exclui de forma assíncrona.

  • A redução do TTL pode causar a expiração imediata de alguns dados. Ao aumentar o TTL, os dados anteriormente fora do período de retenção voltam a ser legíveis, desde que ainda não tenham sido excluídos e estejam dentro do novo TTL.

O exemplo de código a seguir atualiza o TTL do example_analytical_store na tabela example_timeseries_table para 30 dias.

TimeseriesClient timeseriesClient = client.asTimeseriesClient();

TimeseriesAnalyticalStore analyticalStore =
        new TimeseriesAnalyticalStore("example_analytical_store");
analyticalStore.setTimeToLive(2592000);

UpdateTimeseriesAnalyticalStoreRequest request =
        new UpdateTimeseriesAnalyticalStoreRequest("example_timeseries_table");
request.setAnalyticStore(analyticalStore);

timeseriesClient.updateTimeseriesAnalyticalStore(request);

Parâmetros

UpdateTimeseriesAnalyticalStoreRequest contém os seguintes parâmetros.

Nome

Tipo

Descrição

timeseriesTableName (obrigatório)

String

Nome da tabela de série temporal.

analyticStore (obrigatório)

TimeseriesAnalyticalStore

Configuração do analytical store a ser atualizada.

Configuração do analytical store

O parâmetro analyticStore é do tipo TimeseriesAnalyticalStore e contém os seguintes campos.

Nome

Tipo

Descrição

analyticalStoreName (obrigatório)

String

Nome do analytical store.

timeToLive (obrigatório)

int

TTL do analytical store em segundos. Defina como -1 ou um inteiro int32 de no mínimo 2592000. O valor -1 indica que os dados não expiram.