URL - ClickHouse Documentation

O motor de banco de dados URL trata nomes de tabelas como URLs e expõe os dados dessas URLs como tabelas. Ele utiliza a função de tabela url, que encaminha cada URL ao backend apropriado, como file, s3, HDFS, Azure Blob Storage ou HTTP.

Criando um banco de dados

CREATE DATABASE web_data
ENGINE = URL([base_url]);

Quando base_url é especificado, os nomes de tabela relativos são resolvidos em relação a ele. Sem uma base URL, todo nome de tabela deve ser uma URL completa.

Usage

CREATE DATABASE web_data
ENGINE = URL('https://example.com/data/');

SELECT * FROM web_data.`daily.csv`;

O banco de dados não contém definições de tabelas. Cada tabela é resolvida a partir de sua URL no momento do uso, de modo que seu schema é inferido dos dados atuais. Os nomes de tabelas também podem usar uma URL completa, por exemplo web_data.s3://bucket/data/events.parquet“.

Access control

Criar esse banco de dados exige grants de source READ e WRITE em URL, independentemente de table_engines_require_grant. Ler uma tabela também exige um grant de source READ para o backend resolvido; a gravação exige o grant WRITE correspondente. Por exemplo:

GRANT READ, WRITE ON URL TO user_name;
GRANT READ, WRITE ON S3 TO user_name;

Para um banco de dados com base URL file://, o usuário precisa do privilégio READ ON FILE. No servidor ClickHouse, os arquivos locais também ficam restritos ao user_files_path. 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