Set up docs MCPПредварительные требования
Перед началом этого краткого руководства у вас должно быть следующее:
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 first.
- Доступ к озеру данных, совместимому с Iceberg
- Data Lake Catalog (URL + учетные данные)
- В зависимости от типа каталога озера данных — учетные данные для Объектного хранилища (например, S3-совместимого хранилища)
- Как минимум одна существующая таблица Iceberg, зарегистрированная в каталоге
Если в вашем каталоге Iceberg еще нет данных, вы можете загрузить этот набор данных. В этом руководстве мы будем использовать именно его.
Что вы создадите
В этом кратком руководстве вы:
- Подключитесь к REST-каталогу Iceberg в ClickHouse Cloud
- Создадите базу данных ClickHouse, связанную с этим каталогом
- Выполните запрос к существующей таблице Iceberg напрямую из ClickHouse
- Убедитесь, что ClickHouse читает данные из вашего озера данных
В результате ClickHouse Cloud будет подключен к вашему каталогу Iceberg, и вы сможете выполнять SQL-запросы к таблицам Iceberg без копирования данных.
Создайте подключение к DataLakeCatalog
На этом шаге вы подключитесь к своему Data Lake Catalog в ClickHouse Cloud.
-
Откройте свой сервис ClickHouse Cloud.
-
Перейдите в Data Sources â Connect to your Data Lake Catalog.
-
Выберите каталог данных в раскрывающемся списке.
-
Заполните форму, указав учетные данные и параметры подключения. Для Unity Catalog укажите:
- Open Table Format (Iceberg)
- Имя базы данных ClickHouse. Это будет имя базы данных ClickHouse, из которой вы будете выполнять запросы к своим таблицам Iceberg.
- ID рабочего пространства
- Имя каталога Databricks
- ID клиента
- Секрет клиента
вставьте изображения
-
Сохраните каталог. После этого на странице Data Sources должен отобразиться каталог данных с количеством таблиц, доступных в базе данных.
Выполните запрос к таблице Iceberg
На этом шаге вы выполните запрос к таблице Iceberg из своего каталога данных.
- Нажав
Show TablesилиSQL Console, вы попадете в консоль SQL, где будет доступна новая база данных, материализованная из вашего озера данных. Если вы переходите черезSQL Console, выберите в раскрывающемся списке вашу базу данных Iceberg. - В дереве файлов должна появиться одна или несколько таблиц Iceberg. Выполните этот запрос:
select * from iceberg_database.`iceberg_db.your_table`- ClickHouse вернет строки из вашей таблицы Iceberg.
Следующие шаги
Теперь, когда вы подключились к своему озеру данных, вы можете попробовать записать таблицу Iceberg в ClickHouse.
