Directiva de retención de etiquetas de extensión

Artículo
12/08/2023

La directiva de retención de etiquetas de extensión controla el mecanismo que quita automáticamente las etiquetas de extensión de las tablas, en función de la antigüedad de las extensiones.

Se recomienda quitar las etiquetas que ya no son útiles o que se usaron temporalmente como parte de una canalización de ingesta y puede limitar el rendimiento óptimo del sistema. Por ejemplo: etiquetas antiguas drop-by: , que impiden combinar extensiones.

La directiva se puede establecer en el nivel de tabla o en el nivel de base de datos. Una directiva de nivel de base de datos se aplica a todas las tablas de la base de datos que no invalidan la directiva.

Nota:

El tiempo de eliminación es impreciso. El sistema garantiza que las etiquetas no se eliminarán antes de que se supere el límite, pero la eliminación no es inmediata después de ese punto.

El objeto de directiva

La directiva de retención de etiquetas de extensión es una matriz de objetos de directiva. Cada objeto incluye las siguientes propiedades:

Nombre de propiedad	Tipo	Descripción	Ejemplo
Tagprefix	`string`	Prefijo de las etiquetas que se eliminarán automáticamente, una vez `RetentionPeriod` que se supere. El prefijo debe incluir dos puntos (`:`) como carácter final y solo puede incluir uno.	`drop-by:`, `ingest-by:`, `custom_prefix:`
RetentionPeriod	`timespan`	La duración de la cual se garantiza que las etiquetas no se quitan. Este período se mide a partir del tiempo de creación de la extensión.	`1.00:00:00`

Ejemplo

La siguiente directiva tendrá etiquetas drop-by: anteriores a tres días y las ingest-by: etiquetas anteriores a dos horas se quitarán automáticamente:

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

Valores predeterminados

De forma predeterminada, cuando no se define la directiva, las etiquetas de extensión de cualquier tipo se conservan siempre y cuando no se quite la extensión.

Comandos de administración

Los siguientes comandos de administración se pueden usar para administrar la directiva de retención de etiquetas de extensión:

Compartir vía