Cloudflare HyperdriveとGCP Cloud SQL PostgreSQL
Cloudflare WorkersからHyperdriveを使いGCP Cloud SQL PostgreSQLの接続プーリングとキャッシュでクエリを高速化する完全ガイド。
Cloudflare Workersを使用すると、世界300以上のエッジロケーションでコードが実行され、ユーザーに数ミリ秒の超低レイテンシでレスポンスを返すことができます。しかし、Google Cloud SQL for PostgreSQLなどのリレーショナルデータベースは、通常特定の単一リージョン(例: アイオワの us-central1 やシンガポールの asia-southeast1)に配置されています。
この「グローバル分散エッジコンピューティング」と「集中型データベース」の組み合わせには、接続確立のレイテンシと接続数の枯渇(connection exhaustion)という大きな課題が存在します。この問題をエレガントに解決するのがCloudflare Hyperdriveです。
1. 課題: エッジからデータベースへの接続はなぜ遅いのか?#
従来のWebアーキテクチャでは、バックエンドサーバーとPostgreSQLは同一データセンターやVPC内に配置され、接続遅延は1ms未満でした。
しかし、サーバーレスのエッジWorkerでは状況が根本から異なります:
- ハンドシェイクの往復遅延(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を浪費してしまいます。
- 接続数の急激な枯渇: サーバーレスワーカーはリクエストごとに独立してスケールします。5,000リクエストが同時に集中すると、5,000個の独立した接続がCloud SQLに押し寄せ、データベースのメモリを圧迫し、
max_connectionsの上限を瞬時に突破してしまいます。
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つの選択肢があります:
構成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の準備#
- PostgreSQLインスタンス(v14、v15、またはv16)を用意します。
- アプリケーション専用ユーザーを作成します:
sqlCREATE 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; - パブリックIPを利用する場合は、Google Cloud Console > Cloud SQL > インスタンス > 接続 > ネットワーキング:
- パブリックIPを有効化。
- SSL接続のみを許可を有効化。
- 承認済みネットワークにCloudflareのエグレスIP範囲を追加。
ステップ2: Wrangler CLIでHyperdrive設定を作成#
最新のWrangler CLIを使用してHyperdrive設定を作成します:
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が出力されます:
✅ Successfully created Hyperdrive configuration
📋 Details:
ID: fc7a9b12c3454e6789a0bcdef1234567
Name: gcp-postgres-hyperdrive
Host: 34.123.45.67
Port: 5432
Database: my_production_db
User: worker_appbashステップ3: wrangler.toml にバインディングを追加#
Workerプロジェクトの設定ファイルにHyperdriveを紐付けます:
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) の利用#
ライブラリのインストール:
npm install pg
npm install --save-dev @types/pgbashハンドラー実装:
import { Client } from 'pg';
export interface Env {
HYPERDRIVE: Hyperdrive;
}
export default {
async fetch(request: Request, env: Env): Promise<Response> {
const client = new Client({
connectionString: env.HYPERDRIVE.connectionString,
});
try {
await client.connect();
const result = await client.query(`
SELECT
id,
title,
created_at,
NOW() AS query_timestamp
FROM articles
ORDER BY created_at DESC
LIMIT 10;
`);
return Response.json({
success: true,
count: result.rows.length,
data: result.rows,
});
} catch (err: unknown) {
const message = err instanceof Error ? err.message : String(err);
return Response.json({ success: false, error: message }, { status: 500 });
} finally {
// client.end() を呼ぶとHyperdriveの接続プールに返却されます
await client.end();
}
},
};ts方法B: postgres.js の利用(軽量・高速)#
import postgres from 'postgres';
export interface Env {
HYPERDRIVE: Hyperdrive;
}
export default {
async fetch(request: Request, env: Env): Promise<Response> {
const sql = postgres(env.HYPERDRIVE.connectionString, {
max: 5,
fetch_types: false,
});
try {
const articles = await sql`
SELECT id, title, created_at
FROM articles
LIMIT 10
`;
return Response.json({ articles });
} finally {
await sql.end();
}
},
};tsステップ5: プライベートIP Cloud SQLへのTunnel接続(発展)#
Cloud SQLにパブリックIPを持たせない完全閉域網構成の場合:
- 同一VPCサブネットにGCEインスタンス(
e2-micro)を立ち上げます。 - GCE上で
cloudflaredを設定し、Cloudflare Tunnelを作成します:GCEのTerminal
bashcloudflared tunnel create gcp-sql-tunnel - TCPルーティングを設定:
/etc/cloudflared/config.yml
yamltunnel: <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 - Hyperdrive設定時にCloudflare Accessサービストークンを指定:
Terminal
bashwrangler 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>"
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 を組み合わせることで:
- 世界規模のエッジ速度: Cloudflare Workersのミリ秒級の配信速度をフルに活かせます。
- 接続オーバーヘッドの撤廃: 接続確立にかかる数百ミリ秒の無駄な遅延をゼロ近くまで削減します。
- DBサーバーの負荷軽減: 接続数の爆発を防ぎ、キャッシュによってCloud SQLインスタンスのCPU負荷を大幅に引き下げます。
参考文献#
- Cloudflare Documentation - Hyperdrive Overview ↗
- Cloudflare Documentation - Connect Hyperdrive to Google Cloud SQL PostgreSQL ↗
- Cloudflare Documentation - Connect to PostgreSQL via Hyperdrive ↗
- Cloudflare Documentation - Hyperdrive with Postgres.js Driver ↗
- Google Cloud Documentation - Cloud SQL for PostgreSQL ↗
- PlanetScale - Making Serverless Databases Fast with Cloudflare Hyperdrive ↗