先决条件

对于 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 的内置方法查询 R2 数据，例如 read_csv 或 read_parquet

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