Перейти к основному содержанию
В предыдущем разделе вы выполняли запросы к открытым табличным форматам, напрямую указывая пути в хранилище. На практике большинство организаций управляют метаданными таблиц через каталог данных — централизованный реестр, в котором отслеживаются местоположения таблиц, схемы и партиции. Когда вы подключаете ClickHouse к каталогу с помощью движка базы данных DataLakeCatalog, весь каталог становится доступен как база данных ClickHouse. Каждая таблица в каталоге появляется автоматически, и к ней можно выполнять запросы, используя все возможности ClickHouse SQL, — не нужно знать пути к отдельным таблицам или управлять учетными данными для каждой таблицы. В этом руководстве показано, как подключиться к Databricks Unity Catalog. ClickHouse также поддерживает следующие каталоги — полные инструкции по настройке см. в соответствующих справочных руководствах:

Подключение к Unity Catalog

Для примера будем использовать Unity Catalog. Databricks Unity Catalog обеспечивает централизованное управление данными lakehouse в Databricks. Databricks поддерживает несколько форматов данных для своего lakehouse. В ClickHouse можно выполнять запросы к таблицам Unity Catalog как к таблицам Delta и Iceberg.
Интеграция с Unity Catalog работает как с управляемыми, так и с внешними таблицами. В настоящее время эта интеграция поддерживается только в AWS.

Настройка Unity в Databricks

Чтобы ClickHouse мог взаимодействовать с Unity Catalog, необходимо убедиться, что ваш Unity Catalog настроен для работы с внешним клиентом чтения. Для этого следуйте руководству “Enable external data access to Unity Catalog”. Помимо включения внешнего доступа, убедитесь, что субъект, настраивающий интеграцию, имеет привилегию EXTERNAL USE SCHEMA для схемы, содержащей таблицы. После настройки каталога необходимо сгенерировать учетные данные для ClickHouse. В зависимости от режима взаимодействия с Unity можно использовать два разных метода:
  • Для клиентов Iceberg используйте аутентификацию через сервисный субъект.
  • Для клиентов Delta используйте Personal Access Token (PAT).

Подключение к каталогу

Имея учетные данные, вы можете подключиться к соответствующей конечной точке и выполнять запросы к таблицам Iceberg или Delta.
Для доступа к данным в формате Delta следует использовать Unity Catalog.

Список таблиц

После установления соединения с вашим каталогом вы можете вывести список таблиц.

Изучение схем таблиц

Мы можем использовать стандартную команду SHOW CREATE TABLE, чтобы посмотреть, как были созданы таблицы.
Обратные кавычки обязательныОбратите внимание: необходимо указывать пространство имен и имя таблицы, заключая их в обратные кавычки, — ClickHouse не поддерживает более одного пространства имен.
Ниже предполагается выполнение запросов к REST-каталогу Iceberg:

Запросы к таблице

Поддерживаются все функции ClickHouse. Напоминаем, что пространство имен и имя таблицы должны быть заключены в обратные кавычки.
Полные инструкции по настройке см. в справочном руководстве по Unity Catalog.
Последнее изменение 25 июня 2026 г.