> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Матрица поддержки
> Подробные матрицы поддержки для интеграций ClickHouse с открытыми табличными форматами и подключений к каталогам данных.
На этой странице представлены подробные матрицы поддержки для интеграций ClickHouse с озерами данных. Здесь описаны возможности, доступные для каждого открытого табличного формата, каталоги, к которым может подключаться ClickHouse, а также функции, поддерживаемые каждым каталогом.
## Поддержка открытых табличных форматов
ClickHouse интегрируется с четырьмя открытыми табличными форматами: [Apache Iceberg](/ru/reference/engines/table-engines/integrations/iceberg), [Delta Lake](/ru/reference/engines/table-engines/integrations/deltalake), [Apache Hudi](/ru/reference/engines/table-engines/integrations/hudi) и [Apache Paimon](/ru/reference/functions/table-functions/paimon). Выберите формат ниже, чтобы посмотреть матрицу поддержки.
**Условные обозначения:** ✅ Поддерживается | ⚠️ Частично / экспериментально | ❌ Не поддерживается
| Возможность | Статус | Примечания |
| -------------------------------- | :----: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Поддерживаемые хранилища** | | |
| AWS S3 | ✅ | Через [`icebergS3()`](/ru/reference/functions/table-functions/iceberg) или псевдоним `iceberg()` |
| GCS | ✅ | Через [`icebergS3()`](/ru/reference/functions/table-functions/iceberg) или псевдоним `iceberg()` |
| Azure Blob Storage | ✅ | Через [`icebergAzure()`](/ru/reference/functions/table-functions/iceberg) |
| HDFS | ⚠️ | Через [`icebergHDFS()`](/ru/reference/functions/table-functions/iceberg). Устарело. |
| Local filesystem | ✅ | Через [`icebergLocal()`](/ru/reference/functions/table-functions/iceberg) |
| **Методы доступа** | | |
| Табличная функция | ✅ | [`icebergS3()`](/ru/reference/functions/table-functions/iceberg) в вариантах для каждого типа хранилища |
| Движок таблицы | ✅ | [`IcebergS3`](/ru/reference/engines/table-engines/integrations/iceberg) в вариантах для каждого типа хранилища |
| Распределённое чтение в кластере | ✅ | [`icebergS3Cluster`](/ru/reference/functions/table-functions/icebergCluster), [`icebergAzureCluster`](/ru/reference/functions/table-functions/icebergCluster), [`icebergHDFSCluster`](/ru/reference/functions/table-functions/icebergCluster) |
| Именованные коллекции | ✅ | [Определение именованной коллекции](/ru/reference/functions/table-functions/iceberg#defining-a-named-collection) |
| | | |
| **Возможности чтения** | | |
| Поддержка чтения | ✅ | Полная поддержка SELECT со всеми функциями ClickHouse SQL |
| Отсечение партиций | ✅ | См. [Отсечение партиций](/ru/reference/engines/table-engines/integrations/iceberg#partition-pruning). |
| Скрытое партиционирование | ✅ | Поддерживается партиционирование Iceberg на основе преобразований |
| Эволюция партиций | ✅ | Поддерживается чтение таблиц с изменяющимися со временем спецификациями партиций |
| Эволюция схемы | ✅ | Добавление, удаление и изменение порядка столбцов. См. [Эволюция схемы](/ru/reference/engines/table-engines/integrations/iceberg#schema-evolution). |
| Повышение / расширение типов | ✅ | `int` → `long`, `float` → `double`, `decimal(P,S)` → `decimal(P',S)`, где P' > P. См. [Эволюция схемы](/ru/reference/engines/table-engines/integrations/iceberg#schema-evolution). |
| Путешествие во времени / снимки | ✅ | Через настройки `iceberg_timestamp_ms` или `iceberg_snapshot_id`. См. [Путешествие во времени](/ru/reference/engines/table-engines/integrations/iceberg#time-travel). |
| Удаления по позиции | ✅ | См. [Обработка удалённых строк](/ru/reference/engines/table-engines/integrations/iceberg#deleted-rows). |
| Удаления по равенству | ✅ | Только для движка таблицы, начиная с v25.8+. См. [Обработка удалённых строк](/ru/reference/engines/table-engines/integrations/iceberg#deleted-rows). |
| Merge-on-read | ⚠️ | Экспериментальная возможность. Поддерживается для [операций удаления](/ru/reference/functions/table-functions/iceberg#iceberg-writes-delete). |
| Версии формата | ⚠️ | Поддерживаются v1 и v2. V3 не поддерживается. |
| Статистика столбцов | ✅ | |
| Bloom-фильтры / файлы puffin | ❌ | Индексы bloom-фильтров в файлах puffin не поддерживаются |
| Виртуальные столбцы | ✅ | `_path`, `_file`, `_size`, `_time`, `_etag`. См. [Виртуальные столбцы](/ru/reference/functions/table-functions/iceberg#virtual-columns). |
| | | |
| **Возможности записи** | | |
| Создание таблицы | ✅ | Экспериментальная возможность. Требуется `allow_insert_into_iceberg = 1`. Начиная с v25.7+. См. [Создание таблицы](/ru/reference/functions/table-functions/iceberg#create-iceberg-table). |
| INSERT | ✅ | Бета с 26.2. Требуется `allow_insert_into_iceberg = 1`. См. [Вставка данных](/ru/reference/functions/table-functions/iceberg#writes-inserts). |
| DELETE | ✅ | Экспериментально. Требуется `allow_insert_into_iceberg = 1`. Через `ALTER TABLE ... DELETE WHERE`. См. [Удаление данных](/ru/reference/functions/table-functions/iceberg#iceberg-writes-delete). |
| ALTER TABLE (изменения схемы) | ✅ | Экспериментально. Требуется `allow_insert_into_iceberg = 1`. Добавление, удаление, изменение и переименование столбцов. См. [Эволюция схемы](/ru/reference/functions/table-functions/iceberg#iceberg-writes-schema-evolution). |
| Compaction | ⚠️ | Экспериментально. Требуется `allow_experimental_iceberg_compaction = 1`. Объединяет файлы позиционного удаления с файлами данных. См. [Компакция](/ru/reference/functions/table-functions/iceberg#iceberg-writes-compaction). Другие операции компакции Iceberg не поддерживаются. |
| UPDATE / MERGE | ❌ | Не поддерживается. См. Compaction. |
| Copy-on-write | ❌ | Не поддерживается |
| Удаление устаревших снимков | ❌ | Не поддерживается |
| Удаление осиротевших файлов | ❌ | Не поддерживается |
| Запись в партиции | ✅ | Поддерживается. |
| Изменение партиций | ❌ | Изменение схемы партиционирования из ClickHouse не поддерживается. ClickHouse может записывать в таблицы Iceberg с изменённой схемой партиционирования. |
| | | |
| **Метаданные** | | |
| Ветвление и тегирование | ❌ | Ссылки на ветки/теги Iceberg не поддерживаются |
| Определение файла метаданных | ✅ | Поддерживается определение файла метаданных через каталоги, простое перечисление каталога, использование 'version-hint' и указание конкретного пути. Настраивается через `iceberg_metadata_file_path` и `iceberg_metadata_table_uuid`. См. [Определение файла метаданных](/ru/reference/engines/table-engines/integrations/iceberg#metadata-file-resolution). |
| Кэширование данных | ✅ | Тот же механизм, что и в движках хранения S3/Azure/HDFS. См. [Кэш данных](/ru/reference/engines/table-engines/integrations/iceberg#data-cache). |
| Кэширование метаданных | ✅ | Manifest-файлы и файлы метаданных кэшируются в памяти. По умолчанию включено через `use_iceberg_metadata_files_cache`. См. [Кэш метаданных](/ru/reference/engines/table-engines/integrations/iceberg#metadata-cache). |
Начиная с версии 25.6, ClickHouse читает таблицы Delta Lake с использованием Rust-ядра Delta Lake, что расширяет поддержку возможностей; однако при доступе к данным в Azure Blob Storage возникают известные проблемы. По этой причине ядро отключено при чтении данных из Azure Blob Storage. Ниже указано, для каких возможностей требуется это ядро.
| Возможность | Статус | Примечания |
| --------------------------------- | :----: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Поддерживаемые хранилища** | | |
| AWS S3 | ✅ | Через [`deltaLake()`](/ru/reference/functions/table-functions/deltalake) или `deltaLakeS3()` |
| GCS | ✅ | Через [`deltaLake()`](/ru/reference/functions/table-functions/deltalake) или `deltaLakeS3()` |
| Azure Blob Storage | ✅ | Через [`deltaLakeAzure()`](/ru/reference/functions/table-functions/deltalake) |
| HDFS | ❌ | Не поддерживается |
| Локальная файловая система | ✅ | Через [`deltaLakeLocal()`](/ru/reference/functions/table-functions/deltalake) |
| **Методы доступа** | | |
| Табличная функция | ✅ | [`deltaLake()`](/ru/reference/functions/table-functions/deltalake) с вариантами для каждого хранилища |
| Движок таблицы | ✅ | [`DeltaLake`](/ru/reference/engines/table-engines/integrations/deltalake) |
| Распределённое чтение по кластеру | ✅ | [`deltaLakeCluster`](/ru/reference/functions/table-functions/deltalakeCluster), [`deltaLakeAzureCluster`](/ru/reference/functions/table-functions/deltalakeCluster) |
| Именованные коллекции | ✅ | [Именованная коллекция](/ru/reference/functions/table-functions/deltalake#arguments) |
| **Возможности чтения** | | |
| Поддержка чтения | ✅ | Полная поддержка SELECT со всеми функциями ClickHouse SQL |
| Отсечение партиций | ✅ | Требуется Delta Kernel. |
| Эволюция схемы | ✅ | Требуется Delta Kernel. |
| Time travel | ✅ | Требуется Delta Kernel. |
| Векторы удаления | ✅ | |
| Сопоставление столбцов | ✅ | |
| Поток изменений данных | ✅ | Требуется Delta Kernel. |
| Виртуальные столбцы | ✅ | `_path`, `_file`, `_size`, `_time`, `_etag`. См. [Виртуальные столбцы](/ru/reference/functions/table-functions/deltalake#virtual-columns). |
| **Возможности записи** | | |
| INSERT | ✅ | Экспериментальная возможность. Требуется `allow_experimental_delta_lake_writes = 1`. См. [движок DeltaLake](/ru/reference/engines/table-engines/integrations/deltalake). Требуется Delta Kernel. |
| DELETE / UPDATE / MERGE | ❌ | Не поддерживается |
| CREATE empty table | ❌ | Создание новой пустой таблицы Delta Lake не поддерживается. Операция `CREATE TABLE` предполагает, что Delta Lake уже существует в объектном хранилище. |
| **Кэширование** | | |
| Кэширование данных | ✅ | Тот же механизм, что и у движков хранения S3/Azure/HDFS. См. [Кэш данных](/ru/reference/engines/table-engines/integrations/deltalake#data-cache). |
| Возможность | Статус | Примечания |
| -------------------------------- | :----: | ------------------------------------------------------------------------------------------------------------------------------------- |
| **Поддерживаемые хранилища** | | |
| AWS S3 | ✅ | Через [`hudi()`](/ru/reference/functions/table-functions/hudi) |
| GCS | ✅ | Через [`hudi()`](/ru/reference/functions/table-functions/hudi) |
| Azure Blob Storage | ❌ | Не поддерживается |
| HDFS | ❌ | Не поддерживается |
| Локальная файловая система | ❌ | Не поддерживается |
| **Методы доступа** | | |
| Табличная функция | ✅ | [`hudi()`](/ru/reference/functions/table-functions/hudi) |
| Движок таблицы | ✅ | [`Hudi`](/ru/reference/engines/table-engines/integrations/hudi) |
| Распределённое чтение в кластере | ✅ | [`hudiCluster`](/ru/reference/functions/table-functions/hudiCluster) (только S3) |
| Именованные коллекции | ✅ | [Аргументы Hudi](/ru/reference/functions/table-functions/hudi#arguments) |
| **Возможности чтения** | | |
| Поддержка SELECT | ✅ | Полная поддержка SELECT со всеми функциями ClickHouse SQL |
| Эволюция схемы | ❌ | Не поддерживается |
| Запросы к прошлым версиям | ❌ | Не поддерживается |
| Виртуальные столбцы | ✅ | `_path`, `_file`, `_size`, `_time`, `_etag`. См. [Виртуальные столбцы](/ru/reference/functions/table-functions/hudi#virtual-columns). |
| **Возможности записи** | | |
| INSERT / DELETE / UPDATE | ❌ | Интеграция только для чтения |
| **Кэширование** | | |
| Кэширование данных | ❌ | Не поддерживается |
| Возможность | Статус | Примечания |
| -------------------------------- | :----: | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Хранилища** | | |
| S3 | ✅ | Экспериментально. Через [`paimon()`](/ru/reference/functions/table-functions/paimon) или `paimonS3()` |
| GCS | ✅ | Экспериментально. Через [`paimon()`](/ru/reference/functions/table-functions/paimon) или `paimonS3()` |
| Azure Blob Storage | ✅ | Экспериментально. Через [`paimonAzure()`](/ru/reference/functions/table-functions/paimon) |
| HDFS | ⚠️ | Экспериментально. Через [`paimonHDFS()`](/ru/reference/functions/table-functions/paimon). Устаревшее. |
| Local filesystem | ✅ | Экспериментально. Через [`paimonLocal()`](/ru/reference/functions/table-functions/paimon) |
| **Способы доступа** | | |
| Табличная функция | ✅ | Экспериментально. [`paimon()`](/ru/reference/functions/table-functions/paimon) с вариантами для каждого backend-а |
| Движок таблицы | ❌ | Отдельный движок таблицы отсутствует |
| Распределённое чтение в кластере | ✅ | Экспериментально. [`paimonS3Cluster`](/ru/reference/functions/table-functions/paimonCluster), [`paimonAzureCluster`](/ru/reference/functions/table-functions/paimonCluster), [`paimonHDFSCluster`](/ru/reference/functions/table-functions/paimonCluster) |
| Именованные коллекции | ✅ | Экспериментально. [Определение именованной коллекции](/ru/reference/functions/table-functions/paimon#defining-a-named-collection) |
| **Возможности чтения** | | |
| Поддержка чтения | ✅ | Экспериментально. Полная поддержка SELECT со всеми функциями ClickHouse SQL |
| Эволюция схемы | ❌ | Не поддерживается |
| Доступ к прошлым версиям | ❌ | Не поддерживается |
| Виртуальные столбцы | ✅ | Экспериментально. `_path`, `_file`, `_size`, `_time`, `_etag`. См. [Виртуальные столбцы](/ru/reference/functions/table-functions/paimon#virtual-columns). |
| **Возможности записи** | | |
| INSERT / DELETE / UPDATE | ❌ | Интеграция только для чтения |
| **Кэширование** | | |
| Кэширование данных | ❌ | Не поддерживается |
## Поддержка каталогов
ClickHouse может подключаться к внешним каталогам данных с помощью движка базы данных [`DataLakeCatalog`](/ru/reference/engines/database-engines/datalake), который представляет каталог в виде базы данных ClickHouse. Таблицы, зарегистрированные в каталоге, появляются автоматически, и их можно запрашивать с помощью стандартного SQL.
В настоящее время поддерживаются следующие каталоги. Полные инструкции по настройке см. в справочном руководстве для каждого каталога.
| Каталог | Форматы | Чтение | Создание таблицы | INSERT | Справочное руководство |
| ------------------------------------------------------------------------------- | -------------- | :-----------------: | :--------------: | :----: | ---------------------------------------------------------------------------------------------- |
| [Каталог AWS Glue](/ru/guides/use-cases/data-warehousing/glue-catalog) | Iceberg | ✅ бета | ❌ | ❌ | [Руководство по каталогу Glue](/ru/guides/use-cases/data-warehousing/glue-catalog) |
| [BigLake Metastore](/ru/guides/use-cases/data-warehousing/biglake-catalog) | Iceberg | ✅ бета | ❌ | ❌ | [Руководство по BigLake Metastore](/ru/guides/use-cases/data-warehousing/biglake-catalog) |
| [Databricks Unity Catalog](/ru/guides/use-cases/data-warehousing/unity-catalog) | Delta, Iceberg | ✅ бета | ✅ бета | ✅ бета | [Руководство по Unity Catalog](/ru/guides/use-cases/data-warehousing/unity-catalog) |
| [Iceberg REST](/ru/guides/use-cases/data-warehousing/rest-catalog) | Iceberg | ✅ бета | ❌ | ❌ | [Руководство по REST-каталогу](/ru/guides/use-cases/data-warehousing/rest-catalog) |
| [Lakekeeper](/ru/guides/use-cases/data-warehousing/lakekeeper-catalog) | Iceberg | ✅ бета | ❌ | ❌ | [Руководство по каталогу Lakekeeper](/ru/guides/use-cases/data-warehousing/lakekeeper-catalog) |
| [Project Nessie](/ru/guides/use-cases/data-warehousing/nessie-catalog) | Iceberg | ✅ экспериментальный | ❌ | ❌ | [Руководство по каталогу Nessie](/ru/guides/use-cases/data-warehousing/nessie-catalog) |
| [Microsoft OneLake](/ru/guides/use-cases/data-warehousing/onelake-catalog) | Iceberg | ✅ бета | ✅ бета | ✅ бета | [Руководство по каталогу OneLake](/ru/guides/use-cases/data-warehousing/onelake-catalog) |
Для всех интеграций с каталогами в настоящее время требуется включить экспериментальную или бета-настройку. За исключением Microsoft OneLake и Databricks Unity Catalog, все каталоги предоставляют доступ **только для чтения** — таблицы можно запрашивать, но нельзя создавать или записывать в них данные через подключение к каталогу. Чтобы загружать данные из каталога в ClickHouse для ускорения аналитики, используйте `INSERT INTO SELECT`, как описано в [руководстве по ускорению аналитики](/ru/guides/use-cases/data-warehousing/getting-started/accelerating-analytics). Чтобы записывать данные обратно в открытые табличные форматы, создавайте автономные таблицы Iceberg, как описано в [руководстве по записи данных](/ru/guides/use-cases/data-warehousing/getting-started/writing-data).