Todos os produtos
Search
Central de documentação

Time Series Database:Configure data retention policies

Última atualização: Jun 27, 2026

As políticas de retenção determinam por quanto tempo o TSDB for InfluxDB®️ mantém os dados em um banco de dados. Por padrão, todo banco de dados inicia com uma política chamada autogen, que armazena dados permanentemente e retém shards por sete dias. Crie políticas personalizadas para limitar a duração do armazenamento, gerencie custos ou ofereça suporte a múltiplos ciclos de vida de dados no mesmo banco de dados.

Pré-requisitos

Antes de começar, verifique se você tem:

Como funcionam as políticas de retenção

Uma política de retenção define duas dimensões de tempo independentes:

Dimensão

Descrição

**Padrão (autogen)**

Storage duration

Tempo de permanência dos dados no banco de dados

Permanente (sem expiração)

Duração do shard

Período de retenção dos shards individuais

7 dias

Um banco de dados pode ter várias políticas de retenção, mas apenas uma pode ser a padrão por vez. Ao definir uma política personalizada como padrão, a autogen deixa de ser a política padrão.

Acessar a página Storage Policy Management

Todas as operações de política de retenção partem da mesma página. Antes de seguir os passos das seções abaixo, abra a página Storage Policy Management do seu banco de dados:

  1. Faça login no console do TSDB.

  2. No canto superior esquerdo, selecione a região onde sua instância está localizada.

  3. Na página Instances, clique em Manage na coluna Actions da sua instância.

  4. Escolha Time Series Data Management > Databases. Na página Databases, clique em Storage Policy Management na coluna Actions do seu banco de dados.

Crie uma política de retenção

  1. Na página Storage Policy Management, clique em Create no canto superior direito.

    image..png

  2. Na caixa de diálogo, configure os seguintes parâmetros:

    Parâmetro

    Descrição

    Retention Policy Name

    Nome exclusivo para a política.

    Storage Duration

    Tempo de retenção dos dados no banco de dados.

    default

    Defina se esta será a política padrão. Quando ativado, a autogen deixa de ser o padrão. Um banco de dados aceita apenas uma política padrão por vez.

  3. Clique em OK.

Você também pode configurar o parâmetro Storage Duration of Shards ao modificar uma política de retenção existente após a criação. Para mais informações, consulte Modificar uma política de retenção .

Modifique uma política de retenção

  1. Na página Storage Policy Management, selecione as políticas a modificar:

    • Política única: Clique em Modify na coluna Actions da política desejada.

    • Múltiplas políticas: Selecione as políticas e clique em Modify Selected.

    Ao modificar várias políticas simultaneamente, apenas o parâmetro Storage Duration fica disponível. Para atualizar a Storage Duration of Shards , modifique cada política individualmente.
  2. Na caixa de diálogo, atualize os parâmetros.

  3. Clique em OK.

Defina a política de retenção padrão

  1. Na página Storage Policy Management, clique em Set As Default na coluna Actions da política desejada.

Após a alteração, o valor Yes aparece na coluna Whether Is default dessa política.

Exclua uma política de retenção

  1. Na página Storage Policy Management, clique em Delete na coluna Actions da política que deseja remover.

  2. Na caixa de diálogo de confirmação, clique em OK.