以下限制适用于 Hyperdrive 配置、连接以及发往已配置源数据库的查询。
这些限制适用于创建或更新 Hyperdrive 配置时。
| 限制 | Free | Paid |
|---|---|---|
| 最大配置数据库数 | 每账户 10 个 | 每账户 25 个 |
| 最大用户名长度 1 | 63 字符（字节） | 63 字符（字节） |
| 最大数据库名长度 1 | 63 字符（字节） | 63 字符（字节） |
这些限制适用于 Hyperdrive 与源数据库之间的连接。
| 限制 | Free | Paid |
|---|---|---|
| 初始连接超时 | 15 秒 | 15 秒 |
| 空闲连接超时 | 10 分钟 | 10 分钟 |
| 最大源数据库连接数（每配置）2 | 约 20 个连接 | 约 100 个连接 |
Hyperdrive 不限制 Workers 的并发客户端连接数。但 Hyperdrive 会限制到源数据库的连接，因为大多数托管数据库有连接限制。
Hyperdrive 无法从源数据库获取连接时，可能看到以下错误之一：
| 错误消息 | 原因 |
|---|---|
Failed to acquire a connection from the pool. |
连接池耗尽，因连接保持打开时间过长。长时间运行的查询或事务是常见原因。 |
Server connection attempt failed: connection_refused |
源数据库拒绝连接。可能因防火墙阻止 Hyperdrive，或超过数据库提供商的连接限制。 |
完整错误代码列表请参阅 故障排除与调试。
这些限制适用于通过 Hyperdrive 发送的查询。
| 限制 | Free | Paid |
|---|---|---|
| 最大查询（语句）持续时间 | 60 秒 | 60 秒 |
| 最大缓存查询响应大小 | 50 MB | 50 MB |
超过最大持续时间的查询会被终止。大于 50 MB 的查询响应不会被缓存，但仍会返回 Worker。
若限制与项目目标冲突，可联系 Cloudflare 申请调整。并非所有限制都可提高。
提交 Limit Increase Request 表单 ↗ 申请提高。也可在 Cloudflare Discord 社区 ↗ 的 Hyperdrive 频道提问。