Denominación de la tabla para la exportación de Lente de almacenamiento de S3 a tablas de S3
Descripción general
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
Los ID de configuración de Lente de almacenamiento pueden contener puntos (.), pero los espacios de nombres de tablas de S3 solo admiten mayúsculas, números, guiones (-) y guiones bajos (_). Cuando el ID de configuración contiene puntos, se convierten en guiones y se agrega un sufijo hash para garantizar su exclusividad:
lens_<configuration-id-with-dots-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.
Reglas de nomenclatura de espacios de nombres
Longitud: 1-127 caracteres
Caracteres permitidos: letras minúsculas (a-z), números (0-9), guiones (-), guiones (-), guiones bajos (_)
Patrón:
[a-z0-9_-]{1,127}Debe ser único dentro del bucket de la tabla
Requisitos de ID de configuración de Lente de almacenamiento
El ID de configuración de Lente de almacenamiento debe seguir estas reglas:
Longitud: 1-64 caracteres
Caracteres permitidos: letras (a-z), números (0-9), guiones (-), guiones bajos (_), puntos (.)
Patrón:
[a-zA-Z0-9\-\_.]+
Ejemplos completos
Para una configuración de Lente de almacenamiento con ID production-metrics:
Bucket de tablas:
aws-s3El catálogo:
s3tablescatalog/aws-s3Espacio de nombres:
lens_production-metrics_expRuta 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-s3El catálogo:
s3tablescatalog/aws-s3Espacio 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:
| Nombre del bucket | 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. |
nota
No hay cargos adicionales para la exportación de las métricas de Lente de almacenamiento de S3 a un bucket de tablas de S3 administrado de AWS. Paga los cargos habituales por el almacenamiento y la administración de las tablas en el bucket de la tabla. Puede habilitar o desactivar las tablas de S3 mediante la consola de Amazon S3, la API de Amazon S3, la AWS CLI o los AWS SDK.
