调整连接池

Hyperdrive 维护可在 Worker 调用间共享的数据库连接池。可根据数据库容量和应用需求配置这些连接的最大数量。

配置连接池大小

可通过 Cloudflare 仪表板、Wrangler CLI 或 Cloudflare API 配置连接池大小。

通过仪表板配置连接池大小：

登录 Cloudflare 仪表板 ↗ 并选择账户。
前往 Storage & databases（存储和数据库） > Hyperdrive。
Go to Hyperdrive ↗
选择 Hyperdrive 配置。
选择 Settings（设置）。
在 Origin connection limit（源站连接限制） 部分，调整 Maximum connections 值。
选择 Save（保存）。

使用 wrangler hyperdrive update 命令及 --origin-connection-limit 标志：

npx wrangler hyperdrive update <HYPERDRIVE_ID> --origin-connection-limit=<MAX_CONNECTIONS>

使用 Hyperdrive REST API 更新配置：

curl --request PATCH \
  --url https://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/hyperdrive/configs/<HYPERDRIVE_ID> \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <API_TOKEN>' \
  --data '{
    "origin_connection_limit": <MAX_CONNECTIONS>
  }'

所有 Hyperdrive 配置最少 5 个连接。最大连接数取决于 Workers 套餐。

最佳实践

保守起步：从较低连接数开始，根据应用性能逐步增加。
监控数据库指标：关注数据库连接使用和性能指标以优化连接数。
考虑数据库限制：确保配置的连接数不超过数据库最大连接限制。
考虑多配置：若有多个 Hyperdrive 配置连接同一数据库，需考虑所有配置的总连接数。

调整连接池

配置连接池大小

最佳实践

相关资源