prisma.md

Integrating Prisma with Mercurius

Prisma is an open-source ORM for Node.js and TypeScript. It can be used as an alternative to writing plain SQL, or using another database access tool such as SQL query builders (e.g. knex.js) or ORMs (like TypeORM and Sequelize). Prisma currently supports PostgreSQL, MySQL, SQL Server, MongoDB, CockroachDB, and SQLite.

You can easily combine Prisma and Mercurius to build your GraphQL server that connects to a database. Prisma is agnostic to the GraphQL tools you use when building your GraphQL server. Check out this GitHub repo for a ready-to-run example project with a PosgreSQL database.

Prisma can be used with plain JavaScript and it embraces TypeScript and provides a level to type-safety that goes beyond the guarantees other ORMs in the TypeScript ecosystem. You can find an in-depth comparison of Prisma against other ORMs here

Installation

Install Prisma CLI as a development dependency in your project:

npm install prisma --save-dev
npm install @prisma/client

Prisma Client is an auto-generated database client that allows you to interact with your database in a type-safe way.

Initialize Prisma in your project:

npx prisma init

This command does the following:

• Creates a new directory called prisma which contains a file called schema.prisma. This file defines your database connection and the Prisma Client generator.
• Creates a .env file at the root of your project. This defines your environment variables (used for your database connection).

Connect to your database

To connect to your database, set the url field of the datasource block in your Prisma schema to your database connection URL. By default, it's set to postgresql but this guide will use SQLite database. Adjust your datasource block to sqlite:

/// prisma/schema.prisma
datasource db {
  provider = "sqlite"
  url      = env("DATABASE_URL")
}

generator client {
  provider = "prisma-client-js"
}

Update the DATABASE_URL environment variable in the .env file:

# .env
DATABASE_URL="file:./dev.db"

If you wish to use a different database, you can jump to switching database providers.

Create database tables with Prisma Migrate

Add the following model to your prisma.schema file:

model Post {
  id        Int     @id @default(autoincrement())
  title     String
  body      String
  published Boolean
}

To map your data model to the database schema, you need to use prisma migrate CLI commands:

npx prisma migrate dev --name init

The above command does three things:

1. Creates a new SQL migration file for this migration
2. Creates the database if it does not exist
3. Runs the SQL migration against the database
4. Generates Prisma Client

Set up your GraphQL server

// index.js
'use strict'
const Fastify = require('fastify')
const mercurius = require('mercurius')
const { PrismaClient } = require('@prisma/client')

const app = Fastify()
const prisma = new PrismaClient()

const schema = `
type Mutation {
  createDraft(body: String!, title: String!): Post
  publish(draftId: Int!): Post
}

type Post {
  body: String
  id: Int
  published: Boolean
  title: String
}

type Query {
  drafts: [Post]
  posts: [Post]
}
`

const resolvers = {
  Query: {
    posts: async (_parent, args, ctx) => {
      return ctx.prisma.post.findMany({
        where: {
          published: true
        }
      })
    },
    drafts: async (_parent, args, ctx) => {
      return ctx.prisma.post.findMany({
        where: {
          published: false
        }
      })
    },
  },
  Mutation: {
    createDraft: async (_parent, args, ctx) => {
      return ctx.prisma.post.create({
        data: {
          title: args.title,
          body: args.body,
        }
      })
    },
    publish: async (_parent, args, ctx) => {
      return ctx.prisma.post.update({
        where: { id: args.draftId },
        data: { published: true }
      })
    },
  }
}

app.register(mercurius, {
  schema,
  resolvers,
  context: (request, reply) => {
    return { prisma }
  },
  graphiql: true
})

app.listen({ port: 3000 })
  .then(() => console.log(`🚀 Server ready at http://localhost:3000/graphiql`))

Start your application:

node index.js

Switching database providers

If you want to switch to a different database other than SQLite, you can adjust the database connection in prisma/prisma.schema by reconfiguring the datasource block.

Learn more about the different connection configurations in the docs.

Here's an overview of an example configuration with different databases:

PostgreSQL

Here is an example connection string with a local PostgreSQL database:

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

MySQL

Here is an example connection string with a local MySQL database:

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

SQL Server

Here is an example connection string with a local Microsoft SQL Server database:

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

CockroachDB

Here is an example connection string with a local CockroachDB database:

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

MongoDB

Here is an example connection string with a local MongoDB database:

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