用途:Cloudflare Hyperdrive 用于把 Cloudflare Workers 连接到已有的 PostgreSQL(v9.0-17.x)或 MySQL(v5.7-8.x)数据库,通过边缘连接、靠近数据库的连接池与查询缓存来降低延迟。
主要能力:全球连接池、自动查询缓存(SELECT 等非变更查询缓存,INSERT/UPDATE/DELETE 与易变函数不缓存)、TLS/SSL 支持、Cloudflare Tunnel 访问私有网络数据库、指标分析(查询数、缓存命中率、延迟分位、错误率)。数据库需公网可访问且启用 TLS/SSL。
使用方式:执行 npx wrangler hyperdrive create my-postgres-db --connection-string="postgres://user:password@host:5432/database" 创建配置,在 wrangler.jsonc 中配置 hyperdrive 绑定(binding 通常为 HYPERDRIVE),compatibility_flags 需含 nodejs_compat,安装驱动(pg、postgres 或 mysql2),在 Worker 中通过 env.HYPERDRIVE.connectionString 连接,清理连接用 ctx.waitUntil(client.end()) 而非 await client.end()。部署用 npx wrangler deploy。本地开发可用环境变量 CLOUDFLARE_HYPERDRIVE_LOCAL_CONNECTION_STRING_HYPERDRIVE 或 wrangler dev。
适用场景:连接现有数据库、设置连接池、在边缘查询关系型数据库。
限制:连接池 max 建议 5(Workers 限制为 6),不支持 SQL Server、MongoDB、Oracle;PostgreSQL 不支持 SQL 级 prepared statements、advisory locks、LISTEN/NOTIFY 及会话状态修改;MySQL 不支持 USE、多语句查询、协议级 prepared statements、非 UTF8 查询及特定认证插件。需避免长事务;配置上限为付费 25 个、免费 10 个。具体价格与更多限制暂未提供。