Back to Prisma

Prisma driver adapter for Neon serverless driver

packages/adapter-neon/README.md

7.9.0-dev.42.3 KB
Original Source

Prisma driver adapter for Neon serverless driver

Prisma driver adapter for Neon Serverless Driver. Refer to the announcement blog post and our docs for more details.

Note:: Support for Neon's serverless driver is available from Prisma versions 5.4.2 and later.

The Neon serverless driver is a low-latency Postgres driver for JavaScript and TypeScript that allows you to query data from serverless and edge environments.

Getting started

Note: Make sure your connection string exists in your process.env. Refer to Neon's docs to learn how to retrieve your database's connection string.

bash
DATABASE_URL="postgres://user:[email protected]/neondb"

To get started, install the Prisma adapter for Neon's serverless driver and ws packages:

sh
npm install @prisma/adapter-neon
npm install ws

Update your Prisma Client instance to use the Neon serverless driver using a WebSocket connection:

ts
// Import needed packages
import { neonConfig } from '@neondatabase/serverless'
import { PrismaNeon } from '@prisma/adapter-neon'
import { PrismaClient } from '@prisma/client'
import ws from 'ws'

// Setup
neonConfig.webSocketConstructor = ws
const connectionString = `${process.env.DATABASE_URL}`

// Init prisma client
const adapter = new PrismaNeon({ connectionString })
const prisma = new PrismaClient({ adapter })

// Use Prisma Client as normal

You can now use Prisma Client as you normally would with full type-safety. Your Prisma Client instance now uses Neon's serverless driver to connect to your database. This comes with benefits such as WebSocket connections and message pipelining.

Feedback

We encourage you to create an issue if you find something missing or run into a bug.

If you have any feedback, leave a comment in this GitHub discussion.