Движок базы данных 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.
См. также
Последнее изменение 26 сентября 2026 г.
