Skip to main content
Apache выпустила несколько форматов данных, которые активно используются в аналитических средах, включая популярные Avro, Arrow и Orc. ClickHouse поддерживает импорт и экспорт данных в любом из форматов из этого списка.

Импорт и экспорт в формате Avro

ClickHouse поддерживает чтение и запись файлов данных Apache Avro, которые широко используются в системах Hadoop. Чтобы импортировать данные из файла Avro, следует использовать формат Avro в операторе INSERT:
С помощью функции file() можно также просматривать файлы Avro до фактического импорта данных:
Чтобы экспортировать в файл формата Avro:

Avro и типы данных ClickHouse

Учитывайте соответствие типов данных при импорте и экспорте файлов Avro. При загрузке данных из файлов Avro используйте явное приведение типов для преобразования:

Сообщения Avro в Kafka

Если сообщения в Kafka используют формат Avro, ClickHouse может читать такие потоки с помощью формата AvroConfluent и движка Kafka:

Работа с форматом Arrow

Ещё один столбцовый формат — Apache Arrow, который ClickHouse также поддерживает для импорта и экспорта данных. Чтобы импортировать данные из файла Arrow, используется формат Arrow:
Экспорт в файл Arrow выполняется так же:
Также см. соответствие типов данных, чтобы узнать, не нужно ли какие-либо из них преобразовывать вручную.

Потоковая передача данных Arrow

Формат ArrowStream можно использовать для работы с потоками Arrow (они применяются для обработки данных в памяти). ClickHouse может читать и записывать потоки Arrow. Чтобы показать, как ClickHouse может передавать данные Arrow в потоковом режиме, направим их в следующий скрипт на Python (он читает входной поток в формате Arrow streaming и выводит результат в виде таблицы Pandas):
Теперь мы можем передавать данные из ClickHouse, направив его вывод в скрипт:
ClickHouse также может читать потоки Arrow в том же формате ArrowStream:
Мы использовали arrow-stream в качестве возможного источника данных Arrow в потоковом формате.

Импорт и экспорт данных ORC

Apache ORC — это столбцовый формат хранения данных, обычно используемый в Hadoop. ClickHouse поддерживает как импорт, так и экспорт данных ORC с использованием формата ORC:
Также ознакомьтесь с соответствием типов данных и дополнительными настройками, чтобы настроить экспорт и импорт.

Дополнительные материалы

В ClickHouse поддерживается множество форматов — как текстовых, так и двоичных, — для самых разных сценариев и платформ. Подробнее о форматах и способах работы с ними читайте в следующих статьях: Также обратите внимание на clickhouse-local — переносимый полнофункциональный инструмент для работы с локальными и удалёнными файлами без использования сервера ClickHouse.
Последнее изменение 3 июля 2026 г.