> ## 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`](/ja/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 である必要があります。

## 使用状況

```sql theme={null}
CREATE DATABASE hdfs_data
ENGINE = HDFS('hdfs://namenode:9000/data');

SELECT * FROM hdfs_data.`events.parquet`;
```

スキーマとフォーマットは、`hdfs` テーブル関数と同じ方法で推論されます。このデータベースはテーブル定義を保持せず、テーブルの DDL や書き込みもサポートしません。

## アクセス制御

HDFS の URL は、サーバーのリモートホストフィルターによって検証されます。このデータベースを作成するには、[`table_engines_require_grant`](/ja/reference/settings/server-settings/settings/other#table_engines_require_grant) の設定にかかわらず、`HDFS` に対する `READ` および `WRITE` のソース権限が必要です。例:

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

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

## 関連項目

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