> ## 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.

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

# Filesystem

`Filesystem` 데이터베이스 엔진은 로컬 디렉터리의 파일을 읽기 전용 테이블로 노출합니다. 테이블 이름은 데이터베이스 디렉터리를 기준으로 한 상대 경로로 해석되며, [`file`](/ko/reference/functions/table-functions/file) 테이블 함수를 통해 읽습니다.

## 데이터베이스 생성

```sql theme={null}
CREATE DATABASE files
ENGINE = Filesystem([path]);
```

`path`는 파일이 들어 있는 디렉터리입니다. 생략하면 ClickHouse는 `clickhouse-local`에서는 현재 디렉터리를, ClickHouse 서버에서는 `user_files` 디렉터리를 사용합니다.

## 사용법

예를 들어 선택한 디렉터리에 `data.csv`가 있는 경우:

```sql theme={null}
CREATE DATABASE files ENGINE = Filesystem('imports');

SELECT * FROM files.`data.csv`;
```

테이블 이름에는 데이터베이스 디렉터리 아래의 상대 경로를 포함할 수 있습니다. 테이블 스키마와 포맷은 `file` 테이블 함수와 동일한 방식으로 추론됩니다.

이 데이터베이스는 테이블 정의를 보유하지 않습니다. 테이블은 해당 파일이 처음 해석될 때 생성되며, 이후 액세스를 위해 캐시되기만 합니다. 이 데이터베이스를 통한 `CREATE TABLE`, `INSERT` 및 기타 쓰기 작업은 지원되지 않습니다.

## 액세스 제어

ClickHouse 서버에서는 데이터베이스 디렉터리와 해석된 모든 파일이 [`user_files_path`](/ko/reference/settings/server-settings/settings#user_files_path) 내부에 있어야 하며, 이 제한은 심볼릭 링크를 따라간 이후에도 적용됩니다. `clickhouse-local`은 `user_files_path`의 제한을 받지 않습니다.

이 데이터베이스를 생성하려면 [`table_engines_require_grant`](/ko/reference/settings/server-settings/settings/other#table_engines_require_grant) 설정과 관계없이 `FILE`에 대한 `READ` 및 `WRITE` source 권한이 필요합니다. 예를 들어 다음과 같이 권한을 부여합니다:

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

버전 및 호환성에 대한 자세한 내용은 [`SOURCES` 권한](/ko/reference/statements/grant#sources)을 참고하십시오.

## 관련 항목

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