Adatbázis I: maradó Postgres + Hyperdrive

4.1A probléma: 300 város, egy adatbázis

Beanstalkon a Node-processzeid a DB mellett élnek, és induláskor felhúznak egy connection poolt, ami órákig szolgál. Az edge-en ez a modell kétszeresen törik el:

• A kapcsolatfelvétel drága. Egy új Postgres-kapcsolat TLS-kézfogással, autentikációval együtt több hálózati kört igényel. Ha a Worker Sydney-ben fut, a DB Frankfurtban van, ez körönként ~300 ms — a lekérdezés előtt. Stateless isolate-ekből ráadásul újra és újra.
• A kapcsolatok száma véges. A Postgres jellemzően pár száz egyidejű kapcsolatot bír. Több száz PoP-ban futó, ezernyi isolate — pool nélkül percek alatt kimeríti az Aurora max_connections-ét.

Ez ugyanaz a problémakör, amiért az AWS-en Lambda + RDS mellé RDS Proxyt tettél volna. A Cloudflare válasza a Hyperdrive — ugyanez a szerep, de globálisan elosztva és query cache-sel megfejelve.

4.2Hogyan működik a Hyperdrive?

• ① Edge connection setup. A drivered „kapcsolatfelvétele" a Workerhez legközelebbi Hyperdrive-példánnyal történik — ezredmásodpercek a kontinensközi körök helyett.
• ② Pooling a DB mellett. A tényleges Postgres-kapcsolatokat a Hyperdrive tartja melegen, az adatbázisodhoz közel, tranzakció-módban: egy kapcsolat egy tranzakció idejére a tiéd, utána visszakerül a poolba. Az Aurora véges kapcsolatszáma így védve van a globális isolate-hadseregtől.
• ③ Query cache. A Hyperdrive értelmezi az SQL-t: a nem-mutáló (read) lekérdezések eredményét a konfigurált max_age-ig cache-eli az edge-en. A slágerlekérdezéseid el sem jutnak az Auroráig.

4.3Beüzemelés: három lépés

1. Hozd létre a Hyperdrive-konfigot a meglévő connection stringeddel (ez a Cloudflare-nél tárolódik, nem a kódodban):

npx wrangler hyperdrive create my-aurora \
  --connection-string="postgres://user:pass@my-cluster.eu-central-1.rds.amazonaws.com:5432/app"

2. Kösd be a Workeredbe (és mivel a Postgres-driverek Node API-kra épülnek, kell a nodejs_compat — 2. modul):

{
  "compatibility_flags": ["nodejs_compat"],
  "hyperdrive": [
    { "binding": "HYPERDRIVE", "id": "<CONFIG_ID>" }
  ]
}

3. Használd a megszokott drivereddel. A binding egy generált connection stringet ad — a drivered azt hiszi, egy sima Postgreshez beszél:

import postgres from "postgres";   // vagy node-postgres, Drizzle, Kysely…

export default defineEventHandler(async (event) => {
  const { env } = event.context.cloudflare;

  // FONTOS: a handler BELSEJÉBEN példányosíts, ne globálisan! (2. modul)
  const sql = postgres(env.HYPERDRIVE.connectionString);

  const products = await sql`SELECT id, name, price FROM products
                              WHERE active = true ORDER BY name`;
  return products;
});

ORM-mel ugyanez: a Drizzle a node-postgres vagy postgres.js driver fölött ül, tehát a sémáid, query buildered, migrációs fájljaid maradnak. Lokális fejlesztésnél a WRANGLER_HYPERDRIVE_LOCAL_CONNECTION_STRING_HYPERDRIVE környezeti változóval a lokális/dev Postgresedre mutatsz — a kód nem változik.

4.4A két csapda, amit ismerned kell

1. Tranzakció-mód: a kapcsolat nem „a tiéd"

Beanstalkon egy kapcsolatot akár egy teljes kérésen át fogva tarthattál, session-szintű SET-ekkel. A Hyperdrive poolja tranzakció-módú: minden tranzakció után a kapcsolat visszamegy a poolba, és RESET-elődik. Következmények: session-szintű állapotra (temp táblák, session SET-ek, advisory lockok kérések között) nem építhetsz; a SET tranzakción vagy egy query-n belül él csak; és ne tarts hosszú tranzakciókat pusztán azért, hogy állapotot őrizz — az kizárja a kapcsolatot a pool elől. Named prepared statements a postgres.js és node-postgres driverrel támogatottak.

2. Query cache: nincs write-invalidáció

A Hyperdrive nem érvényteleníti a cache-elt read-eket, amikor írsz az adatbázisba — a cache a max_age lejártáig élhet (plusz stale_while_revalidate ablak). Egy INSERT utáni azonnali SELECT visszaadhatja a régi állapotot. A bevált minta: két Hyperdrive-konfig ugyanarra a DB-re — egy cache-elt a tömeges, staleness-tűrő read-eknek (katalógus, listák, dashboardok), és egy --caching-disabled a friss olvasást igénylő utaknak (auth, session, jogosultság, write-után-read):

npx wrangler hyperdrive create my-aurora-fresh \
  --connection-string="postgres://…" --caching-disabled

const sql      = postgres(env.HYPERDRIVE.connectionString);        // cache-elt
const sqlFresh = postgres(env.HYPERDRIVE_FRESH.connectionString);  // mindig friss

const catalog = await sql`SELECT … FROM products`;      // jöhet cache-ből
const user    = await sqlFresh`SELECT … FROM sessions`; // soha nem stale

4.5RDS Proxy vs. Hyperdrive — gyors összevetés

A stratégiai kép a migrációdhoz (10. modul előzetese): a Hyperdrive miatt az adatbázis-döntést szétválaszthatod az app-migrációtól. Első lépésben az app megy Workersre, az Aurora marad — működő, gyors setup. Hogy utána érdemes-e D1-re vagy másra váltani, az már ráér — erről szól a következő modul.

4.6Ellenőrizd magad