> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-home-button.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Primeros pasos con lagos de datos
> Una introducción práctica a cómo consultar, acelerar y volver a escribir datos en formatos de tabla abiertos con ClickHouse.
export const Image = ({img, alt, size}) => {
return
;
};
**En resumen**
Una guía práctica para consultar tablas de lago de datos, acelerarlas con MergeTree y escribir de nuevo los resultados en Iceberg. Todos los pasos usan datasets públicos y funcionan tanto en Cloud como en OSS.
Las capturas de pantalla de esta guía son de la [consola SQL de ClickHouse Cloud](https://console.clickhouse.cloud). Todas las consultas funcionan tanto en Cloud como en despliegues autogestionados.
## Consultar datos de Iceberg directamente
La forma más rápida de empezar es con la función de tabla [`icebergS3()`](/es/reference/functions/table-functions/iceberg): apúntala a una tabla Iceberg en S3 y haz la consulta de inmediato, sin necesidad de configuración.
Inspecciona el esquema:
```sql theme={null}
DESCRIBE icebergS3('https://datasets-documentation.s3.amazonaws.com/lake_formats/iceberg/')
```
Ejecuta una consulta:
```sql theme={null}
SELECT
url,
count() AS cnt
FROM icebergS3('https://datasets-documentation.s3.amazonaws.com/lake_formats/iceberg/')
GROUP BY url
ORDER BY cnt DESC
LIMIT 5
```
ClickHouse lee los metadatos de Iceberg directamente desde S3 e infiere el esquema automáticamente. El mismo enfoque también funciona con [`deltaLake()`](/es/reference/functions/table-functions/deltalake), [`hudi()`](/es/reference/functions/table-functions/hudi) y [`paimon()`](/es/reference/functions/table-functions/paimon).
**Más información:** [Consultar directamente formatos de tabla abiertos](/es/guides/use-cases/data-warehousing/getting-started/querying-directly) abarca los cuatro formatos, las variantes de cluster para lecturas distribuidas y las opciones de backend de almacenamiento (S3, Azure, HDFS, local).
## Cree una tabla persistente con el motor de tabla
Para acceder repetidamente, cree una tabla con el motor de tabla Iceberg para no tener que indicar la ruta cada vez. Los datos permanecen en S3 — no se duplica ningún dato:
```sql theme={null}
CREATE TABLE hits_iceberg
ENGINE = IcebergS3('https://datasets-documentation.s3.amazonaws.com/lake_formats/iceberg/')
```
Ahora consúltala como cualquier otra tabla de ClickHouse:
```sql theme={null}
SELECT
url,
count() AS cnt
FROM hits_iceberg
GROUP BY url
ORDER BY cnt DESC
LIMIT 5
```
El motor de tabla admite caché de datos, caché de metadatos, evolución del esquema y viaje en el tiempo. Consulta la guía [Consulta directa](/es/guides/use-cases/data-warehousing/getting-started/querying-directly) para obtener más información sobre las características del motor de tabla y la [matriz de compatibilidad](/es/guides/use-cases/data-warehousing/support-matrix) para ver una comparación completa de características.
## Conectarse a un catálogo
La mayoría de las organizaciones administran las tablas de Iceberg mediante un catálogo de datos para centralizar los metadatos de las tablas y el descubrimiento de datos. ClickHouse permite conectarse a su catálogo mediante el motor de base de datos [`DataLakeCatalog`](/es/reference/engines/database-engines/datalake), lo que expone todas las tablas del catálogo como una base de datos de ClickHouse. Esta es la opción más escalable, ya que, a medida que se crean nuevas tablas de Iceberg, siempre están accesibles en ClickHouse sin necesidad de trabajo adicional.
A continuación se muestra un ejemplo de conexión a [AWS Glue](/es/guides/use-cases/data-warehousing/glue-catalog):
```sql theme={null}
CREATE DATABASE my_lake
ENGINE = DataLakeCatalog
SETTINGS
catalog_type = 'glue',
region = '',
aws_access_key_id = '',
aws_secret_access_key = ''
```
Cada tipo de catálogo requiere su propia configuración de conexión; consulte las [guías sobre catálogos](/es/guides/use-cases/data-warehousing/reference) para ver la lista completa de catálogos compatibles y sus opciones de configuración.
Explore las tablas y realice consultas:
```sql theme={null}
SHOW TABLES FROM my_lake;
```
```sql theme={null}
SELECT count(*) FROM my_lake.`.`
```
Se requieren comillas invertidas alrededor de `.` porque ClickHouse no admite de forma nativa más de un espacio de nombres.
**Más información:** [Conexión a un catálogo de datos](/es/guides/use-cases/data-warehousing/getting-started/connecting-catalogs) muestra una configuración completa de Unity Catalog con ejemplos de Delta e Iceberg.
## Realiza una consulta
Independientemente del método que hayas usado antes —función de tabla, motor de tabla o catálogo—, el mismo ClickHouse SQL funciona en todos los casos:
```sql theme={null}
-- Función de tabla
SELECT url, count() AS cnt
FROM icebergS3('https://datasets-documentation.s3.amazonaws.com/lake_formats/iceberg/')
GROUP BY url ORDER BY cnt DESC LIMIT 5
-- Motor de tabla
SELECT url, count() AS cnt
FROM hits_iceberg
GROUP BY url ORDER BY cnt DESC LIMIT 5
-- Catálogo
SELECT url, count() AS cnt
FROM my_lake.`.`
GROUP BY url ORDER BY cnt DESC LIMIT 5
```
La sintaxis de la consulta es idéntica; solo cambia la cláusula `FROM`. Todas las funciones de ClickHouse SQL, los JOIN y las agregaciones funcionan de la misma manera independientemente de la fuente de datos.
## Cargar un subconjunto en ClickHouse
Consultar Iceberg directamente es práctico, pero el rendimiento está limitado por el ancho de banda de la red y la organización de los archivos. Para cargas de trabajo analíticas, cargue los datos en una tabla nativa MergeTree.
Primero, ejecute una consulta filtrada sobre la tabla Iceberg para obtener una referencia:
```sql theme={null}
SELECT
url,
count() AS cnt
FROM hits_iceberg
WHERE counterid = 38
GROUP BY url
ORDER BY cnt DESC
LIMIT 5
```
Esta consulta recorre el conjunto de datos completo en S3, ya que Iceberg no tiene en cuenta el filtro `counterid`; es de esperar que tarde varios segundos.
Ahora crea una tabla MergeTree y carga los datos:
```sql theme={null}
CREATE TABLE hits_clickhouse
(
url String,
eventtime DateTime,
counterid UInt32
)
ENGINE = MergeTree()
ORDER BY (counterid, eventtime);
```
```sql theme={null}
INSERT INTO hits_clickhouse
SELECT url, eventtime, counterid
FROM hits_iceberg
```
Vuelva a ejecutar la misma consulta en la tabla MergeTree:
```sql theme={null}
SELECT
url,
count() AS cnt
FROM hits_clickhouse
WHERE counterid = 38
GROUP BY url
ORDER BY cnt DESC
LIMIT 5
```
Como `counterid` es la primera columna de la clave `ORDER BY`, el índice primario disperso de ClickHouse salta directamente a los gránulos relevantes y solo lee las filas de `counterid = 38`, en lugar de escanear los 100 millones de filas. El resultado es un aumento drástico de la velocidad.
La guía [aceleración de analítica](/es/guides/use-cases/data-warehousing/getting-started/accelerating-analytics) va un paso más allá con tipos `LowCardinality`, índices de texto completo y claves de ordenación optimizadas, y muestra una **mejora de \~40x** en un conjunto de datos de 283 millones de filas.
**Más información:** [Aceleración de analítica con MergeTree](/es/guides/use-cases/data-warehousing/getting-started/accelerating-analytics) abarca la optimización del esquema, la indexación de texto completo y una comparación completa del rendimiento antes y después.
## Escritura en Iceberg
ClickHouse también puede escribir datos de vuelta en tablas de Iceberg, lo que permite flujos de trabajo de ETL inverso: publicar resultados agregados o subconjuntos para que otras herramientas (Spark, Trino, DuckDB, etc.) los consuman.
Cree una tabla de Iceberg para la salida:
```sql theme={null}
CREATE TABLE output_iceberg
(
url String,
cnt UInt64
)
ENGINE = IcebergS3('https://your-bucket.s3.amazonaws.com/output/', 'access_key', 'secret_key')
```
Escriba resultados agregados:
```sql theme={null}
SET allow_experimental_insert_into_iceberg = 1;
INSERT INTO output_iceberg
SELECT
url,
count() AS cnt
FROM hits_clickhouse
GROUP BY url
ORDER BY cnt DESC
```
La tabla Iceberg resultante se puede leer con cualquier motor compatible con Iceberg.
**Más información:** [Escribir datos en formatos de tabla abiertos](/es/guides/use-cases/data-warehousing/getting-started/writing-data) explica cómo escribir datos sin procesar y resultados agregados con el conjunto de datos UK Price Paid, incluidas las consideraciones de esquema al mapear tipos de ClickHouse a Iceberg.
## Próximos pasos
Ahora que ya has visto el flujo de trabajo completo, profundiza en cada área:
* [Consultas directas](/es/guides/use-cases/data-warehousing/getting-started/querying-directly) — Los cuatro formatos, variantes de clúster, motores de tabla, caché
* [Conexión a catálogos](/es/guides/use-cases/data-warehousing/getting-started/connecting-catalogs) — Guía completa de Unity Catalog con Delta e Iceberg
* [Acelerar la analítica](/es/guides/use-cases/data-warehousing/getting-started/accelerating-analytics) — Optimización del esquema, indexación, demostración de aceleración de \~40x
* [Escritura en lagos de datos](/es/guides/use-cases/data-warehousing/getting-started/writing-data) — Escrituras en bruto, escrituras agregadas, mapeo de tipos
* [Matriz de compatibilidad](/es/guides/use-cases/data-warehousing/support-matrix) — Comparación de funcionalidades entre formatos y backends de almacenamiento