Denominación de la tabla para la exportación de Lente de almacenamiento de S3 a tablas de S3
Al exportar las métricas de Lente de almacenamiento de S3 a tablas de S3, las tablas se organizan utilizando las convenciones del catálogo de Apache Iceberg con patrones de nomenclatura específicos para garantizar la compatibilidad y la organización.
Estructura de ubicación de tablas
La ubicación completa de la tabla sigue este patrón:
s3tablescatalog/aws-s3/<namespace>/<table-name>
Nombres de bucket de tablas
Bucket de tablas: aws-s3
La exportación de Lente de almacenamiento de S3 utiliza el bucket de tabla de aws-s3, que es el bucket designado para las tablas del sistema de AWS relacionadas con S3.
Nombre del catálogo
El catálogo: s3tablescatalog/aws-s3
Las tablas de Lente de almacenamiento de S3 se almacenan en el catálogo de S3 porque Lente de almacenamiento proporciona información sobre tres tipos de recursos de S3:
-
Métricas de almacenamiento
-
Propiedades de bucket
-
Métricas de uso de las API
Convención de nomenclatura de espacio de nombres
Los espacios de nombres organizan las tablas dentro del catálogo. Para Lente de almacenamiento de S3, el espacio de nombres se deriva del ID de configuración de Lente de almacenamiento.
Formato de espacio de nombres estándar
Para los ID de configuración de Lente de almacenamiento sin puntos (.):
lens_<configuration-id>_exp
Ejemplo: si el ID de configuración es my-lens-config, el espacio de nombres será:
lens_my-lens-config_exp
Formato de espacio de nombres con manejo de caracteres de punto o letras mayúsculas
Los ID de configuración de Lente de almacenamiento pueden contener puntos (.) o letras mayúsculas (A-Z), pero los espacios de nombres de tablas de S3 solo admiten minúsculas, números, guiones (-) y guiones bajos (_). Cuando el ID de configuración contiene puntos, se convierten en guiones, las letras mayúsculas se convierten en minúsculas y se agrega un sufijo hash para garantizar su exclusividad:
lens_<configuration-id-with-dots-or-uppercase-replaced>_exp_<7-char-hash>
Ejemplo: si el ID de configuración es my.LENS.config, el espacio de nombres será:
lens_my-lens-config_exp_a1b2c3d
Dónde a1b2c3d están los primeros 7 caracteres del hash SHA-1 del ID de configuración original.
Ejemplos completos
Para una configuración de Lente de almacenamiento con ID production-metrics:
-
Bucket de tablas:
aws-s3 -
El catálogo:
s3tablescatalog/aws-s3 -
Espacio de nombres:
lens_production-metrics_exp -
Ruta completa:
s3tablescatalog/aws-s3/lens_production-metrics_exp/<table-name>
Para una configuración de Lente de almacenamiento con ID prod.us.east.metrics:
-
Bucket de tablas:
aws-s3 -
El catálogo:
s3tablescatalog/aws-s3 -
Espacio de nombres:
lens_prod-us-east-metrics_exp_f8e9a1b(con hash) -
Ruta completa:
s3tablescatalog/aws-s3/lens_prod-us-east-metrics_exp_f8e9a1b/<table-name>
Tipos de tabla
La siguiente tabla muestra los diferentes tipos de tablas creadas para las exportaciones de Lente de almacenamiento de S3:
| Catálogo | Espacio de nombres | Nombre de la tabla de S3 | Descripción |
|---|---|---|---|
| s3tablescatalog/aws-s3 | lens_<conf_name>_exp[_<hash>] | default_storage_metrics | Esta tabla contiene las métricas de almacenamiento de la configuración de Lente de almacenamiento. |
| s3tablescatalog/aws-s3 | lens_<conf_name>_exp[_<hash>] | default_activity_metrics | Esta tabla contiene las métricas de actividad de la configuración de Lente de almacenamiento. |
| s3tablescatalog/aws-s3 | lens_<conf_name>_exp[_<hash>] | expanded_prefixes_storage_metrics | Esta tabla contiene las métricas de almacenamiento para todos los prefijos de la configuración de Lente de almacenamiento. |
| s3tablescatalog/aws-s3 | lens_<conf_name>_exp[_<hash>] | expanded_prefixes_activity_metrics | Esta tabla contiene las métricas de actividad para todos los prefijos de la configuración de Lente de almacenamiento. |
| s3tablescatalog/aws-s3 | lens_<conf_name>_exp[_<hash>] | bucket_property_metrics | Esta tabla contiene las métricas de propiedad de bucket para todos los buckets de la configuración de Lente de almacenamiento. |
Siguientes pasos
-
Información sobre Descripción de los esquemas de tablas de Lente de almacenamiento de S3
-
Información sobre Permisos para tablas de Lente de almacenamiento de S3
