> ## 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 URL expose des données adressées par URL sous forme de tables.

# URL

Le moteur de base de données `URL` traite les noms de tables comme des URL et expose les données situées à ces URL sous forme de tables. Il s'appuie sur la fonction de table [`url`](/fr/reference/functions/table-functions/url), qui route chaque URL vers le backend approprié, tel que `file`, `s3`, HDFS, Azure Blob Storage ou HTTP.

## Créer une base de données

```sql theme={null}
CREATE DATABASE web_data
ENGINE = URL([base_url]);
```

Lorsque `base_url` est spécifié, les noms de tables relatifs sont résolus par rapport à celui-ci. Sans base URL, chaque nom de table doit être une URL complète.

## Usage

```sql theme={null}
CREATE DATABASE web_data
ENGINE = URL('https://example.com/data/');

SELECT * FROM web_data.`daily.csv`;
```

La base de données ne contient aucune table definition. Chaque table est résolue depuis son URL lors de son utilisation, son schema étant donc inféré à partir des données actuelles. Les noms de table peuvent également prendre la forme d'une URL complète, par exemple `web_data.`s3://bucket/data/events.parquet\`\`.

## Access control

La création de cette base de données nécessite les grants de source `READ` et `WRITE` sur `URL`, indépendamment de [`table_engines_require_grant`](/fr/reference/settings/server-settings/settings/other#table_engines_require_grant). La lecture d'une table exige également un grant de source `READ` pour le backend résolu ; l'écriture exige le grant `WRITE` correspondant. Par exemple :

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

Pour une base de données dont la base URL est `file://`, un utilisateur doit disposer du privilège `READ ON FILE`. Sur le serveur ClickHouse, les fichiers locaux sont en outre restreints à [`user_files_path`](/fr/reference/settings/server-settings/settings#user_files_path).

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

## Voir aussi

* [Fonction de table `url`](/fr/reference/functions/table-functions/url)
* [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)