SuperAPI AI 工具集

hyperdrive

数据与分析

查看项目

更新于 10-16 02:33

技能介绍

用途:将 Cloudflare Workers 连接到任意位置托管的现有 PostgreSQL 或 MySQL 数据库,通过连接池消除每次请求建立连接的开销,并在边缘缓存查询结果,适合读多写少、地理分布广、需要共享连接或数据库迁移的场景。

主要能力:自动管理连接池,在多次 Worker 调用间复用连接;自动缓存查询结果,仅缓存 SELECT 等读查询,写查询不缓存且对同表写入会自动失效缓存;支持 Postgres.js、node-postgres、Drizzle ORM、Prisma 以及 MySQL 通过 @planetscale/database 连接。

使用方式:先用 npx wrangler hyperdrive create <YOUR_CONFIG_NAME> --connection-string="postgres://user:password@HOSTNAME_OR_IP_ADDRESS:PORT/database_name" 创建配置并复制 ID,再在 wrangler.jsonc 中添加 hyperdrive 绑定。代码中通过 env.HYPERDRIVE.connectionString 获取连接串,例如 postgres(env.HYPERDRIVE.connectionString)。可用 npx wrangler hyperdrive list/get/update/delete 管理配置。缓存可在创建时通过 --caching-disabled 与 --max-age 配置(默认启用 60 秒 TTL)。

限制与注意:不要手动调用 sql.end() 关闭连接,连接生命周期由 Hyperdrive 管理;Prisma 需在连接串后加 ?connection_limit=1 防止连接池耗尽;本地开发可用 npx wrangler dev --remote 测试真实 Hyperdrive;需确保数据库允许来自 Cloudflare IP 的连接并妥善保存凭据。收费、价格与更多平台细节资料暂未提供。