> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

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

# hudi

Amazon S3 上の Apache [Hudi](https://hudi.apache.org/) テーブルに対する読み取り専用のテーブル形式インターフェイスを提供します。

<div id="syntax">
  ## 構文
</div>

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

<div id="arguments">
  ## 引数
</div>

| 引数                                           | 説明                                                                                                                                                                                                                                                                            |
| -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`                                        | S3 内の既存の Hudi テーブルへのパスを含むバケット URL。                                                                                                                                                                                                                                            |
| `aws_access_key_id`, `aws_secret_access_key` | [AWS](https://aws.amazon.com/) アカウントユーザーの長期的な認証情報です。これらを使用してリクエストを認証できます。これらのパラメータは省略可能です。認証情報が指定されていない場合は、ClickHouse の設定にある認証情報が使用されます。詳しくは、[Using S3 for Data Storage](/ja/reference/engines/table-engines/mergetree-family/mergetree#table_engine-mergetree-s3) を参照してください。 |
| `format`                                     | ファイルの [フォーマット](/ja/reference/formats/index)。                                                                                                                                                                                                                                  |
| `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](/ja/products/cloud/guides/data-sources/accessing-s3-data-securely) を参照してください。                                                                                                    |

<div id="returned_value">
  ## 戻り値
</div>

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

<div id="virtual-columns">
  ## 仮想カラム
</div>

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

<div id="related">
  ## 関連
</div>

* [Hudi エンジン](/ja/reference/engines/table-engines/integrations/hudi)
* [Hudi cluster テーブル関数](/ja/reference/functions/table-functions/hudiCluster)