Política de retenção de marcas de extensão

Artigo
12/08/2023

A política de retenção de marcas de extensão controla o mecanismo que remove automaticamente as marcas de extensão das tabelas com base na idade das extensões.

É recomendável remover as marcas que não são mais úteis ou que foram usadas temporariamente como parte de um pipeline de ingestão e pode limitar o desempenho ideal do sistema. Por exemplo: marcas antigas drop-by: , que impedem a mesclagem de extensões.

A política pode ser definida no nível da tabela ou no nível do banco de dados. Uma política no nível do banco de dados se aplica a todas as tabelas no banco de dados que não substituem a política.

Observação

O tempo de exclusão é impreciso. O sistema garante que as marcas não serão excluídas antes que o limite seja excedido, mas a exclusão não é imediata após esse ponto.

O objeto de política

A política de retenção de marcas de extensão é uma matriz de objetos de política. Cada objeto inclui as seguintes propriedades:

Nome da propriedade	Type	Descrição	Exemplo
Tagprefix	`string`	O prefixo das marcas a serem excluídas automaticamente, depois que `RetentionPeriod` for excedido. O prefixo deve incluir dois-pontos (`:`) como seu caractere final e pode incluir apenas um dois-pontos.	`drop-by:`, `ingest-by:`, `custom_prefix:`
RetentionPeriod	`timespan`	A duração para a qual é garantido que as marcas não são descartadas. Esse período é medido a partir do tempo de criação da extensão.	`1.00:00:00`

Exemplo

A política a seguir terá marcas drop-by: com mais de três dias e todas ingest-by: as marcas com mais de duas horas serão descartadas automaticamente:

[
    {
        "TagPrefix": "drop-by:",
        "RetentionPeriod": "3.00:00:00"
    },
    {
        "TagPrefix": "ingest-by:",
        "RetentionPeriod": "02:00:00"
    }
]

Padrões

Por padrão, quando a política não é definida, as marcas de extensão de qualquer tipo são mantidas desde que a extensão não seja descartada.

Comandos de gerenciamento

Os seguintes comandos de gerenciamento podem ser usados para gerenciar a política de retenção de marcas de extensão: