> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-parallel-read-in-order-multi-part.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Матрица поддержки

> Подробные матрицы поддержки для интеграций ClickHouse с открытыми табличными форматами и подключений к каталогам данных.

На этой странице представлены подробные матрицы поддержки для интеграций ClickHouse с озерами данных. Здесь описаны возможности, доступные для каждого открытого табличного формата, каталоги, к которым может подключаться ClickHouse, а также функции, поддерживаемые каждым каталогом.

Поддержка отдельно указана для ClickHouse Cloud и самоуправляемого ClickHouse. Экспериментальные возможности по умолчанию отключены в ClickHouse Cloud, и их [необходимо запрашивать через службу поддержки](https://clickhouse.com/blog/common-getting-started-issues-with-clickhouse#13-experimental-features-in-production). Доступность зависит от конкретной возможности, поэтому обратитесь в службу поддержки, чтобы подтвердить возможность включения нужной экспериментальной возможности. Конфигурация и ограничения, зависящие от развертывания, описаны в столбце Notes.

<h2 id="format-support">
  Поддержка открытых табличных форматов
</h2>

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). Выберите формат ниже, чтобы посмотреть матрицу поддержки.

**Условные обозначения:** ✅ Поддерживается | ⚠️ Частично, экспериментально или устарело | ❌ Не поддерживается

<Tabs>
  <Tab title="Apache Iceberg">
    | Возможность | ClickHouse Cloud | Самоуправляемый | Примечания |
    | - | :-: | :-: | - |
    | **Бэкенды хранилища** | | | |
    | AWS S3 | ✅ | ✅ | Через [`icebergS3()`](/ru/reference/functions/table-functions/iceberg) или alias `iceberg()` |
    | GCS | ✅ | ✅ | Через [`icebergS3()`](/ru/reference/functions/table-functions/iceberg) или alias `iceberg()` |
    | Azure Blob Storage | ✅ | ✅ | Через [`icebergAzure()`](/ru/reference/functions/table-functions/iceberg) |
    | HDFS | ❌ | ⚠️ Устарело | Через [`icebergHDFS()`](/ru/reference/functions/table-functions/iceberg) |
    | Локальная файловая система | ❌ | ✅ | Через [`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) |
    | Named collections | <Tooltip tip="Уточните доступность в службе поддержки">⚠️</Tooltip> | ✅ | Созданные через DDL [named collections](/ru/concepts/features/configuration/server-config/named-collections) могут быть включены на отдельных сервисах ClickHouse Cloud. Чтобы подтвердить доступность, обратитесь в службу поддержки. |
    | | | | |
    | **Возможности чтения** | | | |
    | Поддержка чтения | ✅ | ✅ | Полная поддержка `SELECT` со всеми функциями ClickHouse SQL |
    | Partition pruning | ✅ | ✅ | См. [Partition pruning](/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). |
    | Time travel / снимки | ✅ | ✅ | Через настройки `iceberg_timestamp_ms` или `iceberg_snapshot_id`. См. [Time travel](/ru/reference/engines/table-engines/integrations/iceberg#time-travel). |
    | Position deletes | ✅ | ✅ | См. [Обработка удалённых строк](/ru/reference/engines/table-engines/integrations/iceberg#deleted-rows). |
    | Equality deletes | ✅ | ✅ | Табличные функции и движки таблиц, начиная с v25.8+. См. [Обработка удалённых строк](/ru/reference/engines/table-engines/integrations/iceberg#deleted-rows). |
    | Merge-on-read | <Tooltip tip="Уточните доступность в службе поддержки">⚠️</Tooltip> | ⚠️ | Экспериментальная возможность. Поддерживается для [операций удаления](/ru/reference/functions/table-functions/iceberg#iceberg-writes-delete). |
    | Версии формата | ⚠️ Частично | ⚠️ Частично | Поддерживаются v1 и v2. Поддержка v3 частичная: чтение векторов удаления поддерживается, а компактизация манифестов — нет. |
    | Column statistics | ✅ | ✅ | |
    | Bloom-фильтры / файлы Puffin | ❌ | ❌ | Индексы на основе bloom-фильтров в файлах Puffin не поддерживаются |
    | Виртуальные столбцы | ✅ | ✅ | `_path`, `_file`, `_size`, `_time`, `_etag`. См. [Виртуальные столбцы](/ru/reference/functions/table-functions/iceberg#virtual-columns). |
    | | | | |
    | **Возможности записи** | | | |
    | Создание таблицы | <Tooltip tip="Уточните доступность в службе поддержки">⚠️</Tooltip> | ⚠️ | Экспериментальная возможность. Требуется `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` | <Tooltip tip="Обратитесь в службу поддержки, чтобы узнать о доступности">⚠️</Tooltip> | ⚠️ | Экспериментальная функция. Требуется `allow_insert_into_iceberg = 1`. Выполняется через `ALTER TABLE ... DELETE WHERE`. См. [Удаление данных](/ru/reference/functions/table-functions/iceberg#iceberg-writes-delete). |
    | `ALTER TABLE` (изменения схемы) | <Tooltip tip="Обратитесь в службу поддержки, чтобы узнать о доступности">⚠️</Tooltip> | ⚠️ | Экспериментальная функция. Требуется `allow_insert_into_iceberg = 1`. Добавление, удаление, изменение и переименование столбцов. См. [Изменение схемы](/ru/reference/functions/table-functions/iceberg#iceberg-writes-schema-evolution). |
    | Компактация | <Tooltip tip="Обратитесь в службу поддержки, чтобы узнать о доступности">⚠️</Tooltip> | ⚠️ | Экспериментальная функция. Требуется `allow_experimental_iceberg_compaction = 1`. См. [Компактация](/ru/reference/functions/table-functions/iceberg#iceberg-writes-compaction). |
    | `UPDATE` / `MERGE` | ❌ | ❌ | Не поддерживается. См. раздел «Компактация». |
    | Копирование при записи | ❌ | ❌ | Не поддерживается |
    | Удаление снимков | <Tooltip tip="Обратитесь в службу поддержки, чтобы узнать о доступности">⚠️</Tooltip> | ⚠️ | Экспериментальная функция. Требуются Iceberg v2, `allow_insert_into_iceberg = 1` и `allow_experimental_expire_snapshots = 1`. См. [Удаление снимков](/ru/reference/functions/table-functions/iceberg#iceberg-expire-snapshots). |
    | Удаление осиротевших файлов | <Tooltip tip="Обратитесь в службу поддержки, чтобы узнать о доступности">⚠️</Tooltip> | ⚠️ | Экспериментальная функция. Требуются Iceberg v2 или более поздней версии, `allow_insert_into_iceberg = 1` и `allow_iceberg_remove_orphan_files = 1`. См. [Удаление осиротевших файлов](/ru/reference/functions/table-functions/iceberg#iceberg-remove-orphan-files). |
    | Запись партиций | ✅ бета | ✅ бета | Поддерживается при записи в Iceberg. |
    | Изменение партиций | ❌ | ❌ | Изменение схемы партиционирования из ClickHouse не поддерживается. ClickHouse может записывать данные в таблицы Iceberg с изменённой схемой партиционирования. |
    | | | | |
    | **Метаданные** | | | |
    | Ветвление и тегирование | ❌ | ❌ | Ссылки на ветви и теги Iceberg не поддерживаются |
    | Определение файла метаданных | ✅ | ✅ | Поддерживается определение через каталоги, просмотр содержимого каталога, `version-hint` и указанный путь. См. [Определение файла метаданных](/ru/reference/engines/table-engines/integrations/iceberg#metadata-file-resolution). |
    | Кэширование данных | ✅ | ✅ | Используется тот же механизм, что и для движков хранилищ S3/Azure/HDFS. См. [Кэш данных](/ru/reference/engines/table-engines/integrations/iceberg#data-cache). |
    | Кэширование метаданных | ✅ | ✅ | Включено по умолчанию с помощью `use_iceberg_metadata_files_cache`. См. [Кэш метаданных](/ru/reference/engines/table-engines/integrations/iceberg#metadata-cache). |
  </Tab>

  <Tab title="Delta Lake">
    Начиная с версии 25.6 ClickHouse читает таблицы Delta Lake с помощью ядра Delta Lake Rust, которое обеспечивает более широкую поддержку возможностей (для Azure Blob Storage включено начиная с версии 26.4). Ниже указано, для каких возможностей требуется это ядро.

    | Возможность | ClickHouse Cloud | Самоуправляемый | Примечания |
    | - | :-: | :-: | - |
    | **Бэкенды хранилища** | | | |
    | 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) |
    | Именованные коллекции | <Tooltip tip="Обратитесь в службу поддержки, чтобы узнать о доступности">⚠️</Tooltip> | ✅ | Именованные коллекции, созданные с помощью DDL ([named collections](/ru/concepts/features/configuration/server-config/named-collections)), могут быть включены в некоторых сервисах ClickHouse Cloud. Обратитесь в службу поддержки, чтобы подтвердить доступность. |
    | **Возможности чтения** | | | |
    | Поддержка чтения | ✅ | ✅ | Полная поддержка `SELECT` со всеми функциями ClickHouse SQL |
    | Отсечение партиций | ✅ бета | ✅ бета | Требуется Delta Kernel. |
    | Изменение схемы | ✅ бета | ✅ бета | Требуется Delta Kernel. |
    | Запросы к прошлым версиям | ✅ бета | ✅ бета | Требуется Delta Kernel. |
    | Векторы удаления | ✅ | ✅ | |
    | Сопоставление столбцов | ✅ | ✅ | |
    | Поток изменений данных | ✅ бета | ✅ бета | Требуется Delta Kernel. |
    | Виртуальные столбцы | ✅ | ✅ | `_path`, `_file`, `_size`, `_time`, `_etag`. См. [Виртуальные столбцы](/ru/reference/functions/table-functions/deltalake#virtual-columns). |
    | **Возможности записи** | | | |
    | `INSERT` | ✅ бета | ✅ бета | Требуется Delta Kernel. Запись поддерживается для S3 и GCS, а начиная с v26.9 — и для Azure. Начиная с v26.7 требуется `allow_delta_lake_writes = 1`; в более ранних версиях используйте `allow_experimental_delta_lake_writes = 1`. См. [Запись в Delta Lake](/ru/reference/functions/table-functions/deltalake#inserting-data). |
    | `DELETE` / `UPDATE` / `MERGE` | ❌ | ❌ | Не поддерживается |
    | Создание пустой таблицы | ❌ | ❌ | Операция `CREATE TABLE` предполагает, что таблица Delta Lake уже существует в объектном хранилище. |
    | **Кэширование** | | | |
    | Кэширование данных | ✅ | ✅ | Тот же механизм, что и для движков хранилища S3/Azure/HDFS. См. [Кэш данных](/ru/reference/engines/table-engines/integrations/deltalake#data-cache). |
  </Tab>

  <Tab title="Apache Hudi">
    | Возможность | ClickHouse Cloud | Самоуправляемый | Примечания |
    | - | :-: | :-: | - |
    | **Бэкенды хранилища** | | | |
    | 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) |
    | Именованные коллекции | <Tooltip tip="Обратитесь в службу поддержки, чтобы узнать о доступности">⚠️</Tooltip> | ✅ | Именованные [коллекции](/ru/concepts/features/configuration/server-config/named-collections), созданные с помощью DDL, можно включить для некоторых сервисов ClickHouse Cloud. Обратитесь в службу поддержки, чтобы уточнить доступность. |
    | **Возможности чтения** | | | |
    | Поддержка чтения | ✅ | ✅ | Полная поддержка `SELECT` со всеми функциями ClickHouse SQL |
    | Изменение схемы | ❌ | ❌ | Не поддерживается |
    | Запросы к данным на определённый момент времени | ❌ | ❌ | Не поддерживается |
    | Виртуальные столбцы | ✅ | ✅ | `_path`, `_file`, `_size`, `_time`, `_etag`. См. [Виртуальные столбцы](/ru/reference/functions/table-functions/hudi#virtual-columns). |
    | **Возможности записи** | | | |
    | `INSERT` / `DELETE` / `UPDATE` | ❌ | ❌ | Интеграция доступна только для чтения |
    | **Кэширование** | | | |
    | Кэширование данных | ❌ | ❌ | Не поддерживается |
  </Tab>

  <Tab title="Apache Paimon">
    | Возможность | ClickHouse Cloud | Самоуправляемый | Примечания |
    | - | :-: | :-: | - |
    | **Бэкенды хранилищ** | | | |
    | S3 | <Tooltip tip="Обратитесь в службу поддержки, чтобы узнать о доступности">⚠️</Tooltip> | ⚠️ | Экспериментальная возможность. Через [`paimon()`](/ru/reference/functions/table-functions/paimon) или `paimonS3()` |
    | GCS | <Tooltip tip="Обратитесь в службу поддержки, чтобы узнать о доступности">⚠️</Tooltip> | ⚠️ | Экспериментальная возможность. Через [`paimon()`](/ru/reference/functions/table-functions/paimon) или `paimonS3()` |
    | Azure Blob Storage | <Tooltip tip="Обратитесь в службу поддержки, чтобы узнать о доступности">⚠️</Tooltip> | ⚠️ | Экспериментальная возможность. Через [`paimonAzure()`](/ru/reference/functions/table-functions/paimon) |
    | HDFS | ❌ | ⚠️ | Экспериментальная и устаревшая возможность. Через [`paimonHDFS()`](/ru/reference/functions/table-functions/paimon) |
    | Локальная файловая система | ❌ | ⚠️ | Экспериментальная возможность. Через [`paimonLocal()`](/ru/reference/functions/table-functions/paimon) |
    | **Методы доступа** | | | |
    | Табличная функция | <Tooltip tip="Обратитесь в службу поддержки, чтобы узнать о доступности">⚠️</Tooltip> | ⚠️ | Экспериментальная возможность. [`paimon()`](/ru/reference/functions/table-functions/paimon) с вариантами для каждого бэкенда |
    | Движок таблицы | <Tooltip tip="Обратитесь в службу поддержки, чтобы узнать о доступности">⚠️</Tooltip> | ⚠️ | Экспериментальная возможность. [`Paimon`](/ru/reference/engines/table-engines/integrations/paimon) с вариантами для каждого бэкенда. Требуется `allow_experimental_paimon_storage_engine = 1`. |
    | Чтение с распределением по кластеру | <Tooltip tip="Обратитесь в службу поддержки, чтобы узнать о доступности">⚠️</Tooltip> | ⚠️ | Экспериментальная возможность. [`paimonS3Cluster`](/ru/reference/functions/table-functions/paimonCluster), [`paimonAzureCluster`](/ru/reference/functions/table-functions/paimonCluster), [`paimonHDFSCluster`](/ru/reference/functions/table-functions/paimonCluster) |
    | Именованные коллекции | <Tooltip tip="Обратитесь в службу поддержки, чтобы узнать о доступности">⚠️</Tooltip> | ⚠️ | Экспериментальная возможность. [Именованные коллекции](/ru/concepts/features/configuration/server-config/named-collections), созданные с помощью DDL, можно включить в некоторых сервисах ClickHouse Cloud. Обратитесь в службу поддержки, чтобы уточнить доступность. |
    | **Возможности чтения** | | | |
    | Поддержка чтения | <Tooltip tip="Обратитесь в службу поддержки, чтобы узнать о доступности">⚠️</Tooltip> | ⚠️ | Экспериментальная возможность. Полная поддержка `SELECT` со всеми функциями ClickHouse SQL |
    | Изменение схемы | ❌ | ❌ | Не поддерживается |
    | Запросы к прошлым версиям | ❌ | ❌ | Не поддерживается |
    | Виртуальные столбцы | <Tooltip tip="Обратитесь в службу поддержки, чтобы узнать о доступности">⚠️</Tooltip> | ⚠️ | Экспериментальная возможность. `_path`, `_file`, `_size`, `_time`, `_etag`. См. [Виртуальные столбцы](/ru/reference/functions/table-functions/paimon#virtual-columns). |
    | **Возможности записи** | | | |
    | `INSERT` / `DELETE` / `UPDATE` | ❌ | ❌ | Интеграция только для чтения |
    | **Кэширование** | | | |
    | Кэширование данных | ❌ | ❌ | Не поддерживается |
  </Tab>
</Tabs>

<h2 id="catalog-support">
  Поддержка каталогов
</h2>

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) |
| [SeaweedFS](/ru/guides/use-cases/data-warehousing/seaweedfs-catalog) | Iceberg | ✅ бета | ✅ бета | ✅ бета | [Руководство по каталогу SeaweedFS](/ru/guides/use-cases/data-warehousing/seaweedfs-catalog) |

Для всех интеграций с каталогами в настоящее время требуется включить экспериментальную или бета-настройку. За исключением Microsoft OneLake, Databricks Unity Catalog и SeaweedFS, все каталоги предоставляют доступ **только для чтения** — таблицы можно запрашивать, но нельзя создавать или записывать в них данные через подключение к каталогу. Чтобы загружать данные из каталога в 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).