cloudflare-d1

Cloudflare D1 SQLite database with Workers, Drizzle ORM, migrations

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.