Create and bind a Hyperdrive configuration

Create a Hyperdrive configuration from the database connection details. Cloudflare verifies the origin and returns a configuration ID for the Worker binding.

Use nodejs_compat for database drivers and regenerate Worker types. The Worker reads env.HYPERDRIVE.connectionString; it does not need the original database password in source. Scope the origin database user to the application’s real privileges.

Create a practice configuration and verify the binding name and database role before running any write query.

Create the configuration without putting the database password in source:

npx wrangler hyperdrive create app-db --connection-string "$DATABASE_URL"
npx wrangler hyperdrive get app-db

Copy only the returned binding ID into project configuration. Store the origin credential through the supported secret path. Connect from a local or preview environment first, then verify which database, role, and network path the binding actually reaches.