> ## 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`](/ja/reference/functions/table-functions/file) テーブル関数を使用して読み取られます。

## データベースの作成

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

`path` はファイルが格納されているディレクトリです。省略した場合、ClickHouse は `clickhouse-local` では現在のディレクトリを、ClickHouse server では `user_files` ディレクトリを使用します。

## 使用方法

例えば、選択したディレクトリに `data.csv` がある場合:

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

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

テーブル名には、データベースディレクトリ配下の相対パスを含めることができます。テーブルスキーマとフォーマットは、`file` テーブル関数と同じ方法で推論されます。

このデータベースはテーブル定義を保持しません。テーブルは対応するファイルが最初に解決された時点で作成され、以降のアクセス用にキャッシュされるだけです。このデータベースを通じた `CREATE TABLE`、`INSERT`、およびその他の書き込みはサポートされていません。

## アクセス制御

ClickHouse server では、データベースディレクトリおよび解決されたすべてのファイルは [`user_files_path`](/ja/reference/settings/server-settings/settings#user_files_path) 配下になければなりません。この制限は、シンボリックリンクをたどった後にも適用されます。なお、`clickhouse-local` は `user_files_path` による制限を受けません。

このデータベースを作成するには、[`table_engines_require_grant`](/ja/reference/settings/server-settings/settings/other#table_engines_require_grant) の設定にかかわらず、`FILE` に対する `READ` および `WRITE` のソース権限が必要です。たとえば、次のように付与します。

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

バージョンおよび互換性の詳細については、[`SOURCES` 権限](/ja/reference/statements/grant#sources)を参照してください。

## 関連項目

* [`file` テーブル関数](/ja/reference/functions/table-functions/file)
* [S3 データベースエンジン](/ja/reference/engines/database-engines/s3)
* [HDFS データベースエンジン](/ja/reference/engines/database-engines/hdfs)