> ## 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.

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

# hudi

Предоставляет интерфейс, подобный таблице, только для чтения для таблиц Apache [Hudi](https://hudi.apache.org/) в Amazon S3.

<div id="syntax">
  ## Синтаксис
</div>

```sql theme={null}
hudi(url [,aws_access_key_id, aws_secret_access_key] [,format] [,structure] [,compression] [,extra_credentials])
```

<div id="arguments">
  ## Аргументы
</div>

| Аргумент                                     | Описание                                                                                                                                                                                                                                                                                                                                                                                   |
| -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `url`                                        | URL бакета с путём к существующей таблице Hudi в S3.                                                                                                                                                                                                                                                                                                                                       |
| `aws_access_key_id`, `aws_secret_access_key` | Долговременные учетные данные пользователя аккаунта [AWS](https://aws.amazon.com/). Их можно использовать для аутентификации запросов. Эти параметры необязательны. Если учетные данные не указаны, они берутся из конфигурации ClickHouse. Подробнее см. в разделе [Using S3 for Data Storage](/ru/reference/engines/table-engines/mergetree-family/mergetree#table_engine-mergetree-s3). |
| `format`                                     | [Формат](/ru/reference/formats) файла.                                                                                                                                                                                                                                                                                                                                                     |
| `structure`                                  | Структура таблицы. Формат: `'column1_name column1_type, column2_name column2_type, ...'`.                                                                                                                                                                                                                                                                                                  |
| `compression`                                | Параметр необязателен. Поддерживаемые значения: `none`, `gzip/gz`, `brotli/br`, `xz/LZMA`, `zstd/zst`. По умолчанию сжатие автоматически определяется по расширению файла.                                                                                                                                                                                                                 |
| `extra_credentials`                          | Параметр необязателен. Используется для передачи `role_arn` для доступа на основе ролей в ClickHouse Cloud. Инструкции по настройке см. в разделе [Secure S3](/ru/products/cloud/guides/data-sources/accessing-s3-data-securely).                                                                                                                                                          |

<div id="returned_value">
  ## Возвращаемое значение
</div>

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

<div id="virtual-columns">
  ## Виртуальные столбцы
</div>

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

<div id="related">
  ## См. также
</div>

* [Движок Hudi](/ru/reference/engines/table-engines/integrations/hudi)
* [Табличная функция cluster для Hudi](/ru/reference/functions/table-functions/hudiCluster)