Prisma 基础

常用命令

1
2
3
4
5

npx prisma init           # 初始化 Prisma 项目
npx prisma migrate dev    # 应用并记录迁移
npx prisma generate       # 生成 prisma client
npx prisma studio         # 打开数据库可视化界面
npx prisma db seed        # 运行种子脚本

查询语法总结

查找

• include 包含关系

1
2
3
4

prisma.user.findMany({
  where: { isDeleted: false },
  include: { userOrg: { include: { org: true } } },
});

• select 精准提字段 不能与 include 联用

1
2
3
4
5
6
7
8
9
10
11

prisma.user.findMany({
  where: { isDeleted: false },
  select: {
    nickname: true,
    userOrg: {
      orgId:true
      org: { id: true }
    },
  },
  include:{} ❌
});

多对多（关联表）

• user.userOrg 连接 User 与 Org

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

model Org {
  ...
  userOrg UserOrg[] // 关联关系容器
}
model User {
  ...
  userOrg UserOrg[] // 关联关系容器
}
model UserOrg {
  id     String  @id @default(uuid())
  userId String
  user   User    @relation(fields: [userId], references: [id]) // 实体数据
  org    Org     @relation(fields: [orgId], references: [id]) // 实体数据
  orgId  String
}

• include 嵌套结构访问
• some “有一条数据满足” 就查出来对应的数据
• every 需要所有数据 “全部满足” 条件。才查出来
• none 不属于 none 条件

1
2
3
4
5
6
7

where: {
  userOrg: {
    some: {
      orgId: { in: ['org1', 'org2'] },
    },
  },
}

Prisma 进阶

分页查询

1
2
3
4
5

prisma.user.findMany({
  skip: (page - 1) * pageSize,
  take: pageSize,
  orderBy: { createAt: "desc" },
});

事务处理

• 多个操作打包执行，任一失败全部回滚

1
2
3
4
5
6
7
8
9

await prisma.$transaction([
  prisma.user.create({ data: { ... } }),
  prisma.userOrg.create({ data: { ... } }),
])
// 或
await prisma.$transaction(async (tx) => {
  await tx.user.update({ ... })
  await tx.userOrg.create({ ... })
})

聚合和分组

1
2
3
4

await prisma.user.groupBy({
  by: ["status"],
  _count: { _all: true },
});

Prisma 做不到或不推荐的情况

一、递归查询（如查找某个组织的所有子组织）

• 例子场景：有一个组织 Org 表，字段包括 id, parentId，想要查询某个组织的所有子组织（包括孙子组织、曾孙等）
• Prisma 的限制：Prisma 目前不支持递归查询（也不支持递归 CTE）。
• 小技巧：“如果数据量不多的情况下”，可以一次查出来所有数据，然后手写递归方法，将数据查出来

1
2
3
4
5
6
7

WITH RECURSIVE org_tree AS (
  SELECT * FROM org WHERE id = 'root-org-id'
  UNION ALL
  SELECT o.* FROM org o
  INNER JOIN org_tree ot ON o.parent_id = ot.id
)
SELECT * FROM org_tree;

二、复杂的子查询（如聚合后再过滤）

• 例子场景：查找至少加入过 3 个组织的用户。
• Prisma 的限制：Prisma 目前不支持子查询做过滤，比如 HAVING 子句和聚合后过滤的场景。

1
2
3
4

SELECT user_id
FROM user_org
GROUP BY user_id
HAVING COUNT(org_id) >= 3;

三、窗口函数（如查每个用户最新登录时间）

• 例子场景：你有一个 user_login_log 表，想获取每个用户最近的一次登录时间。

• user_id	login_time
  A	2024-01-01 10:00:00
  A	2024-01-02 08:00:00
  A	2024-01-03 09:00:00
  B	2024-01-01 09:00:00
  B	2024-01-03 11:00:00

• 结果

• user_id	login_time	login_order
  A	2024-01-01 10:00:00	1
  A	2024-01-02 08:00:00	2
  A	2024-01-03 09:00:00	3
  B	2024-01-01 09:00:00	1
  B	2024-01-03 11:00:00	2

• Prisma 的限制： Prisma 不支持窗口函数（如 ROW_NUMBER(), RANK(), OVER() 等）。

1
2
3
4
5
6

SELECT *
FROM (
  SELECT *, ROW_NUMBER() OVER (PARTITION BY user_id ORDER BY login_time DESC) as login_order
  FROM user_login_log
) t
WHERE rn = 1;

四、动态查询（字段名动态、IN 查询动态构造）

• 例子场景：用户传了字段名和字段值做筛选，比如 “email”、”phone” 等字段名是不固定的。
• Prisma 的限制：Prisma 的查询结构是静态类型定义，不允许你传字符串当作字段名。

1
2

SELECT * FROM "user"
WHERE "phone" = '1234567890'; -- phone是字符串,但是在sql中可以代表表名