# 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// ``` ### 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__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__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 (\$1) + 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 (\$1), 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-s3` + **El catálogo:** `s3tablescatalog/aws-s3` + **Espacio de nombres:** `lens_production-metrics_exp` + **Ruta completa:** `s3tablescatalog/aws-s3/lens_production-metrics_exp/` 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/` ## 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\$1\$1exp[\$1] | default\$1storage\$1metrics | Esta tabla contiene las métricas de almacenamiento de la configuración de Lente de almacenamiento. | | s3tablescatalog/aws-s3 | lens\$1\$1exp[\$1] | default\$1activity\$1metrics | Esta tabla contiene las métricas de actividad de la configuración de Lente de almacenamiento. | | s3tablescatalog/aws-s3 | lens\$1\$1exp[\$1] | expanded\$1prefixes\$1storage\$1metrics | Esta tabla contiene las métricas de almacenamiento para todos los prefijos de la configuración de Lente de almacenamiento. | | s3tablescatalog/aws-s3 | lens\$1\$1exp[\$1] | expanded\$1prefixes\$1activity\$1metrics | Esta tabla contiene las métricas de actividad para todos los prefijos de la configuración de Lente de almacenamiento. | | s3tablescatalog/aws-s3 | lens\$1\$1exp[\$1] | bucket\$1property\$1metrics | 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.