메인 콘텐츠로 건너뛰기
Amazon S3의 Apache Hudi 테이블에 테이블처럼 사용할 수 있는 읽기 전용 인터페이스를 제공합니다.

​
구문

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

​
인수

ArgumentDescription
urlS3에 있는 기존 Hudi 테이블의 경로를 포함한 버킷 URL입니다.
aws_access_key_id, aws_secret_access_keyAWS 계정 사용자의 장기 자격 증명입니다. 요청을 인증하는 데 사용할 수 있습니다. 이 매개변수는 선택 사항입니다. 자격 증명을 지정하지 않으면 ClickHouse 구성에 설정된 자격 증명을 사용합니다. 자세한 내용은 S3를 사용한 데이터 저장을 참조하십시오.
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일