Passer au contenu principal
Fournit une interface de type table en lecture seule pour les tables Apache Hudi dans Amazon S3.

Syntaxe

hudi(url [,aws_access_key_id, aws_secret_access_key] [,format] [,structure] [,compression] [,extra_credentials])

Arguments

ArgumentDescription
urlURL du bucket contenant le chemin vers une table Hudi existante dans S3.
aws_access_key_id, aws_secret_access_keyIdentifiants à long terme pour l’utilisateur du compte AWS. 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.
formatLe format du fichier.
structureStructure de la table. Format : 'column1_name column1_type, column2_name column2_type, ...'.
compressionLe paramètre est facultatif. Valeurs prises en charge : none, gzip/gz, brotli/br, xz/LZMA, zstd/zst. Par défaut, la compression est détectée automatiquement à partir de l’extension du fichier.
extra_credentialsLe 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 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.
Dernière modification le 25 juin 2026