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

> HDFS 데이터베이스 엔진은 HDFS의 파일을 읽기 전용 테이블로 노출합니다.

# HDFS

`HDFS` 데이터베이스 엔진은 HDFS에 있는 파일을 읽기 전용 테이블로 노출합니다. 테이블 이름은 [`hdfs`](/ko/reference/functions/table-functions/hdfs) 테이블 함수를 통해 해석됩니다.

## 데이터베이스 생성

```sql theme={null}
CREATE DATABASE hdfs_data
ENGINE = HDFS([hdfs_host_and_root_path]);
```

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

## Usage

```sql theme={null}
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`](/ko/reference/settings/server-settings/settings/other#table_engines_require_grant) 설정과 무관하게 `HDFS`에 대한 `READ` 및 `WRITE` source 권한 부여가 필요합니다. 예시:

```sql theme={null}
GRANT READ, WRITE ON HDFS TO user_name;
```

버전 및 호환성 세부 정보는 [`SOURCES` 권한](/ko/reference/statements/grant#sources)을 참조하십시오.

## 관련 항목

* [`hdfs` 테이블 함수](/ko/reference/functions/table-functions/hdfs)
* [Filesystem 데이터베이스 엔진](/ko/reference/engines/database-engines/filesystem)
* [S3 데이터베이스 엔진](/ko/reference/engines/database-engines/s3)