> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Как подключить каталог Iceberg в ClickHouse Cloud

> Узнайте, как подключить ClickHouse Cloud к вашему каталогу данных и выполнять запросы к таблицам Iceberg.

[All quickstarts](https://clickhouse.com/docs/get-started/quickstarts/home.md)

Хранилище данныхCloud

## Предварительные требования

Перед началом этого краткого руководства у вас должно быть следующее:

To successfully follow this guide, you'll need the following:

* A running ClickHouse Cloud service. If you don't have one yet, complete the [ClickHouse Cloud quick start](https://clickhouse.com/docs/get-started/setup/cloud.md) first.

- Доступ к **озеру данных, совместимому с Iceberg**
- **Data Lake Catalog** (URL + учетные данные)
- В зависимости от типа каталога озера данных — учетные данные для Объектного хранилища (например, S3-совместимого хранилища)
- Как минимум одна существующая таблица Iceberg, зарегистрированная в каталоге

Если в вашем каталоге Iceberg еще нет данных, вы можете загрузить этот набор данных. В этом руководстве мы будем использовать именно его.

## Что вы создадите

В этом кратком руководстве вы:

* Подключитесь к REST-каталогу Iceberg в ClickHouse Cloud
* Создадите базу данных ClickHouse, связанную с этим каталогом
* Выполните запрос к существующей таблице Iceberg напрямую из ClickHouse
* Убедитесь, что ClickHouse читает данные из вашего озера данных

В результате ClickHouse Cloud будет подключен к вашему каталогу Iceberg, и вы сможете выполнять SQL-запросы к таблицам Iceberg без копирования данных.

### 1. Создайте подключение к DataLakeCatalog

На этом шаге вы подключитесь к своему Data Lake Catalog в ClickHouse Cloud.

1. Откройте свой сервис ClickHouse Cloud.

2. Перейдите в **Data Sources â Connect to your Data Lake Catalog**.

3. Выберите каталог данных в раскрывающемся списке.

4. Заполните форму, указав учетные данные и параметры подключения.
   Для Unity Catalog укажите:

   * Open Table Format (Iceberg)
   * Имя базы данных ClickHouse. Это будет имя базы данных ClickHouse, из которой вы будете выполнять запросы к своим таблицам Iceberg.
   * ID рабочего пространства
   * Имя каталога Databricks
   * ID клиента
   * Секрет клиента

   **вставьте изображения**

5. Сохраните каталог. После этого на странице Data Sources должен отобразиться каталог данных с количеством таблиц, доступных в базе данных.

### 2. Выполните запрос к таблице Iceberg

На этом шаге вы выполните запрос к таблице Iceberg из своего каталога данных.

1. Нажав `Show Tables` или `SQL Console`, вы попадете в консоль SQL,
   где будет доступна новая база данных, материализованная из вашего озера данных. Если вы переходите через `SQL Console`, выберите в раскрывающемся списке вашу базу данных Iceberg.
2. В дереве файлов должна появиться одна или несколько таблиц Iceberg. Выполните этот запрос:

```sql theme={null}
select * from iceberg_database.`iceberg_db.your_table`
```

3. ClickHouse вернет строки из вашей таблицы Iceberg.

## Следующие шаги

Теперь, когда вы подключились к своему озеру данных, вы можете попробовать записать таблицу Iceberg в ClickHouse.

> [!TIP]
>
> Не забывайте про кавычки. ClickHouse не поддерживает трехсоставные пространства имен, поэтому `schema.table` нужно заключать в кавычки.

[![ClickHouse Academy — Master ClickHouse with expert-designed training for every skill level](https://mintcdn.com/private-7c7dfe99/EDr8ydtGBgFPOQea/images/academy.webp?fit=max\&auto=format\&n=EDr8ydtGBgFPOQea\&q=85\&s=27e92fc656183cc2f176211907a7aa49)](https://learn.clickhouse.com/)

Check out the ClickHouse academy for on-demand and live training

[All quickstarts](https://clickhouse.com/docs/get-started/quickstarts/home.md)
