次の制限は、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 form ↗ を送信します。質問は Cloudflare の Discord コミュニティ ↗ の Hyperdrive チャネルでもできます。