先决条件

对于 Cloudflare R2，其 S3 兼容性 API 允许您使用 DuckDB 的 S3 支持来读写 R2 存储桶中的数据。

这需要使用 httpfs 扩展，该扩展可以通过 INSTALL SQL 命令进行安装。此操作只需执行一次。

凭据和配置

您需要 生成 S3 身份验证令牌 并在 DuckDB 中创建一个 R2 密钥。

CREATE SECRET (
    TYPE r2,
    KEY_ID 'AKIAIOSFODNN7EXAMPLE',
    SECRET 'wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY',
    ACCOUNT_ID 'your-33-character-hexadecimal-account-ID'
);

查询

配置好 R2 凭据后，您可以使用 DuckDB 的内置方法（如 read_csv 或 read_parquet）查询 R2 中的数据。

SELECT * FROM read_parquet('r2://r2-bucket-name/file');