データベース認証情報のローテーション

Hyperdrive 設定の接続情報と認証情報は、次のいずれかの方法で変更できます。

1. 新しい接続情報で新しい Hyperdrive 設定を作成し、Worker をその新しい Hyperdrive 設定を使うように更新します。
2. 既存の Hyperdrive 設定を、新しい接続情報と認証情報で更新します。

新しい Hyperdrive 設定を作ってデータベース認証情報を更新すると、既存の Hyperdrive 設定はそのまま残せます。Worker を新しい設定へ段階的に移行でき、必要なら以前の設定へ簡単にロールバックできます。

既存の PostgreSQL または MySQL データベースに接続する Hyperdrive 設定を作成するには、Wrangler CLI または Cloudflare dashboard ↗ を使います。

# wrangler v3.11 and above required
npx wrangler hyperdrive create my-updated-hyperdrive --connection-string="<YOUR_CONNECTION_STRING>"

上記のコマンドは Hyperdrive の ID を出力します。Workers プロジェクトの Wrangler 設定ファイル に、この ID を設定します。

{
	// 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>"

Worker を新しい Hyperdrive 設定に切り替えるには、Worker を再デプロイするか、段階的デプロイ を使います。

既存の Hyperdrive 設定は、wrangler CLI で更新できます。

# wrangler v3.11 and above required
npx wrangler hyperdrive update <HYPERDRIVE_CONFIG_ID> --origin-host <YOUR_ORIGIN_HOST> --origin-password <YOUR_ORIGIN_PASSWORD> --origin-user <YOUR_ORIGIN_USERNAME> --database <YOUR_DATABASE> --origin-port <YOUR_ORIGIN_PORT>