S3 - ClickHouse Documentation

S3 数据库引擎将亚马逊 S3 及兼容 S3 的对象存储中的对象以只读表的形式呈现。表名会通过 s3 表函数解析为对象 URL。

创建数据库

CREATE DATABASE s3_data
ENGINE = S3([url[, NOSIGN | access_key_id, secret_access_key]]);

该 engine 也可以接受一个 named collection。支持的配置 keys 有 url、access_key_id、secret_access_key、no_sign_request 和 use_environment_credentials。

指定 base URL 后，表名即为相对于该 URL 的对象路径：

CREATE DATABASE s3_data
ENGINE = S3('https://bucket.s3.amazonaws.com/data/', 'NOSIGN');

SELECT * FROM s3_data.`events.parquet`;

若未设置 base URL，请使用完整的对象 URL 作为表名。schema 和 format 的推断方式与 s3 表函数相同。该数据库本身不持有任何表定义，也不支持表的 DDL 或写入操作。

S3 URL 会经由服务器的远程主机过滤器进行校验。无论 table_engines_require_grant 如何设置，创建该数据库都需要在 S3 上具备 READ 和 WRITE 的 source 授权，例如：

GRANT READ, WRITE ON S3 TO user_name;

有关版本和兼容性详情，请参阅 SOURCES 特权。