Gerenciar dados de séries temporais com ciclo de vida de dados - Tablestore: Central de Documentação do Alibaba Cloud

Use o recurso de ciclo de vida de dados (TTL) para limpar automaticamente dados históricos em uma tabela de séries temporais. Esse recurso ajuda a gerenciar dados de séries temporais com eficiência, além de reduzir o uso e os custos de armazenamento. Após configurar um TTL, modifique seu valor caso precise estender o período de retenção de dados.

Precauções

Não é possível recuperar dados excluídos. Proceda com cautela.

Antes de configurar um TTL para limpar dados históricos, faça backup dos dados se necessário. Use o serviço Data Integration no DataWorks para exportar dados de séries temporais para o OSS. Para mais informações, consulte Sincronizar dados para o OSS.
Antes de modificar o TTL, chame a operação DescribeTimeseriesTable para visualizar a configuração atual do ciclo de vida de dados.

Ciclo de vida de dados

No modelo de séries temporais, os dados incluem metadados e dados das séries temporais, armazenados respectivamente em uma tabela de metadados e em uma tabela de dados de séries temporais. O Tablestore oferece ciclos de vida separados para metadados e para dados de séries temporais.

Ciclo de vida de dados da tabela de séries temporais

O ciclo de vida de dados de uma tabela de séries temporais é um atributo da tabela de dados que especifica o período de retenção em segundos. Quando a idade dos dados excede o TTL configurado, o sistema exclui os dados expirados automática e assincronamente.

Por exemplo, se o TTL de uma tabela for 86400 (um dia), em 2016-07-21 00:00:00 UTC+8, todos os dados de séries temporais anteriores a 2016-07-20 00:00:00 UTC+8 expiram. O sistema então exclui esses dados expirados automática e assincronamente.

Ao criar uma tabela de séries temporais sem definir um TTL, o sistema usa o valor padrão -1, indicando que os dados nunca expiram. Também é possível definir um TTL personalizado. Após criar a tabela, chame a operação UpdateTimeseriesTable para modificar o TTL.

Dados expirados são considerados inválidos e não podem ser consultados, mesmo que o sistema ainda não os tenha excluído fisicamente.

Se você diminuir o TTL, alguns dados na tabela de séries temporais poderão expirar imediatamente. O sistema exclui esses dados expirados de forma assíncrona.
Se você aumentar o TTL, dados que haviam expirado sob o TTL anterior, mas ainda estão dentro do período de retenção do novo TTL, poderão voltar a ser consultáveis, desde que o sistema ainda não os tenha excluído.

Ciclo de vida de metadados de séries temporais

O ciclo de vida de metadados de séries temporais é um atributo da tabela de metadados que especifica o período de retenção em segundos. Quando a idade dos metadados excede o TTL configurado, o sistema exclui os metadados expirados automática e assincronamente. Esse processo não exclui os dados correspondentes da série temporal.

Importante

Se os metadados da série temporal expirarem, mas os dados correspondentes não, você ainda poderá consultar os dados da série temporal especificando seu identificador em uma chamada de API GetTimeseriesData.

Ao criar uma tabela de séries temporais sem definir um TTL para seus metadados, o sistema usa o valor padrão -1, indicando que os metadados nunca expiram. Também é possível definir um TTL personalizado. Após criar a tabela, chame a operação UpdateTimeseriesTable para modificar o TTL.

Importante

Os metadados da série temporal incluem uma coluna de atributo atualizável chamada _attributes. No entanto, só é possível atualizar esse atributo quando o ciclo de vida dos metadados estiver definido como -1, o que significa que eles nunca expiram.

Se você alterar o ciclo de vida dos metadados de -1 para um valor de 7 dias ou mais, garanta que sua lógica de negócios não exija a atualização de atributos de metadados da série temporal. Além disso, defina Whether to Update Attributes of Time Series Metadata como No.

Para definir Whether to Update Attributes of Time Series Metadata como Yes, defina o TTL of Time Series Metadata como -1.

Metadados expirados são considerados inválidos e não podem ser pesquisados, mesmo que o sistema ainda não os tenha excluído fisicamente.

Se você diminuir o TTL, alguns metadados na tabela poderão expirar imediatamente. O sistema exclui esses metadados expirados de forma assíncrona.
Se você aumentar o TTL, metadados que haviam expirado sob o TTL anterior, mas ainda estão dentro do período de retenção do novo TTL, poderão voltar a ser pesquisáveis, desde que o sistema ainda não os tenha excluído.

Métodos

Configure o ciclo de vida de dados durante a criação da tabela de séries temporais ou modifique-o posteriormente. Esta seção demonstra como alterar o ciclo de vida de dados de uma tabela existente usando o console, a CLI ou um SDK.

Nota

Para obter informações sobre como configurar o ciclo de vida de dados ao criar uma tabela, consulte Gerenciar tabelas de séries temporais.
Os recursos compatíveis podem variar dependendo do método utilizado.

Console

Use o console para modificar o ciclo de vida de dados ou de metadados de séries temporais.

Ciclo de vida de dados

Acesse a página Instance Management.
1. Faça login no console do Tablestore.
2. Na barra de navegação superior, selecione um grupo de recursos e uma região.
3. Na página Overview, clique em nome de uma instância ou em Manage Instance na coluna Actions da instância desejada.
Na aba Instance Details, clique em aba Time Series Tables.
Na aba Time Series Tables, clique em nome da tabela de séries temporais.
Na aba Basic Information, na seção Description, clique em ícone ao lado de Data Lifecycle.
Na caixa de diálogo exibida, modifique o valor do ciclo de vida de dados.

O TTL representa o período de retenção de dados em segundos. Defina um valor inteiro de 86400 (um dia) ou superior, ou -1. O valor -1 indica que os dados nunca expiram.
Clique em Yes.

Ciclo de vida de metadados

Acesse a página Instance Management.
1. Faça login no console do Tablestore.
2. Na barra de navegação superior, selecione um grupo de recursos e uma região.
3. Na página Overview, clique em nome de uma instância ou em Manage Instance na coluna Actions da instância desejada.
Na aba Instance Details, clique em aba Time Series Tables.
Na aba Time Series Tables, clique em nome da tabela de séries temporais.
Na aba Basic Information, na seção Description, clique em ícone ao lado de TTL of Time Series Metadata.
Na caixa de diálogo exibida, modifique o valor do ciclo de vida de dados.

O TTL representa o período de retenção de metadados em segundos. Defina um valor inteiro de 604800 (7 dias) ou superior, ou -1. O valor -1 indica que os metadados nunca expiram.
Clique em Yes.

CLI

Use a CLI para modificar o ciclo de vida de dados de uma tabela de séries temporais.

Execute o comando alter para atualizar as informações da tabela. Para mais informações, consulte Atualizar uma tabela.

O exemplo a seguir mostra como alterar o ciclo de vida de dados da tabela atual para 86.400 segundos (1 dia).

alter --ttl 86400 --ts

SDK

Use um SDK para modificar o ciclo de vida de dados ou de metadados de séries temporais.

Ciclo de vida de dados

O código de exemplo a seguir demonstra como alterar o TTL dos dados em uma tabela de séries temporais para três anos.

private static void updateTimeseriesTable(TimeseriesClient client) {
    // Specify the name of the time series table. 
    String tableName = "<TIMESERIES_TABLE>";
    UpdateTimeseriesTableRequest updateTimeseriesTableRequest = new UpdateTimeseriesTableRequest(tableName);
    // Change the TTL to three years. 
    updateTimeseriesTableRequest.setTimeseriesTableOptions(new TimeseriesTableOptions(86400 * 365 * 3)); 
    client.updateTimeseriesTable(updateTimeseriesTableRequest);

    DescribeTimeseriesTableResponse describeTimeseriesTableResponse = client.describeTimeseriesTable(new DescribeTimeseriesTableRequest(tableName));
    TimeseriesTableMeta tableMeta = describeTimeseriesTableResponse.getTimeseriesTableMeta();
    // View the modified TTL. 
    System.out.println(tableMeta.getTimeseriesTableOptions().getTimeToLive()); 
}

Ciclo de vida de metadados

O exemplo a seguir mostra como atualizar o TTL dos metadados de séries temporais em uma tabela específica para 3 anos.

private static void updateTimeseriesMetaTableTTL(TimeseriesClient client) {
    // Specify the name of the time series table.
    String tableName = "<TIMESERIES_TABLE>";
    UpdateTimeseriesTableRequest updateTimeseriesTableRequest = new UpdateTimeseriesTableRequest(tableName);
    // Update the TTL to 3 years.
    TimeseriesMetaOptions options = new TimeseriesMetaOptions();
    options.setMetaTimeToLive(86400 * 365 * 3);
    updateTimeseriesTableRequest.setTimeseriesMetaOptions(options);
    client.updateTimeseriesTable(updateTimeseriesTableRequest);
}

Perguntas frequentes

Como excluir dados de séries temporais?

Documentos relacionados

O analytical store é um mecanismo de armazenamento de baixo custo otimizado para cenários de séries temporais. Use o analytical store para armazenar dados de séries temporais de forma econômica e realizar consultas e análises rápidas.