・PostgreSQLをWorkersから使いたい
・Workersから遠くのDBにつなぐと遅い
・D1とHyperdriveのどちらか迷っている
Cloudflare Hyperdrive は、今ある PostgreSQL・MySQL へのクエリを、Workers から速くするサービスです。データは今のデータベースに置いたまま、使っているドライバの接続先を替えるだけで使え、無料プランでも利用できます。
この記事では、速くなる仕組み、つなげるデータベース、料金と無料枠、D1 との使い分け、始め方、注意点を扱います。内容は Hyperdrive の公式ドキュメントの範囲に限り、料金と上限は2026年11月時点の値です。Workers 自体の説明と D1 の料金は扱いません。
この記事のゴール(読了目安 約8分)
Hyperdriveの仕組みと無料枠を知り、今あるDBをWorkersから使い始められるようになる
Hyperdriveとは:今あるDBを速く使う
Hyperdrive は新しいデータベースではなく、今のデータベースへのつなぎ方を速くするサービスです。
Workers(Cloudflare の各拠点でコードを動かすサービス)は利用者の近くで動きますが、データベースはふつう1つの地域にあります。Hyperdrive はこの間に入り、遠いデータベースとのやり取りを速くします。
- データは今のデータベースに置いたまま。書き込みもそこへ届き、Hyperdrive が覚えるのは読み取りの結果だけ
- ドライバ(データベースにつなぐ部品)や ORM(SQL を直接書かずに扱う道具)は今のまま使える
- Hyperdrive が渡す接続文字列は、その Worker からしか使えない
2024年4月に一般提供となり、2025年4月から無料プランでも使えます。MySQL は2026年8月に一般提供、同年9月には Python の Workers にも対応しました。
仕組み:遠いDBでも速くなる3つの理由
遅くなる原因は、接続を作るまでのやり取りの多さです。Hyperdrive はそれを3つの方法で減らします。
ふつうは、クエリを送る前に7往復(送って返事が戻るまでのやり取り)が要ります。TCP の接続で1回、TLS(通信の暗号化)の交渉で3回、データベースの認証で3回です。Workers は呼び出しのたびに接続を作るので、この往復が毎回かかります。データベースの同時接続数にも上限があり、世界中からの接続で使い切りやすくなります。
認証まで Worker の近くで終えるので、データベースまでの地域をまたぐ往復は1回で済みます。接続プールは開いた接続を使い回す仕組みで、Worker がいくつ動いてもデータベースへの接続をまとめます。読み取りの結果は既定で60秒(最大1時間)キャッシュされ、同じクエリにはデータベースへ行かずに答えます。 利用者の近くに結果を覚えておく点は、Cloudflare CDN と同じ考え方です。

つなげるデータベースと使える道具
PostgreSQL・MySQL と、その互換のデータベースならつなげます。
2026年11月時点の対応は PostgreSQL 9.0〜18.x と MySQL 5.7〜8.x(MariaDB を含む)です。自前のサーバーでも、AWS・Azure・Google Cloud などのマネージドでも使えます。互換の例には Neon・Supabase・PlanetScale などがあり、SQL Server と MongoDB は対象外です。ドライバは pg(推奨)や mysql2 で、ORM やクエリビルダーの Drizzle・Kysely も使えます。
公開していないデータベースには、Workers VPC を通す方法が公式の推奨です。 Workers VPC(非公開のネットワークへつなぐ仕組み)は2026年4月から Hyperdrive で使え、ベータの間は無料です。Cloudflare Tunnel(社内から Cloudflare への通り道)と Access を使う方法もあります。
料金と無料プランの上限
Hyperdrive は Workers のプランに含まれ、数えるのはクエリの数です。2026年11月時点の公式の料金ページと上限の一覧では、次のとおりです。
※有料の数は、公式の上限の一覧で確かめてください。
キャッシュから返した読み取りも、1回のクエリと数えます。 SELECT も INSERT も CREATE も、それぞれ1回です。キャッシュは応答を速くする仕組みで、無料枠の節約にはなりません。

無料プランで上限を超えると、00:00 UTC(日本時間の午前9時)のリセットまで、その種類の操作がエラーになります。Workers の有料プランは月5ドルからで、加入すると上限は自動で切り替わります。Hyperdrive 自体は CPU 時間に課金せず、Worker 側の処理は Workers の料金で数えます。Workers の料金と無料枠は、Cloudflare Workers の記事で解説しています。
D1・Durable Objectsとの使い分け
公式は、Workers で使える SQL の選択肢を3つ挙げています。分かれ目は、今使っているデータベースがあるかどうかです。
新しく作るなら D1、今ある PostgreSQL・MySQL を使い続けるなら Hyperdrive が基本の分け方です。
Hyperdrive を D1 に使うことはできません。D1 は最初から Workers から速くつながる作りで、接続のための往復が要らないためです。D1 の料金や上限はCloudflare D1とは、ユーザーごとに状態をそろえる仕組みはDurable Objectsとはで解説しています。公式は、セッションのデータは Workers KV、大きなファイルは R2、ホスティングされた PostgreSQL・MySQL は Hyperdrive という組み合わせも例に挙げています。

始め方:設定を作ってWorkerから読む
公式の Get started に沿い、Wrangler(Workers を操作する公式のコマンドラインツール)で PostgreSQL につなぐ流れです。ダッシュボードからも作れます。
- ログインし、Worker のひな形を作る
- 接続文字列(ユーザー名・パスワード・ホストなどを1行にしたもの)を用意する
wrangler hyperdrive createで設定を作る- 出力された
idを、設定ファイルのhyperdriveに書く pgを入れ、env.HYPERDRIVE.connectionStringでクエリして公開する
npx wrangler login
npm create cloudflare@latest -- hyperdrive-tutorial
cd hyperdrive-tutorial
npx wrangler hyperdrive create my-database --connection-string="postgres://user:password@HOSTNAME_OR_IP_ADDRESS:PORT/database_name"
npm i pg
npx wrangler deploy
my-database は好きな名前にします。互換日付が 2026-08-04 以降なら、ドライバに要る Node.js 互換は最初から有効です。MySQL なら mysql2 に disableEval: true を付けます。
設定を作る前に、データベースのファイアウォールで Cloudflare の IP 範囲を許可しておきます。
- 作成時に Hyperdrive が実際に接続を試し、つながらなければエラーになる
- 手元の
wrangler devはデータベースに直接つなぐので、プールもキャッシュも使われない。両方まで試すなら--remoteを付ける
使う前の注意点:キャッシュと未対応の機能
困りやすいのは、キャッシュの古さと使えない SQL の2つです。
書き込んでも、キャッシュ済みの読み取り結果は消えません。 既定では最大60秒(さらに猶予の15秒)古い結果が返りえます。新しさが要る読み取りは、キャッシュを切った2つ目の設定(--caching-disabled)を別のバインディングで使うのが公式の勧めです。この設定でも接続プールは使えます。
設定を2つにするときは、接続数の合計に気を付けます。NOW() などを含む読み取りは、2026年2月からキャッシュされなくなりました。時刻は Worker 側で計算して値で渡します。SQL のコメントに NOW() のような関数名を書くだけでも、キャッシュの対象から外れることがあります。
- PostgreSQL の
LISTEN・NOTIFYや MySQL のUSE文などは使えない。要るなら Hyperdrive を通さないクライアントを別に持つ - クライアントはハンドラの中で毎回作り、グローバルスコープに置かない
- 1回のリクエストでクエリを何度も順に投げるなら、Placement(Worker をデータベースの近くで動かす設定)が役立つ。1クエリの往復は遠くから20〜30ms、近くなら1〜3ms
よくある質問
Hyperdriveだけでデータを保存できますか?
できません。データは PostgreSQL・MySQL 側に置きます。データベースが無ければ、D1 を作るか、ダッシュボードから PlanetScale のデータベースを作れます。
D1をHyperdrive経由で使えますか?
使えません。D1 はもともと Workers から速くつながる作りなので、Hyperdrive は要りません。
データベースの料金は別にかかりますか?
かかります。つなぐ先のデータベースの利用料は、契約先へ別に払います。Cloudflare から作った PlanetScale も、利用料は Hyperdrive とは別です。
SQL ServerやMongoDBは使えますか?
2026年11月時点では使えません。対象は PostgreSQL・MySQL と、その互換のデータベースです。
PythonのWorkersからも使えますか?
使えます。2026年9月から、Python Workers も Hyperdrive 経由で PostgreSQL・MySQL につなげます。
この記事のポイント
- 今あるPostgreSQL・MySQLをWorkersから速く使える
- 接続の準備・使い回し・読み取りのキャッシュの3つで速くする
- 無料は1日10万クエリまで。キャッシュから返した分も数える
- 新しく作るならD1、今あるDBを使い続けるならHyperdrive
まとめ
Cloudflare Hyperdrive は、今ある PostgreSQL・MySQL へのクエリを Workers から速くするサービスです。接続の準備・接続の使い回し・読み取りのキャッシュの3つで速くします。無料プランは1日10万クエリまでで、キャッシュから返した分も数えます。
新しく作るなら D1、今のデータベースを使い続けるなら Hyperdrive です。キャッシュは書き込んでも消えないので、ログインや権限はキャッシュを切った設定で読みます。まずはファイアウォールの許可を確かめ、Get started の手順で設定を1つ作ってみてください。






