← Hyperdrive (Postgres & MySQL) / hyperdrive

PlanetScale Postgres & MySQL

Cloudflare spolupracuje s PlanetScale ↗ a poskytnout tak Workers databáze Postgres a MySQL (Vitess) hostované na PlanetScale. Hyperdrive se připojuje Workers k databázím PlanetScale se zabudovaným poolingem připojení a ukládáním dotazů do mezipaměti pro vyšší výkon.

Využijte výhody obou produktů: stavte na globální distribuci Workers a zároveň optimalizujte pro regionální přístup k datům. Začněte vytvořením databáze PlanetScale v Cloudflare dashboardu.

Databázi PlanetScale účtovanou přes Cloudflare můžete vytvořit také z příkazové řádky pomocí PlanetScale CLI ↗ (pscale), pomocí Wrangler k autorizaci fakturační strany požadavku v Cloudflare. Vyžaduje to pscale verze v0.313.0 nebo novější.

Vygenerujte autorizaci k fakturaci:

npx wrangler hyperdrive planetscale signature

Vypíše se obsah JSON:

{
	"account_id": "<ACCOUNT_ID>",
	"timestamp": "<TIMESTAMP>",
	"signature": "<SIGNATURE>"
}

pscale database create přijímá tento payload prostřednictvím svého --cloudflare-billing parametr. Předání @- způsobí, že PlanetScale CLI jej načte ze standardního vstupu, což doporučujeme namísto předávání podpisu jako argumentu příkazové řádky:

npx wrangler hyperdrive planetscale signature | \
  pscale database create <DATABASE_NAME> \
    --org <PLANETSCALE_ORG> \
    --engine postgresql \
    --cloudflare-billing @- \
    --format json

pscale database create je ve výchozím nastavení Vitess, proto předejte --engine postgresql pro databázi Postgres, a --format json se doporučuje, pokud výstup zpracovává agent.

Vaše přihlašovací údaje PlanetScale zůstávají jen mezi vámi a pscale. Wrangler autorizuje pouze fakturační stranu Cloudflare.

Podpis je kryptograficky podepsaný token, který autorizuje vytvoření databáze účtované na váš účet Cloudflare. Zacházejte s ním jako s přihlašovacím údajem a nesdílejte ho.

Viz dokumentace PlanetScale ↗ pro možnosti pscale database create podporuje.

S Workers vytvoříte aplikaci, kterou lze nasadit kdekoli v rámci globální sítě Cloudflare pokrývající více než 330 měst. Nasazení zvládnete jediným krokem a uživatelé v nových lokalitách se k vaší aplikaci dostanou bez nutnosti nasazovat regionální infrastrukturu.

Výpočetní výkon Workers běží blízko vašim uživatelům, což zajišťuje nízkou latenci. PlanetScale Postgres naproti tomu poskytuje regionální databáze pro control plane vaší aplikace nebo pro jakákoli centralizovaná data, která se nehodí k edge distribučnímu modelu Cloudflare. Využijte ji pro záznamy, jako jsou údaje o klientech, fakturace, nastavení účtu nebo jiná relační data.

Hyperdrive slouží jako spojovací článek mezi Workers a PlanetScale. Sdružuje databázová připojení do fondu a využívá Cache u způsobilých čtecích dotazů, aby vaše aplikace byla rychlá i v případě, že je vaše databáze centralizovaná.

1. Běží v blízkosti uživatele. Když uživatel odešle požadavek, Cloudflare jej směruje do nejbližší lokality. Váš Worker běží v této lokalitě, takže zpracování požadavku začíná blízko uživatele.

2. Zkontrolujte čtení uložená v lokální mezipaměti. Na stejném serveru Cloudflare, který zpracovává požadavek Workeru, Hyperdrive naváže připojení k vaší databázi v řádu jednotek milisekund (p90 4ms), takže váš databázový klient/ovladač může okamžitě odesílat dotazy. Navázání připojení v Hyperdrive provádí TCP ↗ navázání připojení, TLS ↗ šifrování a ověřování klienta na stejném lokálním počítači, čímž odpadají síťové round tripy a latence k vaší databázi. Jakmile je databázové připojení připravené a Worker odešle čtecí dotaz, jehož výsledek lze uložit do mezipaměti a je v ní uložen, Hyperdrive jej vrátí, aniž by opustil dané umístění.

3. Předávání dál jen v případě potřeby, s mezipamětí uprostřed. Pokud neexistuje žádný lokálně uložený výsledek nebo dotaz nelze ukládat do mezipaměti, Hyperdrive odešle dotaz přes síť Cloudflare do lokality co nejblíže vaší databázi PlanetScale. Hyperdrive v této lokalitě zkontroluje ještě jednu mezipaměť, než dotaz dorazí k databázi. Tuto mezipaměť naplňují opakované požadavky na vaši databázi, což zlepšuje poměr úspěšnosti mezipaměti obdobně jako u vrstveného ukládání do mezipaměti .

4. Dotazujte se na PlanetScale pouze v případě potřeby. Pokud výsledek nemá ani jedna z mezipamětí, Hyperdrive odešle dotaz do PlanetScale pomocí již dostupného poolu databázových připojení. Zápisy a další dotazy, které nelze ukládat do mezipaměti, směřují do PlanetScale, takže databáze zůstává zdrojem pravdy. Více vrstev ukládání do mezipaměti snižuje celkovou zátěž vaší databáze.

Hyperdrive neinvaliduje výsledky čtení uložené v mezipaměti, když vaše aplikace zapisuje do PlanetScale. Pokud vaše aplikace potřebuje konzistenci read-after-write pro ověřování, relace, oprávnění nebo jinou kritickou část, použijte pro tato čtení samostatnou konfiguraci Hyperdrive s vypnutou mezipamětí. Přečtěte si Ukládání dotazů do mezipaměti pro pokyny.

Zvolte PlanetScale Postgres nebo MySQL a dál používejte známé databázové ovladače, knihovny pro objektově-relační mapování (ORM) a nástroje SQL.

Provozujte produkční databáze na infrastruktuře PlanetScale s důrazem na výkon a spolehlivost, na nichž stojí důvěryhodné pracovní zátěže zákazníků ↗.

Použijte vývojové větve ↗ k otestování změn v databázi, přehledy o dotazech ↗ pro pochopení výkonu dotazů, a Server Model Context Protocol (MCP) ↗ k tomu, aby agenti získali přístup k přehledovým datům o databázi, a to vše bez nutnosti mít databázového administrátora (DBA).

Pokud vytvoříte databázi PlanetScale z Cloudflare dashboardu, je vám účtována přes váš účet Cloudflare: na faktuře od Cloudflare uvidíte samostatnou položku za využití PlanetScale. Ceny PlanetScale jsou stejné bez ohledu na to, zda databázi vytvoříte a používáte přes Cloudflare, nebo si ji zakoupíte přímo od PlanetScale. Podrobnosti o cenách najdete v ceník PlanetScale ↗. Využití fakturace jednotlivých databází můžete zjistit prostřednictvím PlanetScale dashboard ↗.