hudi - ClickHouse Documentation

Предоставляет интерфейс, подобный таблице, только для чтения для таблиц Apache Hudi в Amazon S3.

Синтаксис

hudi(url [,aws_access_key_id, aws_secret_access_key] [,format] [,structure] [,compression] [,extra_credentials])

Аргументы

Аргумент	Описание
`url`	URL бакета с путём к существующей таблице Hudi в S3.
`aws_access_key_id`, `aws_secret_access_key`	Долговременные учетные данные пользователя аккаунта AWS. Их можно использовать для аутентификации запросов. Эти параметры необязательны. Если учетные данные не указаны, они берутся из конфигурации ClickHouse. Подробнее см. в разделе Using S3 for Data Storage.
`format`	Формат файла.
`structure`	Структура таблицы. Формат: `'column1_name column1_type, column2_name column2_type, ...'`.
`compression`	Параметр необязателен. Поддерживаемые значения: `none`, `gzip/gz`, `deflate`, `brotli/br`, `xz/LZMA`, `zstd/zst`, `lz4`, `bz2`, `snappy`. По умолчанию сжатие автоматически определяется по расширению файла. Для `snappy` формат передачи данных выбирается настройкой snappy_mode (по умолчанию — `basic`).
`extra_credentials`	Параметр необязателен. Используется для передачи `role_arn` для доступа на основе ролей в ClickHouse Cloud. Инструкции по настройке см. в разделе Secure S3.

Возвращаемое значение

Таблица с указанной структурой для чтения данных из указанной таблицы Hudi в S3.

Виртуальные столбцы

_path — Путь к файлу. Тип: LowCardinality(String).
_file — Имя файла. Тип: LowCardinality(String).
_size — Размер файла в байтах. Тип: Nullable(UInt64). Если размер файла неизвестен, значение — NULL.
_time — Время последнего изменения файла. Тип: Nullable(DateTime). Если время неизвестно, значение — NULL.
_etag — ETag файла. Тип: LowCardinality(String). Если ETag неизвестен, значение — NULL.

См. также

Последнее изменение 26 сентября 2026 г.