> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-postgresql-tls-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Fabric OneLake
> En esta guía, le mostraremos cómo consultar sus datos en Microsoft OneLake.
export const galaxyOnClick = eventName => () => {
try {
if (typeof window !== "undefined" && window.galaxy && eventName) {
window.galaxy.track(eventName, {
interaction: "click"
});
}
} catch (e) {}
};
export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
if (link) {
return
Beta
;
}
return ;
};
ClickHouse admite la integración con varios catálogos (OneLake, Unity, Glue, Polaris, etc.). Esta guía le mostrará los pasos para consultar los datos almacenados en Microsoft OneLake con ClickHouse y [OneLake](https://learn.microsoft.com/en-us/fabric/onelake/onelake-overview).
Microsoft OneLake admite varios formatos de tabla para su lakehouse. Con ClickHouse, puede consultar tablas Iceberg.
Como esta función está en beta, deberá habilitarla con:
`SET allow_database_iceberg = 1;`
## Reunir los requisitos de OneLake
Antes de consultar su tabla en Microsoft Fabric, deberá recopilar la siguiente información:
* Un ID de tenant de OneLake (su Entra ID)
* Un Application (client) ID
* Un client secret
* Un warehouse ID y un data item ID
Su warehouse ID es su Workspace ID.
Para el Data Item ID, recomendamos usar su Lakehouse ID. En nuestras pruebas, no funciona con un Warehouse ID.
Consulte la [documentación de Microsoft OneLake](http://learn.microsoft.com/en-us/fabric/onelake/table-apis/table-apis-overview#prerequisites) para obtener ayuda para encontrar estos valores.
## Crear una conexión entre OneLake y ClickHouse
Con la información requerida indicada anteriormente, ya puede crear una conexión entre Microsoft OneLake y ClickHouse, pero antes debe habilitar los catálogos:
```sql theme={null}
SET allow_database_iceberg=1
```
### Conectarse a OneLake
```sql theme={null}
CREATE DATABASE onelake_catalog
ENGINE = DataLakeCatalog('https://onelake.table.fabric.microsoft.com/iceberg')
SETTINGS
catalog_type = 'onelake',
warehouse = 'warehouse_id/data_item_id',
onelake_tenant_id = '',
oauth_server_uri = 'https://login.microsoftonline.com//oauth2/v2.0/token',
auth_scope = 'https://storage.azure.com/.default',
onelake_client_id = '',
onelake_client_secret = ''
```
## Consultar OneLake con ClickHouse
Ahora que la conexión está lista, puede empezar a consultar OneLake:
```sql theme={null}
SHOW TABLES FROM onelake_catalog
```
```response theme={null}
Query id: 8f6124c4-45c2-4351-b49a-89dc13e548a7
┌─name──────────────────────────┐
1. │ year_2017.green_tripdata_2017 │
2. │ year_2018.green_tripdata_2018 │
3. │ year_2019.green_tripdata_2019 │
4. │ year_2020.green_tripdata_2020 │
5. │ year_2022.green_tripdata_2022 │
└───────────────────────────────┘
```
Si estás usando el cliente Iceberg, solo se mostrarán las tablas Delta con Uniform activado:
Para consultar una tabla:
```sql theme={null}
SELECT *
FROM onelake_catalog.`year_2017.green_tripdata_2017`
LIMIT 1
```
```response theme={null}
Query id: db6b4bda-cc58-4ca1-8891-e0d14f02c890
Row 1:
──────
VendorID: 2
lpep_pickup_datetime: 2017-05-18 16:55:43.000000
lpep_dropoff_datetime: 2017-05-18 18:04:11.000000
store_and_fwd_flag: N
RatecodeID: 2
PULocationID: 130
DOLocationID: 48
passenger_count: 2
trip_distance: 12.43
fare_amount: 52
extra: 4.5
mta_tax: 0.5
tip_amount: 0
tolls_amount: 33
ehail_fee: ᴺᵁᴸᴸ
improvement_surcharge: 0.3
total_amount: 90.3
payment_type: 2
trip_type: 1
congestion_surcharge: ᴺᵁᴸᴸ
source_file: green_tripdata_2017-05.parquet
```
**Comillas invertidas obligatorias**
Las comillas invertidas son obligatorias porque ClickHouse no admite más de un espacio de nombres.
Para inspeccionar el DDL de la tabla:
```sql theme={null}
SHOW CREATE TABLE onelake_catalog.`year_2017.green_tripdata_2017`
```
```response theme={null}
Query id: 8bd5bd8e-83be-453e-9a88-32de12ba7f24
┌─statement───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
1. │ CREATE TABLE onelake_catalog.`year_2017.green_tripdata_2017` ↴│
│↳( ↴│
│↳ `VendorID` Nullable(Int64), ↴│
│↳ `lpep_pickup_datetime` Nullable(DateTime64(6, 'UTC')), ↴│
│↳ `lpep_dropoff_datetime` Nullable(DateTime64(6, 'UTC')), ↴│
│↳ `store_and_fwd_flag` Nullable(String), ↴│
│↳ `RatecodeID` Nullable(Int64), ↴│
│↳ `PULocationID` Nullable(Int64), ↴│
│↳ `DOLocationID` Nullable(Int64), ↴│
│↳ `passenger_count` Nullable(Int64), ↴│
│↳ `trip_distance` Nullable(Float64), ↴│
│↳ `fare_amount` Nullable(Float64), ↴│
│↳ `extra` Nullable(Float64), ↴│
│↳ `mta_tax` Nullable(Float64), ↴│
│↳ `tip_amount` Nullable(Float64), ↴│
│↳ `tolls_amount` Nullable(Float64), ↴│
│↳ `ehail_fee` Nullable(Float64), ↴│
│↳ `improvement_surcharge` Nullable(Float64), ↴│
│↳ `total_amount` Nullable(Float64), ↴│
│↳ `payment_type` Nullable(Int64), ↴│
│↳ `trip_type` Nullable(Int64), ↴│
│↳ `congestion_surcharge` Nullable(Float64), ↴│
│↳ `source_file` Nullable(String) ↴│
│↳) ↴│
│↳ENGINE = Iceberg('abfss://@onelake.dfs.fabric.microsoft.com//Tables/year_2017/green_tripdata_2017') │
└─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
```
## Cargar datos desde tu lago de datos en ClickHouse
Si necesitas cargar datos desde OneLake en ClickHouse:
```sql theme={null}
CREATE TABLE trips
ENGINE = MergeTree
ORDER BY coalesce(VendorID, 0)
AS SELECT *
FROM onelake_catalog.`year_2017.green_tripdata_2017`
```
```response theme={null}
Query id: d15983a6-ef6a-40fe-80d5-19274b9fe328
Ok.
0 rows in set. Elapsed: 32.570 sec. Processed 11.74 million rows, 275.37 MB (360.36 thousand rows/s., 8.45 MB/s.)
Peak memory usage: 1.31 GiB.
```