使用 Prisma & Apollo 实现简单、类型安全的数据库访问

使用 Prisma(适用于 JavaScript 和 TypeScript 的更佳 ORM)在 GraphQL 中查询来自 MySQL、PostgreSQL 和 SQL Server 数据库的数据。

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 模式

Prisma 模式 使用 Prisma 的建模语言来定义您的数据库模式。它使数据建模变得简单直观,尤其是在建模关系时。

您还可以使用我们的其他工具增强 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 模式时,您需要以字符串形式提供您的 GraphQL 模式定义以及实现此定义的解析器映射。在您的解析器内部,您可以使用 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 模式时,您需要以字符串形式提供您的 GraphQL 模式定义以及实现此定义的解析器映射。在您的解析器内部,您可以使用 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 -
DevRel 经理 of Apollo

为什么选择 Prisma 和 Apollo?

端到端类型安全

为您的应用程序获取一致的类型,从数据库到前端,以提高生产力并避免错误。

优化的数据库查询

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

类型安全的数据库客户端

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

直观的数据建模

Prisma 的建模语言灵感来自 GraphQL SDL,让您可以直观地描述您的数据库模式。

轻松的数据库迁移

将您的 Prisma 模式映射到数据库,这样您就不需要编写 SQL 来管理您的数据库模式。

筛选器、分页和排序

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

精选 Prisma 和 Apollo 示例

如何构建和部署 GraphQL API

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

SDL 优先入门套件

一个即用型示例项目,带有 SDL 优先模式和 SQLite 数据库

Nexus 入门套件

一个即用型示例项目,带有 Nexus(代码优先)和 SQLite 数据库