cloudflare-d1

Cloudflare D1 to serverless SQLite rozprowadzony globalnie, zoptymalizowany do pracy z Workers. Umożliwia ci projektowanie baz danych dla skali horyzontalnej (wiele małych baz zamiast jednej dużej). Skill integruje D1 z Drizzle ORM do bezpiecznych typów i migracji, Wrangler CLI do zarządzania, oraz opcjonalnie Hono do budowy API. Idealne dla aplikacji edge-first, gdzie potrzebujesz prostej relacyjnej bazy bez infrastruktury.

1. Utwórz nowy projekt Worker z TypeScript: uruchom npm create cloudflare@latest my-app -- --template "worker-typescript", przejdź do katalogu i zainstaluj zależności: npm install drizzle-orm oraz npm install -D drizzle-kit.
2. Stwórz bazę D1 poleceniem npx wrangler d1 create my-database. Wrangler wygeneruje lokalną i zdalną bazę, wyświetli database_id – skopiuj go do następnego kroku.
3. Skonfiguruj wrangler.toml: dodaj sekcję [[d1_databases]] z binding = "DB", database_name = "my-database", database_id z poprzedniego kroku, oraz migrations_dir = "drizzle" i migrations_table = "drizzle_migrations".
4. Zdefiniuj schemat bazy w Drizzle – utwórz plik w katalogu drizzle/ z tabelami TypeScript, np. schema.ts. Drizzle Kit automatycznie wygeneruje migracje SQL.
5. Uruchom migracje lokalnie: npx drizzle-kit push:sqlite lub npx wrangler d1 execute my-database --local < migration.sql dla każdej migracji.
6. W pliku src/index.ts (lub innym handleru Workers) importuj Drizzle client, połącz się z DB (binding z wrangler.toml), i wykonuj zapytania – Drizzle zapewnia type-safe API dla wszystkich operacji SELECT, INSERT, UPDATE, DELETE.