Connect from Cloudflare Workers

A Worker can consume a Prisma Postgres database two ways. Both start from the same resources:

import * as Cloudflare from "alchemy/Cloudflare";
import * as Prisma from "alchemy/Prisma";

const project = yield* Prisma.Project("app", { createDatabase: false });
const postgres = yield* Prisma.Postgres("db", { project });
const connection = yield* Prisma.Connection("api", {
  database: postgres,
});

Over Hyperdrive

Front the connection’s direct origin with a Hyperdrive config and query it with SQL.Postgres — Hyperdrive pools and accelerates the TCP connection at the edge:

const hyperdrive = yield* Cloudflare.Hyperdrive.Connection("api-hd", {
  origin: connection.origin.as<Prisma.PostgresOrigin>(),
});

export default Cloudflare.Worker(
  "api",
  { main: import.meta.filename },
  Effect.gen(function* () {
    const hd = yield* Cloudflare.Hyperdrive.Connect(hyperdrive);
    const sql = yield* SQL.Postgres({ url: hd.connectionString });

    return {
      fetch: Effect.gen(function* () {
        const users = yield* sql`SELECT * FROM users`;
        return yield* HttpServerResponse.json(users);
      }),
    };
  }).pipe(Effect.provide(Cloudflare.Hyperdrive.ConnectBinding)),
);

Prefer Drizzle? Swap the client: Drizzle.Postgres(hd.connectionString, { relations }).

With the Connect binding

When you don’t need edge pooling, bind the connection directly. The binding carries the connection’s outputs into the Worker as secret text bindings, and the runtime client hands back Redacted URLs:

export default Cloudflare.Worker(
  "api",
  { main: import.meta.filename },
  Effect.gen(function* () {
    const db = yield* Prisma.Connect(connection);
    const sql = yield* SQL.Postgres({ url: db.databaseUrl });

    return {
      fetch: Effect.gen(function* () {
        const users = yield* sql`SELECT * FROM users`;
        return yield* HttpServerResponse.json(users);
      }),
    };
  }).pipe(Effect.provide(Prisma.ConnectBinding)),
);

db.databaseUrl prefers the pooled endpoint, so short-lived Worker connections share Prisma’s pooler instead of opening a direct connection per request.

Where next

• Hyperdrive — caching, mTLS, and the rest of the Hyperdrive surface.
• Connections — every connection output and the origin shape.
• SQL clients — SQL.Postgres, layers, and Drizzle.