Filesystem

El motor de base de datos Filesystem expone los archivos de un directorio local como tablas de solo lectura.

El motor de base de datos Filesystem expone los archivos de un directorio local como tablas de solo lectura. El nombre de una tabla se resuelve como una ruta relativa al directorio de la base de datos y se lee mediante la función de tabla file.

​

Crear una base de datos

CREATE DATABASE files
ENGINE = Filesystem([path]);

path es el directorio que contiene los archivos. Si se omite, ClickHouse utiliza el directorio actual en clickhouse-local y el directorio user_files en el servidor de ClickHouse.

​

Uso

Por ejemplo, con data.csv en el directorio seleccionado:

CREATE DATABASE files ENGINE = Filesystem('imports');

SELECT * FROM files.`data.csv`;

El nombre de la tabla puede incluir una ruta relativa dentro del directorio de la base de datos. El esquema y el formato de la tabla se infieren de la misma manera que en la función de tabla file.

La base de datos no contiene definiciones de tabla: las tablas se crean cuando sus archivos se resuelven por primera vez y solo se almacenan en caché para accesos posteriores. No se admiten CREATE TABLE, INSERT ni otras escrituras a través de esta base de datos.

​

Control de acceso

En el servidor de ClickHouse, el directorio de la base de datos y cada archivo resuelto deben encontrarse dentro de user_files_path; esta restricción se aplica también después de seguir enlaces simbólicos. clickhouse-local no está restringido a user_files_path.

Crear esta base de datos requiere los grants de origen READ y WRITE sobre FILE, con independencia de table_engines_require_grant. Puede otorgarlos, por ejemplo, así:

GRANT READ, WRITE ON FILE TO user_name;

Consulta los privilegios SOURCES para conocer los detalles de versión y compatibilidad.

​

Véase también

• Función de tabla file
• Motor de base de datos S3
• Motor de base de datos HDFS