INTEGRITY Dokumentace

← Hyperdrive (Postgres & MySQL) / hyperdrive / examples / connect-to-postgres / postgres-drivers-and-libraries

Prisma ORM

Prisma ORM ↗ je ORM pro Node.js a TypeScript zaměřený na typovou bezpečnost a komfort vývojářů. Tento příklad ukazuje, jak použít Prisma ORM s PostgreSQL prostřednictvím Cloudflare Hyperdrive v aplikaci Workers.

Předpoklady

1. Nainstalujte Prisma ORM

Nainstalujte Prisma CLI jako vývojovou závislost:

npm i -D prisma

Nainstalujte pg ovladač a adaptér ovladače Prisma pro použití s Hyperdrive:

npm i pg@>8.13.0 @prisma/adapter-pg

Pokud používáte TypeScript, nainstalujte balíček typů:

npm i -D @types/pg

Do konfiguračního souboru Wrangler přidejte požadované příznaky kompatibility s Node.js a binding Hyperdrive:

{
	// required for database drivers to function
	"compatibility_flags": [
		"nodejs_compat"
	],
	// Set this to today's date
	"compatibility_date": "2026-08-28",
	"hyperdrive": [
		{
			"binding": "HYPERDRIVE",
			"id": "<your-hyperdrive-id-here>"
		}
	]
}
compatibility_flags = [ "nodejs_compat" ]
# Set this to today's date
compatibility_date = "2026-08-28"

[[hyperdrive]]
binding = "HYPERDRIVE"
id = "<your-hyperdrive-id-here>"

2. Nakonfigurujte Prisma ORM

2.1. Inicializujte Prisma

Inicializujte Prisma ve své aplikaci:

npx prisma init

Tím se vytvoří prisma složku s schema.prisma soubor a .env .

2.2. Definujte schéma

Definujte schéma databáze v prisma/schema.prisma soubor:

prisma/schema.prisma
generator client {
  provider        = "prisma-client-js"
  previewFeatures = ["driverAdapters"]
}

datasource db {
  provider = "postgresql"
  url      = env("DATABASE_URL")
}

model User {
  id        Int      @id @default(autoincrement())
  name      String
  email     String   @unique
  createdAt DateTime @default(now())
}

2.3. Nastavte proměnné prostředí

Přidejte řetězec připojení k databázi do .env soubor vytvořený nástrojem Prisma:

.env
DATABASE_URL="postgres://user:password@host:port/database"

Přidejte pomocné skripty do svého souboru package.json:

package.json
"scripts": {
  "migrate": "npx prisma migrate dev",
  "generate": "npx prisma generate --no-engine",
  "studio": "npx prisma studio"
}

2.4. Vygenerujte Prisma Client

Vygenerujte klienta Prisma s podporou adaptéru ovladače:

npm run generate

2.5. Spusťte migrace

Vygenerujte a použijte schéma databáze:

npm run migrate

Až budete vyzváni, zadejte název migrace (například init).

3. Připojte Prisma ORM k Hyperdrive

Při použití Prisma ORM použijte svou konfiguraci Hyperdrive. Upravte svůj src/index.ts soubor:

src/index.ts
import { PrismaPg } from "@prisma/adapter-pg";
import { PrismaClient } from "@prisma/client";

export interface Env {
	HYPERDRIVE: Hyperdrive;
}

export default {
	async fetch(request, env, ctx): Promise<Response> {
		// Create Prisma client using driver adapter with Hyperdrive connection string
		const adapter = new PrismaPg({ connectionString: env.HYPERDRIVE.connectionString });
		const prisma = new PrismaClient({ adapter });

		// Sample query to create and fetch users
		const user = await prisma.user.create({
			data: {
				name: "John Doe",
				email: `john.doe.${Date.now()}@example.com`,
			},
		});

		const allUsers = await prisma.user.findMany();

		return Response.json({
			newUser: user,
			allUsers: allUsers,
		});
	},
} satisfies ExportedHandler<Env>;

4. Nasaďte svůj Worker

Nasaďte svůj Worker:

npx wrangler deploy

Další kroky