この例では、Hyperdrive を Azure Database for PostgreSQL インスタンスに接続する方法を示します。
Hyperdrive がデータベースに接続できるよう、有効な認証情報とネットワークアクセスがあることを確認します。
パブリックインターネット経由で Azure Database for PostgreSQL インスタンスに接続する手順は次のとおりです。
- Azure Portal ↗ で、Hyperdrive の接続先インスタンスを選択します。
- Settings > Networking を展開し、Public access が有効であることを確認します。Firewall rules で、Start IP address に
0.0.0.0、End IP address に255.255.255.255を追加します。 - Save を選択して変更を保存します。
- サイドバーの Overview を選択し、インスタンスの Server name を控えます。
ユーザー名、パスワード、サーバー名、データベース名（デフォルトは postgres）が揃ったら、Hyperdrive のデータベース構成を作成できます。
プライベートな Azure Database for PostgreSQL インスタンスに接続するには、Tunnel でプライベートデータベースに接続する を参照してください。
Hyperdrive を設定するには、次の情報が必要です。
- データベースの IP アドレス（またはホスト名）とポート。
- 前の手順で設定したデータベースのユーザー名（例:
hyperdrive-demo）。 - そのユーザー名に対応するパスワード。
- Hyperdrive が接続するデータベース名。例:
postgres。
Hyperdrive は、これらのパラメーターを組み合わせた、データベースドライバーで一般的な接続文字列形式を受け付けます。
postgres://USERNAME:PASSWORD@HOSTNAME_OR_IP_ADDRESS:PORT/database_nameほとんどのデータベースプロバイダーは、Hyperdrive にそのままコピー＆ペーストできる接続文字列を提供します。
Cloudflare ダッシュボードで Hyperdrive 設定を作成する手順は次のとおりです。
-
Cloudflare ダッシュボードで Hyperdrive ページを開きます。
Hyperdrive を開く ↗ -
Create Configuration を選択します。
-
接続文字列を含め、フォームに入力します。
-
Create を選択します。
Wrangler CLI で Hyperdrive 設定を作成する手順は次のとおりです。
-
ターミナルを開き、次のコマンドを実行します。
<NAME_OF_HYPERDRIVE_CONFIG>を Hyperdrive 設定の名前に置き換え、データベースホストから提供された接続文字列を貼り付けるか、user、password、HOSTNAME_OR_IP_ADDRESS、port、database_nameのプレースホルダーをデータベース固有の値に置き換えます。npx wrangler hyperdrive create <NAME_OF_HYPERDRIVE_CONFIG> --connection-string="postgres://user:password@HOSTNAME_OR_IP_ADDRESS:PORT/database_name" -
このコマンドは、Wrangler 設定ファイル 向けのバインディングを出力します。
{ "$schema": "./node_modules/wrangler/config-schema.json", "name": "hyperdrive-example", "main": "src/index.ts", // Set this to today's date "compatibility_date": "2026-09-20", "compatibility_flags": [ "nodejs_compat" ], // Pasted from the output of `wrangler hyperdrive create <NAME_OF_HYPERDRIVE_CONFIG> --connection-string=[...]` above. "hyperdrive": [ { "binding": "HYPERDRIVE", "id": "<ID OF THE CREATED HYPERDRIVE CONFIGURATION>" } ] }"$schema" = "./node_modules/wrangler/config-schema.json" name = "hyperdrive-example" main = "src/index.ts" # Set this to today's date compatibility_date = "2026-09-20" compatibility_flags = [ "nodejs_compat" ] [[hyperdrive]] binding = "HYPERDRIVE" id = "<ID OF THE CREATED HYPERDRIVE CONFIGURATION>"
node-postgres ドライバーをインストールします。
npm i pg@>8.16.3yarn add pg@>8.16.3pnpm add pg@>8.16.3bun add pg@>8.16.3TypeScript を使う場合は、型定義パッケージもインストールします。
npm i -D @types/pgyarn add -D @types/pgpnpm add -D @types/pgbun add -d @types/pg必要な Node.js 互換性フラグと Hyperdrive バインディングを、wrangler.jsonc ファイルに追加します。
{
// required for database drivers to function
"compatibility_flags": [
"nodejs_compat"
],
// Set this to today's date
"compatibility_date": "2026-09-20",
"hyperdrive": [
{
"binding": "HYPERDRIVE",
"id": "<your-hyperdrive-id-here>"
}
]
}compatibility_flags = [ "nodejs_compat" ]
# Set this to today's date
compatibility_date = "2026-09-20"
[[hyperdrive]]
binding = "HYPERDRIVE"
id = "<your-hyperdrive-id-here>"新しい Client インスタンスを作成し、Hyperdrive の connectionString を渡します。
// filepath: src/index.ts
import { Client } from "pg";
export default {
async fetch(
request: Request,
env: Env,
ctx: ExecutionContext,
): Promise<Response> {
// Create a new client instance for each request. Hyperdrive maintains the
// underlying database connection pool, so creating a new client is fast.
const client = new Client({
connectionString: env.HYPERDRIVE.connectionString,
});
try {
// Connect to the database
await client.connect();
// Perform a simple query
const result = await client.query("SELECT * FROM pg_tables");
return Response.json({
success: true,
result: result.rows,
});
} catch (error: any) {
console.error("Database error:", error.message);
return new Response("Internal error occurred", { status: 500 });
}
},
};- Hyperdrive の仕組み について詳しく学びます。
- よくある問題の切り分けは トラブルシューティングガイド を参照してください。
- Cloudflare Workers で使えるほかの ストレージオプション についても確認します。