Le moteur de base de données Filesystem expose les fichiers d’un répertoire local sous forme de tables en read-only. Le nom d’une table est résolu comme un path relatif au répertoire de la base de données, et la table est lue à l’aide de la fonction de table file.
Création d’une base de données
path est le répertoire qui contient les fichiers. S’il est omis, ClickHouse utilise le répertoire courant dans clickhouse-local et le répertoire user_files sur le serveur ClickHouse.
Utilisation
Par exemple, avec data.csv dans le répertoire sélectionné :
Le nom de la table peut inclure un chemin relatif sous le répertoire de la base de données. Le schéma et le format de la table sont inférés de la même manière que pour la fonction de table file.
La base de données ne contient aucune définition de table : les tables sont créées lors de la première résolution de leurs fichiers, puis simplement mises en cache pour les accès ultérieurs. Les instructions CREATE TABLE, INSERT et les autres écritures via cette base de données ne sont pas prises en charge.
Contrôle d’accès
Sur le serveur ClickHouse, le répertoire de la base de données ainsi que chaque fichier résolu doivent se trouver dans user_files_path ; cette restriction s’applique également une fois les liens symboliques suivis. clickhouse-local, en revanche, n’est pas limité à user_files_path.
La création de cette base de données requiert les grants de source READ et WRITE sur FILE, indépendamment de table_engines_require_grant. Accordez-les par exemple ainsi :
Consultez les privilèges SOURCES pour plus de détails sur les versions et la compatibilité.
Voir aussi
Dernière modification le 26 septembre 2026
