Todos os produtos
Search
Central de documentação

Tablestore:Atualizar o TTL de dados em um analytical store de séries temporais

Última atualização: Jun 30, 2026

Para excluir dados históricos ou estender o período de retenção de dados em um analytical store, chame a operação UpdateTimeseriesAnalyticalStore e atualize a configuração de time to live (TTL). Após a atualização, o Tablestore exclui automaticamente e de forma assíncrona os dados do analytical store cujo período de retenção exceda o valor de TTL definido.

Pré-requisitos

Notas de uso

  • A opção de sincronização de um analytical store não pode ser atualizada.

  • O TTL mínimo de um analytical store é de 30 dias (2.592.000 segundos).

  • Se o TTL não for definido como -1 durante a criação do analytical store, o Tablestore excluirá automaticamente e de forma assíncrona os dados cujo período de retenção exceder esse valor. Você também pode modificar o TTL chamando a operação UpdateTimeseriesAnalyticalStore.

    Dados com período de retenção superior ao TTL são considerados inválidos. Mesmo que o sistema ainda não os tenha excluído, esses dados não podem mais ser lidos.

    • Ao reduzir o valor de TTL, alguns dados no analytical store podem expirar. O sistema excluirá os dados expirados correspondentes de maneira assíncrona.

    • Ao aumentar o valor de TTL, se o sistema ainda não tiver excluído os dados que excediam o antigo TTL e o período de retenção desses dados for menor ou igual ao novo valor, eles permanecerão legíveis.

Parâmetros

Parâmetro

Descrição

timeseriesTableName

Nome da tabela de séries temporais.

analyticalStore

analyticalStoreName

Nome do analytical store.

timeToLive

Período de retenção dos dados no analytical store, em segundos. Valores válidos: -1 (os dados nunca expiram) ou um número inteiro int32 positivo maior ou igual a 2592000 (30 dias).

Para que os dados no analytical store nunca expirem, defina timeToLive como -1.

Exemplo

O código de exemplo abaixo demonstra como atualizar para 30 dias (2.592.000 segundos) o TTL dos dados em um analytical store chamado test_analytical_store, criado para a tabela de séries temporais test_timeseries_table:

public void updateAnalyticalStore(TimeseriesClient client) {
    //Specify the name of the analytical store.
    TimeseriesAnalyticalStore store = new TimeseriesAnalyticalStore("test_analytical_store");
    //Update the TTL of the analytical store to 2,592,000 seconds.
    store.setTimeToLive(2592000);
    //Specify the name of the time series table.
    UpdateTimeseriesAnalyticalStoreRequest request = new UpdateTimeseriesAnalyticalStoreRequest("test_timeseries_table");
    request.setAnalyticStore(store);
    client.updateTimeseriesAnalyticalStore(request);
}