> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-parallel-read-in-order-multi-part.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/) 테이블에 테이블처럼 사용할 수 있는 읽기 전용 인터페이스를 제공합니다.

## 구문

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

## 인수

| Argument | Description |
| - | - |
| `url` | S3에 있는 기존 Hudi 테이블의 경로를 포함한 버킷 URL입니다. |
| `aws_access_key_id`, `aws_secret_access_key` | [AWS](https://aws.amazon.com/) 계정 사용자의 장기 자격 증명입니다. 요청을 인증하는 데 사용할 수 있습니다. 이 매개변수는 선택 사항입니다. 자격 증명을 지정하지 않으면 ClickHouse 구성에 설정된 자격 증명을 사용합니다. 자세한 내용은 [S3를 사용한 데이터 저장](/ko/reference/engines/table-engines/mergetree-family/mergetree#table_engine-mergetree-s3)을 참조하십시오. |
| `format` | 파일의 [포맷](/ko/reference/formats/index)입니다. |
| `structure` | 테이블의 구조입니다. 포맷은 `'column1_name column1_type, column2_name column2_type, ...'`입니다. |
| `compression` | 이 매개변수는 선택 사항입니다. 지원되는 값은 `none`, `gzip/gz`, `deflate`, `brotli/br`, `xz/LZMA`, `zstd/zst`, `lz4`, `bz2`, `snappy`입니다. 기본적으로는 파일 확장자를 기준으로 압축을 자동 감지합니다. `snappy`의 경우 wire 형식은 [snappy\_mode](/ko/reference/settings/session-settings/other#snappy_mode) 설정으로 선택됩니다(기본값은 `basic`). |
| `extra_credentials` | 이 매개변수는 선택 사항입니다. ClickHouse Cloud에서 역할 기반 접근을 위해 `role_arn`을 전달하는 데 사용됩니다. 구성 단계는 [Secure S3](/ko/products/cloud/guides/data-sources/accessing-s3-data-securely)를 참조하십시오. |

## 반환 값

S3에 있는 지정된 Hudi 테이블에서 데이터를 읽기 위한, 지정된 구조의 테이블입니다.

## 가상 컬럼

* `_path` — 파일 경로입니다. 유형: `LowCardinality(String)`.
* `_file` — 파일 이름입니다. 유형: `LowCardinality(String)`.
* `_size` — 파일 크기(바이트)입니다. 유형: `Nullable(UInt64)`. 파일 크기를 알 수 없으면 값은 `NULL`입니다.
* `_time` — 파일의 마지막 수정 시간입니다. 유형: `Nullable(DateTime)`. 시간을 알 수 없으면 값은 `NULL`입니다.
* `_etag` — 파일의 etag 값입니다. 유형: `LowCardinality(String)`. etag를 알 수 없으면 값은 `NULL`입니다.

## 관련

* [Hudi 엔진](/ko/reference/engines/table-engines/integrations/hudi)
* [Hudi 클러스터 테이블 함수](/ko/reference/functions/table-functions/hudiCluster)