HDFS - ClickHouse Documentation

O motor de banco de dados HDFS expõe arquivos no HDFS como tabelas read-only. O nome de uma tabela é resolvido por meio da função de tabela hdfs.

Criando um banco de dados

CREATE DATABASE hdfs_data
ENGINE = HDFS([hdfs_host_and_root_path]);

hdfs_host_and_root_path define opcionalmente uma URL HDFS base. Quando presente, os nomes das tabelas são caminhos relativos a essa URL. Sem ela, os nomes das tabelas devem ser URLs hdfs:// completas.

Usage

CREATE DATABASE hdfs_data
ENGINE = HDFS('hdfs://namenode:9000/data');

SELECT * FROM hdfs_data.`events.parquet`;

O schema e o format são inferidos da mesma forma que na função de tabela hdfs. O banco de dados não possui nenhuma definição de tabela e não oferece suporte a DDL de tabela nem a gravações.

Access control

As URLs de HDFS são validadas pelo filtro de hosts remotos do servidor. A criação desse banco de dados exige os grants de source READ e WRITE em HDFS, independentemente de table_engines_require_grant, por exemplo:

GRANT READ, WRITE ON HDFS TO user_name;

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

Veja também

Última modificação em 26 de setembro de 2026