Hyperdrive

Turn your existing regional database into a globally distributed database.

Hyperdrive is a service that accelerates queries you make to existing databases, making it faster to access your data from across the globe from Cloudflare Workers, irrespective of your users' location.

Hyperdrive supports any Postgres or MySQL database, including those hosted on AWS, Google Cloud, Azure, Neon and PlanetScale. Hyperdrive also supports Postgres-compatible databases like CockroachDB and Timescale.You do not need to write new code or replace your favorite tools: Hyperdrive works with your existing code and tools you use.

Use Hyperdrive's connection string from your Cloudflare Workers application with your existing Postgres drivers and object-relational mapping (ORM) libraries:

TypeScript

import{Client} from"pg";
exportdefault{
asyncfetch(request,env,ctx):Promise<Response>{
// Create a new client instance for each request. Hyperdrive maintains the
// underlying database connection pool, so creating a new client is fast.
constclient=newClient({
connectionString:env.HYPERDRIVE.connectionString,
});
try{
// Connect to the database
awaitclient.connect();
// Sample SQL query
constresult=awaitclient.query("SELECT * FROM pg_tables");
returnResponse.json(result.rows);
}catch (e){
returnResponse.json({ error:einstanceofError?e.message:e},{ status:500});
}
},
}satisfiesExportedHandler<{ HYPERDRIVE:Hyperdrive}>;

{
"$schema":"node_modules/wrangler/config-schema.json",
"name":"WORKER-NAME",
"main":"src/index.ts",
"compatibility_date":"2025-02-04",
"compatibility_flags":[
"nodejs_compat"
],
"observability":{
"enabled":true
},
"hyperdrive":[
{
"binding":"HYPERDRIVE",
"id":"<YOUR_HYPERDRIVE_ID>",
"localConnectionString":"<ENTER_LOCAL_CONNECTION_STRING_FOR_LOCAL_DEVELOPMENT_HERE>"
}
]
}

TypeScript

import{createConnection} from'mysql2/promise';
exportdefault{
asyncfetch(request,env,ctx):Promise<Response>{
// Create a new connection on each request. Hyperdrive maintains the
// underlying database connection pool, so creating a new client is fast.
constconnection=awaitcreateConnection({
host:env.HYPERDRIVE.host,
user:env.HYPERDRIVE.user,
password:env.HYPERDRIVE.password,
database:env.HYPERDRIVE.database,
port:env.HYPERDRIVE.port,
// This is needed to use mysql2 with Workers
// This configures mysql2 to use static parsing instead of eval() parsing (not available on Workers)
disableEval: true
});
const[results,fields]=awaitconnection.query('SHOW tables;');
returnnewResponse(JSON.stringify({results,fields}),{
headers:{
'Content-Type':'application/json',
'Access-Control-Allow-Origin':'\*',
},
});
}}satisfiesExportedHandler<{ HYPERDRIVE:Hyperdrive}>;

{
"$schema":"node_modules/wrangler/config-schema.json",
"name":"WORKER-NAME",
"main":"src/index.ts",
"compatibility_date":"2025-02-04",
"compatibility_flags":[
"nodejs_compat"
],
"observability":{
"enabled":true
},
"hyperdrive":[
{
"binding":"HYPERDRIVE",
"id":"<YOUR_HYPERDRIVE_ID>",
"localConnectionString":"<ENTER_LOCAL_CONNECTION_STRING_FOR_LOCAL_DEVELOPMENT_HERE>"
}
]
}