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

> Une extension de la fonction de table hudi. Permet de traiter, en parallèle sur plusieurs nœuds d'un cluster spécifié, des fichiers issus de tables Apache Hudi dans Amazon S3.

# Fonction de table hudiCluster

Il s'agit d'une extension de la fonction de table [hudi](/fr/reference/functions/table-functions/hudi).

Elle permet de traiter, en parallèle sur plusieurs nœuds d'un cluster spécifié, des fichiers issus de tables Apache [Hudi](https://hudi.apache.org/) dans Amazon S3. Sur l'initiateur, elle établit une connexion à tous les nœuds du cluster et répartit dynamiquement les fichiers. Sur le nœud worker, elle demande à l'initiateur la tâche suivante à traiter, puis l'exécute. Ce processus se répète jusqu'à ce que toutes les tâches soient terminées.

## Syntaxe

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

## Arguments

| Argument | Description |
| - | - |
| `cluster_name` | Nom d’un cluster utilisé pour construire un ensemble d’adresses et de paramètres de connexion pour des serveurs distants et locaux. |
| `url` | URL du bucket contenant le chemin vers une table Hudi existante dans S3. |
| `aws_access_key_id`, `aws_secret_access_key` | Informations d’identification à long terme de l’utilisateur du compte [AWS](https://aws.amazon.com/). Vous pouvez les utiliser pour authentifier vos requêtes. Ces paramètres sont facultatifs. Si aucune information d’identification n’est spécifiée, celles de la configuration de ClickHouse sont utilisées. Pour plus d’informations, consultez [Utilisation de 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. Il permet de transmettre un `role_arn` pour le contrôle d’accès basé sur les rôles dans ClickHouse Cloud. Consultez [Secure S3](/fr/products/cloud/guides/data-sources/accessing-s3-data-securely) pour connaître les étapes de configuration. |

## Valeur renvoyée

Une table ayant la structure spécifiée pour lire les données d’un cluster à partir de la table Hudi spécifiée dans 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` — Date et heure de la dernière modification du fichier. Type : `Nullable(DateTime)`. Si cette information 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 Hudi](/fr/reference/functions/table-functions/hudi)
