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

Artigo
05/23/2023

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

Recomenda-se remover quaisquer etiquetas que já não sejam úteis ou que tenham sido utilizadas temporariamente como parte de um pipeline de ingestão e que possam limitar o sistema a alcançar um desempenho ideal. Por exemplo: etiquetas antigas drop-by: , que impedem a intercalação de extensões em conjunto.

A política pode ser definida ao nível da tabela ou ao nível da base de dados. Uma política ao nível da base de dados aplica-se a todas as tabelas na base de dados que não substituem a política.

Nota

O tempo de eliminação é impreciso. O sistema garante que as etiquetas não serão eliminadas antes de o limite ser excedido, mas a eliminação não é imediata a seguir a esse ponto.

O objeto de política

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

Nome da propriedade	Tipo	Descrição	Exemplo
TagPrefix	`string`	O prefixo das etiquetas a eliminar automaticamente, uma vez `RetentionPeriod` excedido. O prefixo tem de incluir dois pontos (`:`) como caráter final e só pode incluir dois pontos.	`drop-by:`, `ingest-by:`, `custom_prefix:`
RetentionPeriod	`timespan`	A duração para a qual é garantido que as etiquetas não são removidas. Este período é medido a partir do tempo de criação da extensão.	`1.00:00:00`

Exemplo

A seguinte política terá drop-by: etiquetas com mais de três dias e todas ingest-by: as etiquetas com mais de duas horas serão automaticamente removidas:

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

Predefinições

Por predefinição, quando a política não é definida, as etiquetas de extensão de qualquer tipo são mantidas desde que a extensão não seja removida.

Comandos de gestão

Os seguintes comandos de gestão podem ser utilizados para gerir a política de retenção de etiquetas de extensão: