HDFS - ClickHouse Documentation

HDFS 데이터베이스 엔진은 HDFS에 있는 파일을 읽기 전용 테이블로 노출합니다. 테이블 이름은 hdfs 테이블 함수를 통해 해석됩니다.

데이터베이스 생성

CREATE DATABASE hdfs_data
ENGINE = HDFS([hdfs_host_and_root_path]);

hdfs_host_and_root_path는 기본 HDFS URL을 설정하는 선택적 항목입니다. 이 값이 지정되면 테이블 이름은 해당 URL을 기준으로 하는 상대 경로가 됩니다. 지정하지 않으면 테이블 이름은 전체 hdfs:// URL이어야 합니다.

Usage

CREATE DATABASE hdfs_data
ENGINE = HDFS('hdfs://namenode:9000/data');

SELECT * FROM hdfs_data.`events.parquet`;

스키마와 포맷은 hdfs 테이블 함수와 동일한 방식으로 추론됩니다. 이 데이터베이스는 테이블 정의를 보유하지 않으며, 테이블 DDL이나 쓰기 작업을 지원하지 않습니다.

액세스 제어

HDFS URL은 서버의 remote-host filter를 기준으로 검사됩니다. 이 데이터베이스를 생성하려면 table_engines_require_grant 설정과 무관하게 HDFS에 대한 READ 및 WRITE source 권한 부여가 필요합니다. 예시:

GRANT READ, WRITE ON HDFS TO user_name;

버전 및 호환성 세부 정보는 SOURCES 권한을 참조하십시오.

관련 항목

마지막 수정일 2026년 9월 26일