使用 Prisma & Apollo轻松实现类型安全的数据库访问

使用 Prisma 在 GraphQL 中查询 MySQL、PostgreSQL & SQL Server 数据库 – 一款更好的 JavaScript 和 TypeScript ORM。

tech

什么是 Prisma?

Prisma 让数据操作变得简单!它提供类型安全的 Node.js & TypeScript ORM、全局数据库缓存、连接池以及实时数据库事件。

查询
// Creating a new record
await prisma.user.create({
firstName: “Alice”,
email: “alice@prisma.io”
})
id firstName email
1 Bobby bobby@tables.io
2 Nilufar nilu@email.com
3 Jürgen jums@dums.edu
4 Alice alice@prisma.io

Prisma 和 Apollo 如何协同工作

Apollo 提供了一个构建 GraphQL 应用程序的强大生态系统。当使用 Apollo Server 构建连接数据库的 GraphQL API 时,你需要在 GraphQL 解析器内部发送数据库查询 – 这就是 Prisma 的作用所在。

Prisma 是一个 ORM,用于 Apollo Server 的 GraphQL 解析器内部,以便查询数据库。 它能与 GraphQL 生态系统中你最喜欢的工具和库完美配合。了解更多关于 Prisma 与 GraphQL 的信息。

Prisma Schema

The Prisma Schema 使用 Prisma 的建模语言来定义你的 数据库 Schema。它使数据建模变得简单直观,尤其是在建模 关系 方面。

你还可以通过我们的附加工具来增强 Prisma ORM 的使用
Prisma Accelerate 是一个全局数据库缓存和可伸缩连接池,可以加快你的数据库查询速度。
Prisma Pulse 使你能够以类型安全的方式构建响应式实时应用程序。Pulse 是实现 GraphQL 订阅或实时查询的完美伴侣。

1// Define the `User` table in the database
2model User {
3 id String @id @default(cuid())
4 email String @unique
5 password String
6 name String?
7 posts Post[]
8}
9
10// Define the `Post` table in the database
11model Post {
12 id String @id @default(cuid())
13 title String
14 content String?
15 authorId String
16 author User
17}

Prisma 和 Apollo 的用例

Prisma 可用于 Apollo Server 的 GraphQL 解析器中,通过读取和写入数据库中的数据来实现 GraphQL 查询和变更。

它兼容 Apollo 原生的 SDL-优先方法或由 Nexus 或 TypeGraphQL 等库提供的代码优先方法。

Apollo Server (SDL-优先)

Apollo Server — SDL-优先

当使用 Apollo 原生的 SDL-优先方法构建 GraphQL Schema 时,你需要提供你的 GraphQL Schema 定义 作为字符串,以及实现该定义的 解析器映射。在解析器内部,你可以使用 Prisma Client 来读取和写入数据库中的数据,以便解析传入的 GraphQL 查询和变更。

1import { PrismaClient } from '@prisma/client';
2import { ApolloServer } from 'apollo-server'
3
4const prisma = new PrismaClient();
5
6const typeDefs = `
7 type User {
8 email: String!
9 name: String
10 }
11
12 type Query {
13 allUsers: [User!]!
14 }
15`;
16
17const resolvers = {
18 Query: {
19 allUsers: () => {
20 return prisma.user.findMany();
21 }
22 }
23};
24
25const server = new ApolloServer({ resolvers, typeDefs });
26server.listen({ port: 4000 });
Nexus (代码优先)
TypeGraphQL (代码优先)

Apollo Server — SDL-优先

当使用 Apollo 原生的 SDL-优先方法构建 GraphQL Schema 时,你需要提供你的 GraphQL Schema 定义 作为字符串,以及实现该定义的 解析器映射。在解析器内部,你可以使用 Prisma Client 来读取和写入数据库中的数据,以便解析传入的 GraphQL 查询和变更。

1import { PrismaClient } from '@prisma/client';
2import { ApolloServer } from 'apollo-server'
3
4const prisma = new PrismaClient();
5
6const typeDefs = `
7 type User {
8 email: String!
9 name: String
10 }
11
12 type Query {
13 allUsers: [User!]!
14 }
15`;
16
17const resolvers = {
18 Query: {
19 allUsers: () => {
20 return prisma.user.findMany();
21 }
22 }
23};
24
25const server = new ApolloServer({ resolvers, typeDefs });
26server.listen({ port: 4000 });

“Prisma 为定义数据库提供了出色的建模语言,以及用于在 JavaScript & TypeScript 中处理 SQL 的强大 ORM。它是 Apollo Server 的完美搭配,让使用数据库构建 GraphQL API 变得令人愉快。”

Kurt Kemple Kurt Kemple -
开发者关系经理 来自 Apollo

为什么选择 Prisma 和 Apollo?

端到端类型安全

为你的应用程序获得一致的类型定义,从数据库到前端,从而提高生产力并避免错误。

优化的数据库查询

Prisma 内置的数据加载器确保优化的、高性能的数据库查询,即使是 N+1 查询也是如此。

类型安全的数据库客户端

Prisma Client 确保完全类型安全的数据库查询,并带来诸如自动补全等优势 – 即使在 JavaScript 中也是如此。

直观的数据建模

Prisma 的建模语言受 GraphQL SDL 启发,让你能够直观地描述数据库 Schema。

轻松的数据库迁移

将你的 Prisma Schema 映射到数据库,这样你就无需编写 SQL 来管理你的数据库 Schema。

过滤、分页 & 排序

Prisma Client 通过为常见的数据库功能提供便捷的 API 来减少样板代码。

精选的 Prisma & Apollo 示例

如何构建和部署 GraphQL API

一个全面的教程,解释如何使用 Apollo Server 和 Prisma 构建 GraphQL API,并将其部署到 DigitalOcean 的 App Platform。

SDL-优先入门工具包

一个包含 SDL-优先 Schema 和 SQLite 数据库的即用型示例项目

Nexus 入门工具包

一个包含 Nexus (代码优先) 和 SQLite 数据库的即用型示例项目