轮换数据库凭据

可通过以下两种方式更改 Hyperdrive 配置的连接信息和凭据：

使用新连接信息创建新 Hyperdrive 配置，并更新 Worker 使用新配置。
使用新连接信息和凭据更新现有 Hyperdrive 配置。

使用新 Hyperdrive 配置

创建新 Hyperdrive 配置以更新数据库凭据时，可保持现有配置不变、逐步将 Worker 迁移到新配置，并在需要时轻松回滚到先前配置。

要创建连接现有 PostgreSQL 或 MySQL 数据库的 Hyperdrive 配置，使用 Wrangler CLI 或 Cloudflare 仪表板 ↗。

# 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-08-17",
	"hyperdrive": [
		{
			"binding": "HYPERDRIVE",
			"id": "<your-hyperdrive-id-here>"
		}
	]
}

compatibility_flags = [ "nodejs_compat" ]
# Set this to today's date
compatibility_date = "2026-08-17"

[[hyperdrive]]
binding = "HYPERDRIVE"
id = "<your-hyperdrive-id-here>"

要更新 Worker 使用新 Hyperdrive 配置，重新部署 Worker 或使用渐进式部署。

更新现有 Hyperdrive 配置

可使用 wrangler CLI 更新现有 Hyperdrive 配置的设置。

# 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>