> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-trino-dialect.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Matriz de compatibilidad
> Matrices de compatibilidad exhaustivas para las integraciones de formatos de tabla abiertos y las conexiones a catálogos de lago de datos de ClickHouse.
Esta página ofrece matrices de compatibilidad exhaustivas para las integraciones de lago de datos de ClickHouse. Cubre las características disponibles para cada formato de tabla abierto, los catálogos a los que ClickHouse puede conectarse y las capacidades que admite cada catálogo.
La compatibilidad se muestra por separado para ClickHouse Cloud y ClickHouse autogestionado. Las características experimentales están deshabilitadas de forma predeterminada en ClickHouse Cloud y [deben solicitarse a través de Support](https://clickhouse.com/blog/common-getting-started-issues-with-clickhouse#13-experimental-features-in-production). La disponibilidad depende de la característica, así que contacte con Support para confirmar si se puede habilitar una característica experimental específica. La configuración y las limitaciones específicas de la implementación se describen en la columna Notas.
## Compatibilidad con formatos de tabla abiertos
ClickHouse se integra con cuatro formatos de tabla abiertos: [Apache Iceberg](/es/reference/engines/table-engines/integrations/iceberg), [Delta Lake](/es/reference/engines/table-engines/integrations/deltalake), [Apache Hudi](/es/reference/engines/table-engines/integrations/hudi) y [Apache Paimon](/es/reference/functions/table-functions/paimon). Selecciona uno de los formatos a continuación para ver su matriz de compatibilidad.
**Leyenda:** ✅ Compatible | ⚠️ Parcial, experimental u obsoleto | ❌ No compatible
| Funcionalidad | ClickHouse Cloud | Autogestionado | Notas |
| ----------------------------------- | :-------------------------------------------------------------------------------: | :------------: | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Backends de almacenamiento** | | | |
| AWS S3 | ✅ | ✅ | Mediante [`icebergS3()`](/es/reference/functions/table-functions/iceberg) o el alias `iceberg()` |
| GCS | ✅ | ✅ | Mediante [`icebergS3()`](/es/reference/functions/table-functions/iceberg) o el alias `iceberg()` |
| Azure Blob Storage | ✅ | ✅ | Mediante [`icebergAzure()`](/es/reference/functions/table-functions/iceberg) |
| HDFS | ❌ | ⚠️ Obsoleto | Mediante [`icebergHDFS()`](/es/reference/functions/table-functions/iceberg) |
| Sistema de archivos local | ❌ | ✅ | Mediante [`icebergLocal()`](/es/reference/functions/table-functions/iceberg) |
| **Métodos de acceso** | | | |
| Función de tabla | ✅ | ✅ | [`icebergS3()`](/es/reference/functions/table-functions/iceberg) con variantes para cada backend |
| Motor de tabla | ✅ | ✅ | [`IcebergS3`](/es/reference/engines/table-engines/integrations/iceberg) con variantes para cada backend |
| Lecturas distribuidas en clúster | ✅ | ✅ | [`icebergS3Cluster`](/es/reference/functions/table-functions/icebergCluster), [`icebergAzureCluster`](/es/reference/functions/table-functions/icebergCluster), [`icebergHDFSCluster`](/es/reference/functions/table-functions/icebergCluster) |
| Colecciones con nombre | ⚠️ | ✅ | Las [colecciones con nombre](/es/concepts/features/configuration/server-config/named-collections) creadas mediante DDL pueden habilitarse en determinados servicios de ClickHouse Cloud. Contacte con Support para confirmar la disponibilidad. |
| | | | |
| **Funciones de lectura** | | | |
| Compatibilidad de lectura | ✅ | ✅ | Compatibilidad completa con `SELECT` y todas las funciones de ClickHouse SQL |
| Poda de particiones | ✅ | ✅ | Consulte [Poda de particiones](/es/reference/engines/table-engines/integrations/iceberg#partition-pruning). |
| Particionamiento oculto | ✅ | ✅ | Se admite el particionamiento basado en transformaciones de Iceberg |
| Evolución de particiones | ✅ | ✅ | Se admite la lectura de tablas cuyas especificaciones de partición cambian con el tiempo |
| Evolución del esquema | ✅ | ✅ | Adición, eliminación y reordenación de columnas. Consulte [Evolución del esquema](/es/reference/engines/table-engines/integrations/iceberg#schema-evolution). |
| Promoción / ampliación de tipos | ✅ | ✅ | `int` → `long`, `float` → `double`, `decimal(P,S)` → `decimal(P',S)` cuando P' > P. Consulte [Evolución del esquema](/es/reference/engines/table-engines/integrations/iceberg#schema-evolution). |
| Viajes en el tiempo / snapshots | ✅ | ✅ | Mediante la configuración `iceberg_timestamp_ms` o `iceberg_snapshot_id`. Consulte [Viajes en el tiempo](/es/reference/engines/table-engines/integrations/iceberg#time-travel). |
| Eliminaciones por posición | ✅ | ✅ | Consulte [Procesamiento de filas eliminadas](/es/reference/engines/table-engines/integrations/iceberg#deleted-rows). |
| Eliminaciones por igualdad | ✅ | ✅ | Funciones de tabla y motores de tabla, a partir de v25.8+. Consulte [Procesamiento de filas eliminadas](/es/reference/engines/table-engines/integrations/iceberg#deleted-rows). |
| Fusión en lectura | ⚠️ | ⚠️ | Experimental. Compatible con [operaciones de eliminación](/es/reference/functions/table-functions/iceberg#iceberg-writes-delete). |
| Versiones de formato | ⚠️ Parcial | ⚠️ Parcial | Se admiten v1 y v2. La compatibilidad con V3 es parcial; no se admiten los vectores de eliminación ni la compactación de manifiestos. |
| Estadísticas de columnas | ✅ | ✅ | |
| Filtros bloom / archivos Puffin | ❌ | ❌ | No se admiten los índices de filtro bloom en archivos Puffin |
| Columnas virtuales | ✅ | ✅ | `_path`, `_file`, `_size`, `_time`, `_etag`. Consulte [Columnas virtuales](/es/reference/functions/table-functions/iceberg#virtual-columns). |
| | | | |
| **Funciones de escritura** | | | |
| Creación de tablas | ⚠️ | ⚠️ | Experimental. Requiere `allow_insert_into_iceberg = 1`. A partir de v25.7+. Consulte [Crear una tabla](/es/reference/functions/table-functions/iceberg#create-iceberg-table). |
| `INSERT` | ✅ Beta | ✅ Beta | Beta desde la versión 26.2. Requiere `allow_insert_into_iceberg = 1`. Consulte [Inserción de datos](/es/reference/functions/table-functions/iceberg#writes-inserts). |
| `DELETE` | ⚠️ | ⚠️ | Experimental. Requiere `allow_insert_into_iceberg = 1`. Mediante `ALTER TABLE ... DELETE WHERE`. Consulte [Eliminación de datos](/es/reference/functions/table-functions/iceberg#iceberg-writes-delete). |
| `ALTER TABLE` (cambios de esquema) | ⚠️ | ⚠️ | Experimental. Requiere `allow_insert_into_iceberg = 1`. Permite agregar, eliminar, modificar y renombrar columnas. Consulte [Evolución del esquema](/es/reference/functions/table-functions/iceberg#iceberg-writes-schema-evolution). |
| Compactación | ⚠️ | ⚠️ | Experimental. Requiere `allow_experimental_iceberg_compaction = 1`. Consulte [Compactación](/es/reference/functions/table-functions/iceberg#iceberg-writes-compaction). |
| `UPDATE` / `MERGE` | ❌ | ❌ | No compatible. Consulte Compactación. |
| Copia al escribir | ❌ | ❌ | No compatible |
| Expirar snapshots | ⚠️ | ⚠️ | Experimental. Requiere Iceberg v2, `allow_insert_into_iceberg = 1` y `allow_experimental_expire_snapshots = 1`. Consulte [Expirar snapshots](/es/reference/functions/table-functions/iceberg#iceberg-expire-snapshots). |
| Eliminar archivos huérfanos | ⚠️ | ⚠️ | Experimental. Requiere Iceberg v2 o superior, `allow_insert_into_iceberg = 1` y `allow_iceberg_remove_orphan_files = 1`. Consulte [Eliminar archivos huérfanos](/es/reference/functions/table-functions/iceberg#iceberg-remove-orphan-files). |
| Escritura de particiones | ✅ Beta | ✅ Beta | Compatible con escrituras en Iceberg. |
| Modificación de particiones | ❌ | ❌ | No se admite cambiar el esquema de particionamiento desde ClickHouse. ClickHouse puede escribir en tablas Iceberg con un esquema de particionamiento evolucionado. |
| | | | |
| **Metadatos** | | | |
| Ramificación y etiquetado | ❌ | ❌ | No se admiten referencias a ramas ni etiquetas de Iceberg |
| Resolución de archivos de metadatos | ✅ | ✅ | Admite la resolución mediante catálogos, enumeración de directorios, `version-hint` y una ruta específica. Consulte [Resolución de archivos de metadatos](/es/reference/engines/table-engines/integrations/iceberg#metadata-file-resolution). |
| Caché de datos | ✅ | ✅ | Utiliza el mismo mecanismo que los motores de almacenamiento S3/Azure/HDFS. Consulte [Caché de datos](/es/reference/engines/table-engines/integrations/iceberg#data-cache). |
| Caché de metadatos | ✅ | ✅ | Habilitada de forma predeterminada mediante `use_iceberg_metadata_files_cache`. Consulte [Caché de metadatos](/es/reference/engines/table-engines/integrations/iceberg#metadata-cache). |
A partir de la versión 25.6, ClickHouse lee tablas de Delta Lake mediante el kernel de Rust para Delta Lake, lo que ofrece una mayor compatibilidad con funcionalidades; sin embargo, se conocen problemas al acceder a datos en Azure Blob Storage. Por este motivo, el kernel se deshabilita al leer datos en Azure Blob Storage. A continuación se indican las funcionalidades que requieren este kernel.
| Característica | ClickHouse Cloud | Autogestionado | Notas |
| -------------------------------- | :-----------------------------------------------------------------------------: | :------------: | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Backends de almacenamiento** | | | |
| AWS S3 | ✅ | ✅ | Mediante [`deltaLake()`](/es/reference/functions/table-functions/deltalake) o `deltaLakeS3()` |
| GCS | ✅ | ✅ | Mediante [`deltaLake()`](/es/reference/functions/table-functions/deltalake) o `deltaLakeS3()` |
| Azure Blob Storage | ✅ | ✅ | Mediante [`deltaLakeAzure()`](/es/reference/functions/table-functions/deltalake) |
| HDFS | ❌ | ❌ | No compatible |
| Sistema de archivos local | ❌ | ✅ | Mediante [`deltaLakeLocal()`](/es/reference/functions/table-functions/deltalake) |
| **Métodos de acceso** | | | |
| Función de tabla | ✅ | ✅ | [`deltaLake()`](/es/reference/functions/table-functions/deltalake) con variantes para cada backend |
| Motor de tabla | ✅ | ✅ | [`DeltaLake`](/es/reference/engines/table-engines/integrations/deltalake) |
| Lecturas distribuidas en clúster | ✅ | ✅ | [`deltaLakeCluster`](/es/reference/functions/table-functions/deltalakeCluster), [`deltaLakeAzureCluster`](/es/reference/functions/table-functions/deltalakeCluster) |
| Colecciones con nombre | ⚠️ | ✅ | Las [colecciones con nombre](/es/concepts/features/configuration/server-config/named-collections) creadas con DDL pueden habilitarse en determinados servicios de ClickHouse Cloud. Contacte con Soporte para confirmar la disponibilidad. |
| **Características de lectura** | | | |
| Compatibilidad de lectura | ✅ | ✅ | Compatibilidad completa con `SELECT` y todas las funciones de ClickHouse SQL |
| Poda de particiones | ✅ Beta | ✅ Beta | Requiere Delta Kernel. |
| Evolución del esquema | ✅ Beta | ✅ Beta | Requiere Delta Kernel. |
| Viaje en el tiempo | ✅ Beta | ✅ Beta | Requiere Delta Kernel. |
| Vectores de eliminación | ✅ | ✅ | |
| Asignación de columnas | ✅ | ✅ | |
| Flujo de cambios de datos | ✅ Beta | ✅ Beta | Requiere Delta Kernel. |
| Columnas virtuales | ✅ | ✅ | `_path`, `_file`, `_size`, `_time`, `_etag`. Consulte [Columnas virtuales](/es/reference/functions/table-functions/deltalake#virtual-columns). |
| **Características de escritura** | | | |
| `INSERT` | ✅ Beta | ✅ Beta | Requiere Delta Kernel. Las escrituras son compatibles con S3 y GCS; las escrituras en Azure no son compatibles. Requiere `allow_delta_lake_writes = 1` a partir de v26.7; en versiones anteriores, use `allow_experimental_delta_lake_writes = 1`. Consulte [Escrituras de Delta Lake](/es/reference/functions/table-functions/deltalake#inserting-data). |
| `DELETE` / `UPDATE` / `MERGE` | ❌ | ❌ | No compatible |
| Crear tabla vacía | ❌ | ❌ | La operación `CREATE TABLE` supone que la tabla de Delta Lake ya existe en el almacenamiento de objetos. |
| **Caché** | | | |
| Almacenamiento en caché de datos | ✅ | ✅ | El mismo mecanismo que los motores de almacenamiento S3/Azure/HDFS. Consulte [Caché de datos](/es/reference/engines/table-engines/integrations/deltalake#data-cache). |
| Función | ClickHouse Cloud | Autogestionado | Notas |
| -------------------------------- | :-----------------------------------------------------------------------------: | :------------: | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Backends de almacenamiento** | | | |
| AWS S3 | ✅ | ✅ | Mediante [`hudi()`](/es/reference/functions/table-functions/hudi) |
| GCS | ✅ | ✅ | Mediante [`hudi()`](/es/reference/functions/table-functions/hudi) |
| Azure Blob Storage | ❌ | ❌ | No compatible |
| HDFS | ❌ | ❌ | No compatible |
| Sistema de archivos local | ❌ | ❌ | No compatible |
| **Métodos de acceso** | | | |
| Función de tabla | ✅ | ✅ | [`hudi()`](/es/reference/functions/table-functions/hudi) |
| Motor de tabla | ✅ | ✅ | [`Hudi`](/es/reference/engines/table-engines/integrations/hudi) |
| Lecturas distribuidas en clúster | ✅ | ✅ | [`hudiCluster`](/es/reference/functions/table-functions/hudiCluster) (solo S3) |
| Colecciones con nombre | ⚠️ | ✅ | Las [colecciones con nombre](/es/concepts/features/configuration/server-config/named-collections) creadas mediante DDL pueden habilitarse en determinados servicios de ClickHouse Cloud. Contacte con Soporte para confirmar la disponibilidad. |
| **Funciones de lectura** | | | |
| Compatibilidad de lectura | ✅ | ✅ | Compatibilidad completa con `SELECT` y todas las funciones de ClickHouse SQL |
| Evolución del esquema | ❌ | ❌ | No compatible |
| Viajes en el tiempo | ❌ | ❌ | No compatible |
| Columnas virtuales | ✅ | ✅ | `_path`, `_file`, `_size`, `_time`, `_etag`. Consulte [Columnas virtuales](/es/reference/functions/table-functions/hudi#virtual-columns). |
| **Funciones de escritura** | | | |
| `INSERT` / `DELETE` / `UPDATE` | ❌ | ❌ | Integración de solo lectura |
| **Almacenamiento en caché** | | | |
| Almacenamiento en caché de datos | ❌ | ❌ | No compatible |
| Funcionalidad | ClickHouse Cloud | Autogestionado | Notas |
| -------------------------------- | :--------------------------------------------------------------------------------------------: | :------------: | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Backends de almacenamiento** | | | |
| S3 | ⚠️ | ⚠️ | Experimental. Mediante [`paimon()`](/es/reference/functions/table-functions/paimon) o `paimonS3()` |
| GCS | ⚠️ | ⚠️ | Experimental. Mediante [`paimon()`](/es/reference/functions/table-functions/paimon) o `paimonS3()` |
| Azure Blob Storage | ⚠️ | ⚠️ | Experimental. Mediante [`paimonAzure()`](/es/reference/functions/table-functions/paimon) |
| HDFS | ❌ | ⚠️ | Experimental y obsoleto. Mediante [`paimonHDFS()`](/es/reference/functions/table-functions/paimon) |
| Sistema de archivos local | ❌ | ⚠️ | Experimental. Mediante [`paimonLocal()`](/es/reference/functions/table-functions/paimon) |
| **Métodos de acceso** | | | |
| Función de tabla | ⚠️ | ⚠️ | Experimental. [`paimon()`](/es/reference/functions/table-functions/paimon) con variantes para cada backend |
| Motor de tabla | ⚠️ | ⚠️ | Experimental. [`Paimon`](/es/reference/engines/table-engines/integrations/paimon) con variantes para cada backend. Requiere `allow_experimental_paimon_storage_engine = 1`. |
| Lecturas distribuidas en clúster | ⚠️ | ⚠️ | Experimental. [`paimonS3Cluster`](/es/reference/functions/table-functions/paimonCluster), [`paimonAzureCluster`](/es/reference/functions/table-functions/paimonCluster), [`paimonHDFSCluster`](/es/reference/functions/table-functions/paimonCluster) |
| Colecciones con nombre | ⚠️ | ⚠️ | Experimental. Las [colecciones con nombre](/es/concepts/features/configuration/server-config/named-collections) creadas mediante DDL pueden habilitarse en determinados servicios de ClickHouse Cloud. Contacte con el equipo de soporte para confirmar la disponibilidad. |
| **Funciones de lectura** | | | |
| Compatibilidad de lectura | ⚠️ | ⚠️ | Experimental. Compatibilidad total con `SELECT` y todas las funciones de ClickHouse SQL |
| Evolución del esquema | ❌ | ❌ | No compatible |
| Viaje en el tiempo | ❌ | ❌ | No compatible |
| Columnas virtuales | ⚠️ | ⚠️ | Experimental. `_path`, `_file`, `_size`, `_time`, `_etag`. Consulte [Columnas virtuales](/es/reference/functions/table-functions/paimon#virtual-columns). |
| **Funciones de escritura** | | | |
| `INSERT` / `DELETE` / `UPDATE` | ❌ | ❌ | Integración de solo lectura |
| **Almacenamiento en caché** | | | |
| Caché de datos | ❌ | ❌ | No compatible |
## Compatibilidad con catálogos
ClickHouse puede conectarse a catálogos de datos externos mediante el motor de base de datos [`DataLakeCatalog`](/es/reference/engines/database-engines/datalake), que expone el catálogo como una base de datos de ClickHouse. Las tablas registradas en el catálogo aparecen automáticamente y pueden consultarse con SQL estándar.
Actualmente, se admiten los siguientes catálogos. Consulta la guía de referencia de cada catálogo para obtener las instrucciones completas de configuración.
| Catálogo | Formatos | Lectura | Crear tabla | INSERT | Guía de referencia |
| ------------------------------------------------------------------------------- | -------------- | :------------: | :---------: | :----: | ---------------------------------------------------------------------------------------- |
| [AWS Glue Catalog](/es/guides/use-cases/data-warehousing/glue-catalog) | Iceberg | ✅ Beta | ❌ | ❌ | [Guía del catálogo Glue](/es/guides/use-cases/data-warehousing/glue-catalog) |
| [BigLake Metastore](/es/guides/use-cases/data-warehousing/biglake-catalog) | Iceberg | ✅ Beta | ❌ | ❌ | [Guía de BigLake Metastore](/es/guides/use-cases/data-warehousing/biglake-catalog) |
| [Databricks Unity Catalog](/es/guides/use-cases/data-warehousing/unity-catalog) | Delta, Iceberg | ✅ Beta | ✅ Beta | ✅ Beta | [Guía de Unity Catalog](/es/guides/use-cases/data-warehousing/unity-catalog) |
| [Iceberg REST](/es/guides/use-cases/data-warehousing/rest-catalog) | Iceberg | ✅ Beta | ❌ | ❌ | [Guía del catálogo REST](/es/guides/use-cases/data-warehousing/rest-catalog) |
| [Lakekeeper](/es/guides/use-cases/data-warehousing/lakekeeper-catalog) | Iceberg | ✅ Beta | ❌ | ❌ | [Guía del catálogo Lakekeeper](/es/guides/use-cases/data-warehousing/lakekeeper-catalog) |
| [Project Nessie](/es/guides/use-cases/data-warehousing/nessie-catalog) | Iceberg | ✅ Experimental | ❌ | ❌ | [Guía del catálogo Nessie](/es/guides/use-cases/data-warehousing/nessie-catalog) |
| [Microsoft OneLake](/es/guides/use-cases/data-warehousing/onelake-catalog) | Iceberg | ✅ Beta | ✅ Beta | ✅ Beta | [Guía del catálogo OneLake](/es/guides/use-cases/data-warehousing/onelake-catalog) |
| [SeaweedFS](/es/guides/use-cases/data-warehousing/seaweedfs-catalog) | Iceberg | ✅ Beta | ✅ Beta | ✅ Beta | [Guía del catálogo SeaweedFS](/es/guides/use-cases/data-warehousing/seaweedfs-catalog) |
Actualmente, todas las integraciones de catálogos requieren habilitar una configuración experimental o beta. Con la excepción de Microsoft OneLake, Databricks Unity Catalog y SeaweedFS, todos los catálogos ofrecen acceso de **solo lectura**: las tablas pueden consultarse, pero no pueden crearse ni modificarse a través de la conexión al catálogo. Para cargar datos desde un catálogo en ClickHouse y acelerar las analíticas, usa `INSERT INTO SELECT` como se describe en la [guía para acelerar las analíticas](/es/guides/use-cases/data-warehousing/getting-started/accelerating-analytics). Para escribir datos de nuevo en formatos de tabla abiertos, crea tablas Iceberg independientes como se describe en la [guía para escribir datos](/es/guides/use-cases/data-warehousing/getting-started/writing-data).