Amazon S3 上の Apache Hudi テーブルに対する読み取り専用のテーブル形式インターフェイスを提供します。
構文
hudi(url [,aws_access_key_id, aws_secret_access_key] [,format] [,structure] [,compression] [,extra_credentials])引数
| 引数 | 説明 |
|---|---|
url |
S3 内の既存の Hudi テーブルへのパスを含むバケット URL。 |
aws_access_key_id, aws_secret_access_key |
AWS アカウントユーザーの長期的な認証情報です。これらを使用してリクエストを認証できます。これらのパラメータは省略可能です。認証情報が指定されていない場合は、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です。