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

> Fornece uma interface semelhante a tabela, somente leitura, para tabelas do Apache Hudi no Amazon S3.

# hudi

Fornece uma interface semelhante a tabela, somente leitura, para tabelas do Apache [Hudi](https://hudi.apache.org/) no Amazon S3.

## Sintaxe

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

## Argumentos

| Argumento | Descrição |
| - | - |
| `url` | URL do bucket com o caminho para uma tabela Hudi existente no S3. |
| `aws_access_key_id`, `aws_secret_access_key` | Credenciais de longo prazo para o usuário da conta [AWS](https://aws.amazon.com/). Você pode usá-las para autenticar suas requisições. Esses parâmetros são opcionais. Se as credenciais não forem especificadas, elas serão obtidas da configuração do ClickHouse. Para obter mais informações, consulte [Usando o S3 para armazenamento de dados](/pt-BR/reference/engines/table-engines/mergetree-family/mergetree#table_engine-mergetree-s3). |
| `format` | O [formato](/pt-BR/reference/formats/index) do arquivo. |
| `structure` | Estrutura da tabela. Formato: `'column1_name column1_type, column2_name column2_type, ...'`. |
| `compression` | O parâmetro é opcional. Valores aceitos: `none`, `gzip/gz`, `deflate`, `brotli/br`, `xz/LZMA`, `zstd/zst`, `lz4`, `bz2`, `snappy`. Por padrão, a compressão será detectada automaticamente pela extensão do arquivo. Para `snappy`, o formato wire é selecionado pela configuração [snappy\_mode](/pt-BR/reference/settings/session-settings/other#snappy_mode) (`basic` por padrão). |
| `extra_credentials` | O parâmetro é opcional. Usado para passar um `role_arn` para controle de acesso baseado em função no ClickHouse Cloud. Consulte [S3 seguro](/pt-BR/products/cloud/guides/data-sources/accessing-s3-data-securely) para ver as etapas de configuração. |

## Valor retornado

Uma tabela com a estrutura especificada para ler dados da tabela Hudi especificada no S3.

## Colunas virtuais

* `_path` — Caminho do arquivo. Tipo: `LowCardinality(String)`.
* `_file` — Nome do arquivo. Tipo: `LowCardinality(String)`.
* `_size` — Tamanho do arquivo em bytes. Tipo: `Nullable(UInt64)`. Se o tamanho do arquivo for desconhecido, o valor é `NULL`.
* `_time` — Horário da última modificação do arquivo. Tipo: `Nullable(DateTime)`. Se o horário for desconhecido, o valor é `NULL`.
* `_etag` — O etag do arquivo. Tipo: `LowCardinality(String)`. Se o etag for desconhecido, o valor é `NULL`.

## Relacionados

* [motor Hudi](/pt-BR/reference/engines/table-engines/integrations/hudi)
* [função de tabela cluster Hudi](/pt-BR/reference/functions/table-functions/hudiCluster)