URL - ClickHouse Documentation

El motor de base de datos URL trata los nombres de tabla como URL y expone los datos de esas URL como tablas. Utiliza la función de tabla url, que dirige cada URL al backend correspondiente, como file, s3, HDFS, Azure Blob Storage o HTTP.

Creación de una base de datos

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

Cuando se especifica base_url, los nombres de tabla relativos se resuelven con respecto a esta. Sin una base URL, cada nombre de tabla debe ser una URL completa.

Uso

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

SELECT * FROM web_data.`daily.csv`;

La base de datos no contiene definiciones de tablas. Cada tabla se resuelve a partir de su URL en el momento de usarla, por lo que su esquema se infiere de los datos actuales. Los nombres de las tablas también pueden usar una URL completa, por ejemplo web_data.s3://bucket/data/events.parquet“.

Control de acceso

La creación de esta base de datos requiere los grants de source READ y WRITE sobre URL, independientemente de table_engines_require_grant. La lectura de una tabla también requiere un grant de source READ para el backend resuelto; la escritura requiere el grant WRITE correspondiente. Por ejemplo:

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

Para una base de datos con una base URL file://, el usuario necesita READ ON FILE. En el ClickHouse server, los archivos locales están además restringidos a user_files_path. Consulte los privilegios SOURCES para conocer los detalles de versión y compatibility.

Véase también

Última modificación el 26 de septiembre de 2026