blog.dopana

戻る

Cloudflare Workersを使用すると、世界300以上のエッジロケーションでコードが実行され、ユーザーに数ミリ秒の超低レイテンシでレスポンスを返すことができます。しかし、Google Cloud SQL for PostgreSQLなどのリレーショナルデータベースは、通常特定の単一リージョン(例: アイオワの us-central1 やシンガポールの asia-southeast1)に配置されています。

この「グローバル分散エッジコンピューティング」と「集中型データベース」の組み合わせには、接続確立のレイテンシと接続数の枯渇(connection exhaustion)という大きな課題が存在します。この問題をエレガントに解決するのがCloudflare Hyperdriveです。


1. 課題: エッジからデータベースへの接続はなぜ遅いのか?#

従来のWebアーキテクチャでは、バックエンドサーバーとPostgreSQLは同一データセンターやVPC内に配置され、接続遅延は1ms未満でした。

しかし、サーバーレスのエッジWorkerでは状況が根本から異なります:

  1. ハンドシェイクの往復遅延(RTTオーバーヘッド): 東京のエッジWorkerが米国のCloud SQLにクエリを投げる場合、以下の一連の手続きが必要です:
    • DNS名前解決
    • TCP 3ウェイハンドシェイク(1 RTT)
    • TLS/SSLネゴシエーション(1〜2 RTT)
    • PostgreSQL認証(MD5またはSCRAM-SHA-256)(1〜2 RTT) 太平洋を跨いで合計6〜8回のラウンドトリップ(往復)が発生します。SQLクエリを1バイト送信する前の接続確立だけで200ms〜500msを浪費してしまいます。
  2. 接続数の急激な枯渇: サーバーレスワーカーはリクエストごとに独立してスケールします。5,000リクエストが同時に集中すると、5,000個の独立した接続がCloud SQLに押し寄せ、データベースのメモリを圧迫し、max_connectionsの上限を瞬時に突破してしまいます。
Cloudflare Hyperdrive導入後従来のアプローチ: 直接接続1. TCP Handshake2. TLS Handshake3. Postgres SCRAM Auth6〜8 RTT消費 約300〜500ms4. SQLクエリ送信ローカルエッジ内接続 約1msキャッシュヒット時は即座に応答ウォーム接続プールを常時維持接続確立のRTTオーバーヘッド ゼロEdge Worker - 東京GCP Cloud SQL - us-central1Edge Worker - 東京Hyperdrive Edge EngineGCP Cloud SQL - us-central1

2. 10歳でもわかる解説(ELI5)#

[!TIP] 世界中のコンビニと遠方の銀行金庫のたとえ: 世界各地の街角にあるコンビニエンスストア(Edge Workers)を運営しているとします。しかし、売上や在庫の元帳はアメリカの銀行の巨大な金庫(GCP Cloud SQL)に1冊しかありません。

  • Hyperdriveがない場合: 東京の店舗でお客さんに「このジュースの在庫ある?」と聞かれるたびに、店員が飛行機に乗ってアメリカへ飛び、入館手続きをして金庫を開け、帳簿を確認してまた東京に戻って答えます。時間も航空券代もかかりすぎて現実的ではありません。
  • Hyperdriveがある場合: Hyperdriveは、金庫の中に専任の担当者を常駐させ、24時間繋ぎっぱなしの暗号化専用ホットラインを用意します(接続プーリング)。さらに、各コンビニのレジ横によくある質問のメモ用紙(クエリキャッシュ)を置きます。ジュースの価格なら手元のメモを見て1ミリ秒で即答。新しい記録が必要な場合も、ホットラインで一瞬で担当者に伝えて記帳してもらうため、飛行機に乗る必要がなくなります!

3. ネットワーク構成: パブリックIP vs プライベートIP(VPC)#

GCP Cloud SQLとHyperdriveを連携させる構成には、データベースの公開設定に応じて2つの選択肢があります:

構成2: プライベートIP / VPC構成1: パブリックIPCloudflare Global Networkパブリックインターネット経由のTLS暗号化Cloudflare Tunnel TCPVPC プライベートIP 10.x.x.xCloudflare WorkerHyperdriveCloud SQL - パブリックIP承認済みネットワークGCE インスタンスcloudflared daemonCloud SQL - プライベートIP

構成1: パブリックIPを使用する Cloud SQL#

  • 特徴: 最も素早くセットアップ可能。
  • セキュリティ: Cloud SQL側で「SSL/TLS接続のみを許可」を有効にし、**承認済みネットワーク(Authorized Networks)**にCloudflare HyperdriveのエグレスIP範囲を追加します。通信はすべてTLSで暗号化されます。

構成2: プライベートIP(VPC)+ Cloudflare Tunnel / GCE Proxy#

  • 特徴: Cloud SQLにパブリックIPを一切持たせず、VPC内部(10.x.x.x)に完全隔離。
  • 構成方法: 同じVPCサブネット内に軽量なGCE仮想マシン(e2-microなど)を配置し、cloudflaredデーモンを動かしてCloudflare Tunnelを張ります。Hyperdriveは外部にポートを開放することなく、安全にプライベートネットワーク内のDBにアクセスできます。

4. ステップ・バイ・ステップ構築手順#

ステップ1: GCP Cloud SQL PostgreSQLの準備#

  1. PostgreSQLインスタンス(v14、v15、またはv16)を用意します。
  2. アプリケーション専用ユーザーを作成します:
    CREATE USER worker_app WITH PASSWORD 'your_secure_password';
    GRANT CONNECT ON DATABASE my_production_db TO worker_app;
    GRANT USAGE ON SCHEMA public TO worker_app;
    GRANT SELECT, INSERT, UPDATE, DELETE ON ALL TABLES IN SCHEMA public TO worker_app;
    sql
  3. パブリックIPを利用する場合は、Google Cloud Console > Cloud SQL > インスタンス > 接続 > ネットワーキング:
    • パブリックIPを有効化。
    • SSL接続のみを許可を有効化。
    • 承認済みネットワークにCloudflareのエグレスIP範囲を追加。

ステップ2: Wrangler CLIでHyperdrive設定を作成#

最新のWrangler CLIを使用してHyperdrive設定を作成します:

Terminal
wrangler hyperdrive create gcp-postgres-hyperdrive \
  --connection-string="postgres://worker_app:your_secure_password@34.123.45.67:5432/my_production_db?sslmode=require"
bash

作成に成功すると、HyperdriveのIDが出力されます:

Output
✅ Successfully created Hyperdrive configuration
📋 Details:
  ID: fc7a9b12c3454e6789a0bcdef1234567
  Name: gcp-postgres-hyperdrive
  Host: 34.123.45.67
  Port: 5432
  Database: my_production_db
  User: worker_app
bash

ステップ3: wrangler.toml にバインディングを追加#

Workerプロジェクトの設定ファイルにHyperdriveを紐付けます:

wrangler.toml
name = "my-fast-api"
main = "src/index.ts"
compatibility_date = "2026-09-01"
compatibility_flags = ["nodejs_compat"]

[[hyperdrive]]
binding = "HYPERDRIVE"
id = "fc7a9b12c3454e6789a0bcdef1234567"
toml

[!IMPORTANT] Cloudflare Workers上で標準的なNode.jsデータベースドライバ(pgやpostgres)を実行するには、compatibility_flags = ["nodejs_compat"] の設定が必須です。


ステップ4: Worker接続コードの実装#

Hyperdriveは動的な接続文字列 env.HYPERDRIVE.connectionString を提供します。これにより、Workerは最寄りのCloudflareデータセンターにあるプロキシへローカル接続します。

方法A: node-postgres (pg) の利用#

ライブラリのインストール:

Terminal
npm install pg
npm install --save-dev @types/pg
bash

ハンドラー実装:

方法B: postgres.js の利用(軽量・高速)#


ステップ5: プライベートIP Cloud SQLへのTunnel接続(発展)#

Cloud SQLにパブリックIPを持たせない完全閉域網構成の場合:

  1. 同一VPCサブネットにGCEインスタンス(e2-micro)を立ち上げます。
  2. GCE上で cloudflared を設定し、Cloudflare Tunnelを作成します:
    GCEのTerminal
    cloudflared tunnel create gcp-sql-tunnel
    bash
  3. TCPルーティングを設定:
    /etc/cloudflared/config.yml
    tunnel: <TUNNEL_UUID>
    credentials-file: /etc/cloudflared/<TUNNEL_UUID>.json
    
    ingress:
      - hostname: db-private.yourdomain.com
        service: tcp://10.128.0.5:5432
      - service: http_status:404
    yaml
  4. Hyperdrive設定時にCloudflare Accessサービストークンを指定:
    Terminal
    wrangler hyperdrive create gcp-postgres-hyperdrive \
      --connection-string="postgres://worker_app:secret@db-private.yourdomain.com:5432/my_production_db" \
      --access-client-id="<CLIENT_ID>" \
      --access-client-secret="<CLIENT_SECRET>"
    bash

5. Hyperdriveのクエリキャッシュの仕組み#

Hyperdriveは単なるコネクションプーラーにとどまらず、PostgreSQLのプロトコルを解釈するインテリジェントなプロキシです:

  • 読み取りクエリ(SELECT)の自動キャッシュ: 参照専用クエリをエッジ側でキャッシュし、Cloud SQLへの往復すら発生させずにミリ秒未満で返却します。
  • トランザクションの一貫性(Read-Your-Own-Writes): トランザクション内や更新クエリ(INSERT、UPDATE、DELETE)が実行された場合、後続のクエリは即座にオリジンDBへルーティングされ、古いキャッシュを参照するリスクを防ぎます。
  • TTLの柔軟な設定: キャッシュの保持期間(max-age)をプロジェクトの要件に合わせて制御できます。

6. まとめ#

Cloudflare Hyperdrive と Google Cloud SQL for PostgreSQL を組み合わせることで:

  1. 世界規模のエッジ速度: Cloudflare Workersのミリ秒級の配信速度をフルに活かせます。
  2. 接続オーバーヘッドの撤廃: 接続確立にかかる数百ミリ秒の無駄な遅延をゼロ近くまで削減します。
  3. DBサーバーの負荷軽減: 接続数の爆発を防ぎ、キャッシュによってCloud SQLインスタンスのCPU負荷を大幅に引き下げます。

参考文献#