接続プールを調整する

Hyperdrive は、Worker の呼び出し間で共有するデータベースへの接続プールを維持します。データベースの容量とアプリケーションの要件に合わせて、これらの接続の上限数を設定できます。

接続プールのサイズは、Cloudflare dashboard、Wrangler CLI、または Cloudflare API で設定できます。

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

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 設定が接続している場合は、すべての設定を合計した接続数を考慮します。

• コネクションプーリングの概念
• 接続のライフサイクル
• メトリクスと分析
• Hyperdrive の制限
• クエリキャッシュ