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

> Le moteur de base de données HDFS expose les fichiers stockés dans HDFS sous forme de tables read-only.

# HDFS

Le moteur de base de données `HDFS` expose les fichiers présents dans HDFS sous forme de tables en lecture seule. Le nom d'une table est résolu via la fonction de table [`hdfs`](/fr/reference/functions/table-functions/hdfs).

## Création d'une base de données

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

`hdfs_host_and_root_path` permet, de manière facultative, de définir une URL HDFS de base. Lorsqu'elle est présente, les noms de tables sont des chemins relatifs à cette URL. Sinon, les noms de tables doivent être des URL `hdfs://` complètes.

## Usage

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

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

Le schema et le format sont inférés de la même manière que pour la fonction de table `hdfs`. La base de données ne possède aucune table definition et ne prend en charge ni les DDL de table ni les writes.

## Access control

Les URL HDFS sont vérifiées au regard du filter d'hôtes distants du server. La création de cette base de données nécessite les grants de source `READ` et `WRITE` sur `HDFS`, indépendamment de [`table_engines_require_grant`](/fr/reference/settings/server-settings/settings/other#table_engines_require_grant), par exemple :

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

Consultez les [privilèges `SOURCES`](/fr/reference/statements/grant#sources) pour plus de détails sur la version et la compatibilité.

## Voir aussi

* [Fonction de table `hdfs`](/fr/reference/functions/table-functions/hdfs)
* [Moteur de base de données Filesystem](/fr/reference/engines/database-engines/filesystem)
* [Moteur de base de données S3](/fr/reference/engines/database-engines/s3)