Перед началом этого краткого руководства у вас должно быть следующее:
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](/docs/get-started/setup/cloud) first.
- Доступ к **озеру данных, совместимому с Iceberg**
- **Data Lake Catalog** (URL + учетные данные)
- В зависимости от типа каталога озера данных — учетные данные для Объектного хранилища (например, S3-совместимого хранилища)
- Как минимум одна существующая таблица Iceberg, зарегистрированная в каталоге
Если в вашем каталоге Iceberg еще нет данных, вы можете загрузить этот набор данных. В этом руководстве мы будем использовать именно его.
## Что вы создадите
В этом кратком руководстве вы:
* Подключитесь к REST-каталогу Iceberg в ClickHouse Cloud
* Создадите базу данных ClickHouse, связанную с этим каталогом
* Выполните запрос к существующей таблице Iceberg напрямую из ClickHouse
* Убедитесь, что ClickHouse читает данные из вашего озера данных
В результате ClickHouse Cloud будет подключен к вашему каталогу Iceberg, и вы сможете выполнять SQL-запросы к таблицам Iceberg без копирования данных.
На этом шаге вы подключитесь к своему 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 должен отобразиться каталог данных с количеством таблиц, доступных в базе данных.
На этом шаге вы выполните запрос к таблице 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.
Не забывайте про кавычки. ClickHouse не поддерживает трехсоставные пространства имен, поэтому `schema.table` нужно заключать в кавычки.
