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:
Um banco de dados do TSDB for InfluxDB®️. Para mais informações, consulte Criar um banco de dados.
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 ( |
|
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:
Faça login no console do TSDB.
No canto superior esquerdo, selecione a região onde sua instância está localizada.
Na página Instances, clique em Manage na coluna Actions da sua instância.
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
-
Na página Storage Policy Management, clique em Create no canto superior direito.

-
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
autogendeixa de ser o padrão. Um banco de dados aceita apenas uma política padrão por vez. 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
-
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.
Na caixa de diálogo, atualize os parâmetros.
Clique em OK.
Defina a política de retenção padrão
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
Na página Storage Policy Management, clique em Delete na coluna Actions da política que deseja remover.
Na caixa de diálogo de confirmação, clique em OK.