メインコンテンツへスキップ
Amazon S3 上の Apache Hudi テーブルに対する読み取り専用のテーブル形式インターフェイスを提供します。

構文

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

引数

引数説明
urlS3 内の既存の Hudi テーブルへのパスを含むバケット URL。
aws_access_key_id, aws_secret_access_keyAWS アカウントユーザーの長期的な認証情報です。これらを使用してリクエストを認証できます。これらのパラメータは省略可能です。認証情報が指定されていない場合は、ClickHouse の設定にある認証情報が使用されます。詳しくは、Using S3 for Data Storage を参照してください。
formatファイルの フォーマット
structureテーブルの構造。形式は 'column1_name column1_type, column2_name column2_type, ...' です。
compressionこのパラメータは省略可能です。サポートされる値: none, gzip/gz, brotli/br, xz/LZMA, zstd/zst。デフォルトでは、圧縮形式はファイル拡張子から自動判別されます。
extra_credentialsこのパラメータは省略可能です。ClickHouse Cloud でロールベースアクセスに使用する role_arn を渡すために使います。設定手順については、Secure S3 を参照してください。

戻り値

S3上の指定されたHudiテーブルのデータを読み取るための、指定された構造を持つテーブル。

仮想カラム

  • _path — ファイルへのパス。型: LowCardinality(String)
  • _file — ファイル名。型: LowCardinality(String)
  • _size — ファイルサイズ (バイト単位) 。型: Nullable(UInt64)。ファイルサイズが不明な場合、値は NULL です。
  • _time — ファイルの最終更新時刻。型: Nullable(DateTime)。時刻が不明な場合、値は NULL です。
  • _etag — ファイルの etag。型: LowCardinality(String)。etag が不明な場合、値は NULL です。
最終更新日 2026年6月10日