URL - ClickHouse Documentation

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, 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

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

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

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. Consultez les privilèges SOURCES pour les détails de version et de compatibilité.

Voir aussi

Dernière modification le 26 septembre 2026