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

> Fournit une interface de type table en lecture seule pour les tables Apache Hudi dans Amazon S3.

# hudi

Fournit une interface de type table en lecture seule pour les tables Apache [Hudi](https://hudi.apache.org/) dans Amazon S3.

## Syntaxe

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

## Arguments

| Argument | Description |
| - | - |
| `url` | URL du bucket contenant le chemin vers une table Hudi existante dans S3. |
| `aws_access_key_id`, `aws_secret_access_key` | Identifiants à long terme pour l'utilisateur du compte [AWS](https://aws.amazon.com/). Vous pouvez les utiliser pour authentifier vos requêtes. Ces paramètres sont facultatifs. Si aucun identifiant n'est spécifié, ceux de la configuration ClickHouse sont utilisés. Pour en savoir plus, voir [Utiliser S3 pour le stockage des données](/fr/reference/engines/table-engines/mergetree-family/mergetree#table_engine-mergetree-s3). |
| `format` | Le [format](/fr/reference/formats/index) du fichier. |
| `structure` | Structure de la table. Format : `'column1_name column1_type, column2_name column2_type, ...'`. |
| `compression` | Le paramètre est facultatif. Valeurs prises en charge : `none`, `gzip/gz`, `deflate`, `brotli/br`, `xz/LZMA`, `zstd/zst`, `lz4`, `bz2`, `snappy`. Par défaut, la compression est détectée automatiquement à partir de l'extension du fichier. Pour `snappy`, le format de transmission est sélectionné par le paramètre [snappy\_mode](/fr/reference/settings/session-settings/other#snappy_mode) (`basic` par défaut). |
| `extra_credentials` | Le paramètre est facultatif. Utilisé pour transmettre un `role_arn` pour le contrôle d'accès basé sur les rôles dans ClickHouse Cloud. Voir [Secure S3](/fr/products/cloud/guides/data-sources/accessing-s3-data-securely) pour les étapes de configuration. |

## Valeur renvoyée

Une table ayant la structure spécifiée, permettant de lire les données dans la table Hudi spécifiée sur S3.

## Colonnes virtuelles

* `_path` — Chemin du fichier. Type : `LowCardinality(String)`.
* `_file` — Nom du fichier. Type : `LowCardinality(String)`.
* `_size` — Taille du fichier en octets. Type : `Nullable(UInt64)`. Si la taille du fichier est inconnue, la valeur est `NULL`.
* `_time` — Heure de la dernière modification du fichier. Type : `Nullable(DateTime)`. Si l'heure est inconnue, la valeur est `NULL`.
* `_etag` — ETag du fichier. Type : `LowCardinality(String)`. Si l'ETag est inconnu, la valeur est `NULL`.

## Voir aussi

* [Moteur Hudi](/fr/reference/engines/table-engines/integrations/hudi)
* [Fonction de table cluster Hudi](/fr/reference/functions/table-functions/hudiCluster)