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

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

<div id="syntax">
  ## Sintaxe
</div>

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

<div id="arguments">
  ## Argumentos
</div>

| 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) 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`, `brotli/br`, `xz/LZMA`, `zstd/zst`. Por padrão, a compressão será detectada automaticamente pela extensão do arquivo.                                                                                                                                                                                                                                                                 |
| `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.                                                                                                                                                                                             |

<div id="returned_value">
  ## Valor retornado
</div>

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

<div id="virtual-columns">
  ## Colunas virtuais
</div>

* `_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`.

<div id="related">
  ## Relacionados
</div>

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