URL - ClickHouse Documentation

URL 数据库引擎将表名视为 URL，并将这些 URL 上的数据以表的形式提供访问。它使用 url 表函数，该函数会根据 URL 将请求分派到相应的后端，例如 file、s3、HDFS、Azure Blob 存储或 HTTP。

创建数据库

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

指定 base_url 后，相对表名将基于该 URL 解析。若未提供 base URL，则每个表名都必须是完整的 URL。

用量

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

SELECT * FROM web_data.`daily.csv`;

该数据库本身不保存任何表定义。每个表在使用时才根据其 URL 进行解析，因此其 schema 由当前数据推断得出。表名也可以使用完整的 URL，例如 web_data.s3://bucket/data/events.parquet“。

Access control

创建该 database 需要在 URL 上具备 READ 和 WRITE source 授权，无论 table_engines_require_grant 如何设置。读取 table 同样需要对解析后的 backend 具备 READ source 授权；写入则需要对应的 WRITE 授权。例如：

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

对于 base URL 为 file:// 的数据库，用户需要 READ ON FILE 特权。在 ClickHouse server 上，本地文件还会被额外限制在 user_files_path 目录内。有关版本与兼容性的详细信息，请参阅 SOURCES 特权。

参见

最后修改于 2026年9月26日