Apache Iceberg (catálogo Polaris)¶
Forma parte del lakehouse (visión general y esquema de interacciones).
La plantilla Apache Iceberg (categoría Gobernanza) despliega un catálogo Iceberg REST — Apache Polaris — respaldado por una base PostgreSQL (CloudNativePG) creada con él.
| Campo | Función |
|---|---|
| Bucket S3 del warehouse (pestaña Almacenamiento, obligatorio) | Bucket que contendrá tablas y metadatos. Elegir un bucket del namespace rellena automáticamente endpoint, región y claves de acceso. Fijado en la creación. |
| Endpoint S3, Región S3 (pestaña Almacenamiento) | Rellenados por el selector de bucket, a escribir a mano para un S3 externo. us-east-1 por defecto para la región. Fijados en la creación. |
| Access Key ID, Secret Access Key (pestaña Almacenamiento) | Credenciales del bucket, estas sí modificables después — por ejemplo tras una rotación de claves. |
| Nombre del catálogo Iceberg | lakehouse por defecto: es el warehouse al que se refieren Trino, Spark o PyIceberg. Fijado en la creación. |
| Realm Polaris | POLARIS por defecto, un realm por instancia. Fijado en la creación. |
| Límite de memoria, Límite de CPU (pestaña Capacidad) | 2Gi y 1000m por defecto. |
| Tamaño del almacenamiento PostgreSQL (pestaña Capacidad) | 5Gi por defecto. Solo se puede ampliar: un volumen no se reduce. |
Al desplegar se ejecutan automáticamente dos tareas: la inicialización del realm (credenciales del principal root) y la creación del catálogo en el bucket, con los permisos necesarios. La tarjeta pasa a Running antes de que terminen — cuente uno o dos minutos más antes de que el catálogo sea utilizable.
Credenciales del catálogo
Los motores se autentican ante el catálogo con el principal root, guardado en el secreto <nombre>-root-principal del namespace (claves clientId, clientSecret, catalogUri, catalogName) — véase Secretos. El catálogo no distribuye credenciales S3 temporales (sin STS en el almacenamiento de objetos de la plataforma): cada motor usa sus propias claves del bucket, de ahí los campos S3 repetidos en las plantillas Trino y JupyterHub.
La API REST se expone en https://<nombre>-<namespace>.<dominio>/api/catalog (solo llamadas autenticadas — sin interfaz web).
Eliminación¶
Eliminar el catálogo Apache Iceberg elimina su base PostgreSQL y sus secretos, pero no los archivos del bucket: las tablas siguen siendo legibles por un nuevo catálogo que apunte a la misma ubicación, o pueden limpiarse desde la página Buckets.