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

> hudi 테이블 함수의 확장 기능입니다. 지정된 클러스터의 여러 노드에서 Amazon S3의 Apache Hudi 테이블 파일을 병렬로 처리할 수 있습니다.

# hudiCluster 테이블 함수

이 함수는 [hudi](/ko/reference/functions/table-functions/hudi) 테이블 함수의 확장 기능입니다.

지정된 클러스터의 여러 노드에서 Amazon S3의 Apache [Hudi](https://hudi.apache.org/) 테이블 파일을 병렬로 처리할 수 있습니다. initiator 노드에서는 클러스터의 모든 노드와 연결을 설정하고 각 파일을 동적으로 분배합니다. 워커 노드는 initiator 노드에 다음으로 처리할 작업을 요청해 처리합니다. 이 과정은 모든 작업이 완료될 때까지 반복됩니다.

<div id="syntax">
  ## 구문
</div>

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

<div id="arguments">
  ## 인수
</div>

| Argument                                     | Description                                                                                                                                                                                                                                                                          |
| -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `cluster_name`                               | 원격 서버와 로컬 서버의 주소 집합 및 연결 매개변수를 구성하는 데 사용되는 클러스터 이름입니다.                                                                                                                                                                                                                               |
| `url`                                        | S3에 있는 기존 Hudi table의 경로가 포함된 버킷 url입니다.                                                                                                                                                                                                                                             |
| `aws_access_key_id`, `aws_secret_access_key` | [AWS](https://aws.amazon.com/) 계정 사용자의 장기 자격 증명입니다. 이를 사용하여 요청을 인증할 수 있습니다. 이 매개변수는 선택 사항입니다. 자격 증명을 지정하지 않으면 ClickHouse 구성에 있는 자격 증명이 사용됩니다. 자세한 내용은 [Using S3 for Data Storage](/ko/reference/engines/table-engines/mergetree-family/mergetree#table_engine-mergetree-s3)를 참조하십시오. |
| `format`                                     | 파일의 [포맷](/ko/reference/formats)입니다.                                                                                                                                                                                                                                                  |
| `structure`                                  | table 구조입니다. 포맷은 `'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](/ko/products/cloud/guides/data-sources/accessing-s3-data-securely)를 참조하십시오.                                                                                                             |

<div id="returned_value">
  ## 반환 값
</div>

S3의 지정된 Hudi 테이블에서 지정된 클러스터의 데이터를 읽기 위한, 지정된 구조(structure)의 테이블(table)입니다.

<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 엔진](/ko/reference/engines/table-engines/integrations/hudi)
* [Hudi 테이블 함수](/ko/reference/functions/table-functions/hudi)