Skip to main content
Filesystem データベースエンジンは、ローカルディレクトリ内のファイルを読み取り専用のテーブルとして公開します。テーブル名はデータベースディレクトリからの相対パスとして解決され、file テーブル関数を使用して読み取られます。

データベースの作成

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

使用方法

例えば、選択したディレクトリに data.csv がある場合:
テーブル名には、データベースディレクトリ配下の相対パスを含めることができます。テーブルスキーマとフォーマットは、file テーブル関数と同じ方法で推論されます。 このデータベースはテーブル定義を保持しません。テーブルは対応するファイルが最初に解決された時点で作成され、以降のアクセス用にキャッシュされるだけです。このデータベースを通じた CREATE TABLE、INSERT、およびその他の書き込みはサポートされていません。

アクセス制御

ClickHouse server では、データベースディレクトリおよび解決されたすべてのファイルは user_files_path 配下になければなりません。この制限は、シンボリックリンクをたどった後にも適用されます。なお、clickhouse-local は user_files_path による制限を受けません。 このデータベースを作成するには、table_engines_require_grant の設定にかかわらず、FILE に対する READ および WRITE のソース権限が必要です。たとえば、次のように付与します。
バージョンおよび互換性の詳細については、SOURCES 権限を参照してください。

関連項目

最終更新日 2026年9月26日