Подробные матрицы поддержки для интеграций ClickHouse с открытыми табличными форматами и подключений к каталогам данных.
На этой странице представлены подробные матрицы поддержки для интеграций ClickHouse с озерами данных. Здесь описаны возможности, доступные для каждого открытого табличного формата, каталоги, к которым может подключаться ClickHouse, а также функции, поддерживаемые каждым каталогом.Поддержка отдельно указана для ClickHouse Cloud и самоуправляемого ClickHouse. Экспериментальные возможности по умолчанию отключены в ClickHouse Cloud, и их необходимо запрашивать через службу поддержки. Доступность зависит от конкретной возможности, поэтому обратитесь в службу поддержки, чтобы подтвердить возможность включения нужной экспериментальной возможности. Конфигурация и ограничения, зависящие от развертывания, описаны в столбце Notes.
Созданные через DDL named collections могут быть включены на отдельных сервисах ClickHouse Cloud. Чтобы подтвердить доступность, обратитесь в службу поддержки.
Возможности чтения
Поддержка чтения
✅
✅
Полная поддержка SELECT со всеми функциями ClickHouse SQL
Экспериментальная возможность. Требуется allow_insert_into_iceberg = 1. Начиная с v25.7+. См. Создание таблицы.
INSERT
✅ бета
✅ бета
Бета-версия с 26.2. Требуется allow_insert_into_iceberg = 1. См. Вставка данных.
DELETE
⚠️
Экспериментальная функция. Требуется allow_insert_into_iceberg = 1. Выполняется через ALTER TABLE ... DELETE WHERE. См. Удаление данных.
ALTER TABLE (изменения схемы)
⚠️
Экспериментальная функция. Требуется allow_insert_into_iceberg = 1. Добавление, удаление, изменение и переименование столбцов. См. Изменение схемы.
Компактация
⚠️
Экспериментальная функция. Требуется allow_experimental_iceberg_compaction = 1. См. Компактация.
UPDATE / MERGE
❌
❌
Не поддерживается. См. раздел «Компактация».
Копирование при записи
❌
❌
Не поддерживается
Удаление снимков
⚠️
Экспериментальная функция. Требуются Iceberg v2, allow_insert_into_iceberg = 1 и allow_experimental_expire_snapshots = 1. См. Удаление снимков.
Удаление осиротевших файлов
⚠️
Экспериментальная функция. Требуются Iceberg v2 или более поздней версии, allow_insert_into_iceberg = 1 и allow_iceberg_remove_orphan_files = 1. См. Удаление осиротевших файлов.
Запись партиций
✅ бета
✅ бета
Поддерживается при записи в Iceberg.
Изменение партиций
❌
❌
Изменение схемы партиционирования из ClickHouse не поддерживается. ClickHouse может записывать данные в таблицы Iceberg с изменённой схемой партиционирования.
Метаданные
Ветвление и тегирование
❌
❌
Ссылки на ветви и теги Iceberg не поддерживаются
Определение файла метаданных
✅
✅
Поддерживается определение через каталоги, просмотр содержимого каталога, version-hint и указанный путь. См. Определение файла метаданных.
Кэширование данных
✅
✅
Используется тот же механизм, что и для движков хранилищ S3/Azure/HDFS. См. Кэш данных.
Кэширование метаданных
✅
✅
Включено по умолчанию с помощью use_iceberg_metadata_files_cache. См. Кэш метаданных.
Начиная с версии 25.6 ClickHouse читает таблицы Delta Lake с помощью ядра Delta Lake Rust, которое обеспечивает более широкую поддержку возможностей. Однако при доступе к данным в Azure Blob Storage возникают известные проблемы. Поэтому при чтении данных из Azure Blob Storage ядро отключено. Ниже указано, для каких возможностей требуется это ядро.
Именованные коллекции, созданные с помощью DDL (named collections), могут быть включены в некоторых сервисах ClickHouse Cloud. Обратитесь в службу поддержки, чтобы подтвердить доступность.
Возможности чтения
Поддержка чтения
✅
✅
Полная поддержка SELECT со всеми функциями ClickHouse SQL
Требуется Delta Kernel. Запись поддерживается для S3 и GCS; запись в Azure не поддерживается. Начиная с v26.7 требуется allow_delta_lake_writes = 1; в более ранних версиях используйте allow_experimental_delta_lake_writes = 1. См. Запись в Delta Lake.
DELETE / UPDATE / MERGE
❌
❌
Не поддерживается
Создание пустой таблицы
❌
❌
Операция CREATE TABLE предполагает, что таблица Delta Lake уже существует в объектном хранилище.
Кэширование
Кэширование данных
✅
✅
Тот же механизм, что и для движков хранилища S3/Azure/HDFS. См. Кэш данных.
Именованные коллекции, созданные с помощью DDL, можно включить для некоторых сервисов ClickHouse Cloud. Обратитесь в службу поддержки, чтобы уточнить доступность.
Возможности чтения
Поддержка чтения
✅
✅
Полная поддержка SELECT со всеми функциями ClickHouse SQL
Экспериментальная возможность. Именованные коллекции, созданные с помощью DDL, можно включить в некоторых сервисах ClickHouse Cloud. Обратитесь в службу поддержки, чтобы уточнить доступность.
Возможности чтения
Поддержка чтения
⚠️
Экспериментальная возможность. Полная поддержка SELECT со всеми функциями ClickHouse SQL
Изменение схемы
❌
❌
Не поддерживается
Запросы к прошлым версиям
❌
❌
Не поддерживается
Виртуальные столбцы
⚠️
Экспериментальная возможность. _path, _file, _size, _time, _etag. См. Виртуальные столбцы.
ClickHouse может подключаться к внешним каталогам данных с помощью движка базы данных DataLakeCatalog, который представляет каталог в виде базы данных ClickHouse. Таблицы, зарегистрированные в каталоге, появляются автоматически, и их можно запрашивать с помощью стандартного SQL.В настоящее время поддерживаются следующие каталоги. Полные инструкции по настройке см. в справочном руководстве для каждого каталога.
Для всех интеграций с каталогами в настоящее время требуется включить экспериментальную или бета-настройку. За исключением Microsoft OneLake, Databricks Unity Catalog и SeaweedFS, все каталоги предоставляют доступ только для чтения — таблицы можно запрашивать, но нельзя создавать или записывать в них данные через подключение к каталогу. Чтобы загружать данные из каталога в ClickHouse для ускорения аналитики, используйте INSERT INTO SELECT, как описано в руководстве по ускорению аналитики. Чтобы записывать данные обратно в открытые табличные форматы, создавайте автономные таблицы Iceberg, как описано в руководстве по записи данных.
