Filesystem

O motor de banco de dados Filesystem expõe arquivos de um diretório local como tabelas read-only.

O motor de banco de dados Filesystem expõe arquivos de um diretório local como tabelas read-only. O nome da tabela é resolvido como um path relativo ao diretório do banco de dados e é lido por meio da função de tabela file.

​

Criando um banco de dados

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

path é o diretório que contém os arquivos. Se for omitido, o ClickHouse usa o diretório atual no clickhouse-local e o diretório user_files no servidor ClickHouse.

​

Uso

Por exemplo, com data.csv no diretório selecionado:

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

SELECT * FROM files.`data.csv`;

O nome da tabela pode incluir um caminho relativo dentro do diretório do banco de dados. O schema e o formato da tabela são inferidos da mesma maneira que na função de tabela file.

O banco de dados não mantém definições de tabela: as tabelas são criadas quando seus arquivos são resolvidos pela primeira vez e ficam apenas em cache para acessos subsequentes. CREATE TABLE, INSERT e outras gravações por meio deste banco de dados não são suportados.

​

Controle de acesso

No servidor ClickHouse, o diretório do banco de dados e todos os arquivos resolvidos devem estar dentro de user_files_path; essa restrição também se aplica após o acompanhamento de links simbólicos. O clickhouse-local não está restrito a user_files_path.

A criação desse banco de dados exige os grants de source READ e WRITE em FILE, independentemente de table_engines_require_grant. Você pode concedê-los, por exemplo, assim:

GRANT READ, WRITE ON FILE TO user_name;

Consulte os privilégios SOURCES para obter detalhes sobre versão e compatibilidade.

​

Veja também

• Função de tabela file
• Motor de banco de dados S3
• Motor de banco de dados HDFS