Filesystem предоставляет файлы из локального каталога в виде таблиц, доступных только для чтения. Имя таблицы разрешается как путь относительно каталога базы данных, а чтение выполняется с помощью табличной функции file.
Создание базы данных
path — каталог, в котором находятся файлы. Если он не указан, ClickHouse использует текущий каталог в clickhouse-local и каталог user_files на сервере ClickHouse.
Использование
Например, при наличии файлаdata.csv в выбранном каталоге:
file.
База данных не хранит определений таблиц: таблицы создаются при первом разрешении их файлов и лишь кэшируются для последующих обращений. CREATE TABLE, INSERT и другие операции записи через эту базу данных не поддерживаются.
Управление доступом
На сервере ClickHouse каталог базы данных и каждый разрешаемый файл должны находиться внутриuser_files_path; это ограничение действует и после перехода по символическим ссылкам. На clickhouse-local ограничение user_files_path не распространяется.
Для создания такой базы данных требуются привилегии source READ и WRITE на FILE, независимо от table_engines_require_grant. Выдать их можно, например, так:
SOURCES.