v0.1 云端对象存储配置 (mooncake.create_secret)

在 pg_mooncake v0.1 中使用 mooncake.create_secret 与 mooncake.default_bucket 配置 S3 与 Cloudflare R2 存储桶。

pg_mooncake v0.1 历史归档文档（Delta Lake 引擎）

本页归档的是早期 pg_mooncake v0.1 版本文档（采用直接 CREATE TABLE ... USING columnstore DDL 与 Delta Lake 存储）。从 v0.2 及 PGSTY 维护的 v0.3.0 版本起，pg_mooncake 已全面转向基于 moonlink 的实时列存镜像架构（CALL mooncake.create_table + USING mooncake）与 Apache Iceberg v2。最新文档请参阅简介与 v0.1 与 v0.2 / v0.3 架构演进对比。

当前 v0.3.0 对象存储配置方式

在 v0.2 与 v0.3.0 中，对象存储凭据通过 duckdb.secrets 表管理，不再使用 mooncake.create_secret。最新说明请参阅 Iceberg 与对象存储配置。

配置 Amazon S3 存储桶（`v0.1`）

SELECT mooncake.create_secret(
    '<name>', 'S3', '<key_id>', '<secret>',
    '{"REGION": "<s3-region>", "SCOPE": "s3://<bucket>"}'
);

针对 S3 Express 存储桶：

SELECT mooncake.create_secret(
    '<name>', 'S3', '<key_id>', '<secret>',
    '{"ENDPOINT": "s3express-use1-az6.us-east-1.amazonaws.com", "REGION": "us-east-1"}'
);

配置 Cloudflare R2 存储桶（`v0.1`）

SELECT mooncake.create_secret(
    '<name>', 'S3', '<key_id>', '<secret>',
    '{"ENDPOINT": "<ACCOUNT_ID>.r2.cloudflarestorage.com"}'
);

设置默认存储桶

ALTER DATABASE <database> SET mooncake.default_bucket = 's3://<bucket>';
SHOW mooncake.default_bucket;

S3 与 R2 参数说明

参数名	说明	是否必填
`name`	凭据名称	是
`key_id`	S3 / R2 Access Key ID	是
`secret`	S3 / R2 Secret Access Key	是
`REGION`	S3 存储桶所在区域	是
`ENDPOINT`	R2 或 S3 Express 自定义端点	是（R2 / S3 Express）
`SCOPE`	凭据生效的存储桶路径前缀（如 `s3://mybucket`）	否

v0.1 云端对象存储配置 (mooncake.create_secret)

配置 Amazon S3 存储桶（v0.1）

配置 Cloudflare R2 存储桶（v0.1）

设置默认存储桶

S3 与 R2 参数说明

配置 Amazon S3 存储桶（`v0.1`）

配置 Cloudflare R2 存储桶（`v0.1`）