В предыдущем разделе вы выполняли запросы к открытым табличным форматам, напрямую указывая пути в хранилище. На практике большинство организаций управляют метаданными таблиц через каталог данных — централизованный реестр, в котором отслеживаются местоположения таблиц, схемы и партиции. Когда вы подключаете 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 г.