本文旨在详细介绍 ORM（Object Relational Mapping）技术及其使用方法，特别是 Prisma 库在 Node.js 环境下的应用。

1. ORM 介绍

ORM（对象关系映射）是一种技术，它使得开发者可以通过操作对象的方式来操作数据库。通过 ORM，SQL 查询语句可以被替换成编程语言中的对象操作。例如：

SELECT * FROM users WHERE name = 'yayu';

可以用 JavaScript 中的 ORM 库（假设使用虚构的 orm-library）来改写为：

var orm = require('orm-library');
var user = orm("users").where({ name: 'yayu' });

ORM 的优点在于，它允许开发者使用熟悉的编程语言操作数据库，并能方便地更换数据库（例如从 PostgreSQL 切换到 MySQL）。

2. Prisma 介绍

Prisma 是下一代的 Node.js 和 TypeScript ORM，其主要优点包括直观的数据模型、自动化迁移、类型安全和自动补全。通过定义数据模型文件（schema.prisma），开发者可以轻松地与数据库进行交互。

2.1. 安装与初始化

在项目根目录安装 Prisma 作为开发依赖：

npm install prisma --save-dev
npx prisma init

这一步会创建一个 prisma 文件夹，其中包含 schema.prisma 文件，用于定义数据模型，以及 .env 文件，用于定义环境变量（如数据库地址）。

2.2. 连接 MySQL 数据库

在 prisma/schema.prisma 文件中定义数据库连接：

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

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

在 .env 文件中配置数据库地址：

DATABASE_URL="mysql://root:admin@localhost:3306/notes"

创建数据库：

mysql -u root -p
CREATE DATABASE notes;

运行 npx prisma db pull 连接数据库。

2.3. 定义数据模型

在 prisma/schema.prisma 文件中定义数据模型：

model User {
  id       String @id @default(uuid())
  username String
  password String
  notes    Note[]
}

model Note {
  id        String   @id @default(cuid())
  title     String   @db.VarChar(255)
  content   String?
  createdAt DateTime @default(now())
  updatedAt DateTime @updatedAt
  author    User     @relation(fields: [authorId], references: [id])
  authorId  String
}

运行 npx prisma migrate dev 同步数据库。

2.4. 使用 Prisma Client

安装 Prisma Client：

npm install @prisma/client

在项目中使用 Prisma Client 进行数据库操作：

import { PrismaClient } from '@prisma/client'

const prisma = new PrismaClient()

// 创建用户

const user = await prisma.user.create({

  data: {

    username: 'alice',

    password: 'password123'

  }

})

// 查询用户

const users = await prisma.user.findMany()

3. 高级功能

3.1. Prisma Migrate

Prisma 提供了 Prisma Migrate 工具，用于管理数据库迁移。通过 schema.prisma 文件定义数据模型后，可以运行以下命令进行迁移：

npx prisma migrate dev

3.2. Prisma Studio

Prisma Studio 是一个用于查看和编辑数据库数据的 GUI 工具。运行以下命令启动 Prisma Studio：

npx prisma studio

3.3. 数据模型定义

Prisma 的数据模型定义包括字段名称、字段类型、类型修饰符和属性。例如：

model Post {

  id  Int @id @default(autoincrement())

  title String

}

4. 关系建立

Prisma 支持多种关系类型（如一对多、一对一和多对多），通过 @relation 属性定义。例如：

model User {

  id       String @id @default(uuid())

  username String

  password String

  notes    Note[]

}

model Note {

  id        String   @id @default(cuid())

  title     String

  content   String?

  createdAt DateTime @default(now())

  updatedAt DateTime @updatedAt

  author    User     @relation(fields: [authorId], references: [id])

  authorId  String

}

5. 常用操作

5.1. 创建记录

const user = await prisma.user.create({

  data: {

    username: 'alice',

    password: 'password123',

    notes: {

      create: [

        { title: 'First Note', content: 'This is my first note.' },

        { title: 'Second Note', content: 'This is my second note.' }

      ]

    }

  }

})

5.2. 查询记录

const users = await prisma.user.findMany({

  include: {

    notes: true

  }

})

5.3. 更新记录

const updatedUser = await prisma.user.update({

  where: { id: 'user_id' },

  data: { password: 'newpassword123' }

})

5.4. 删除记录

const deletedUser = await prisma.user.delete({

  where: { id: 'user_id' }

})

6. Prisma CLI

常用命令包括：

npx prisma --help          # 查看所有命令

npx prisma init            # 初始化 Prisma

npx prisma generate        # 生成 Prisma Client

npx prisma studio          # 启动 Prisma Studio

npx prisma migrate dev     # 迁移数据库

npx prisma db pull         # 同步数据库到数据模型

npx prisma db push         # 同步数据模型到数据库

总结

Prisma 是一款强大的 ORM 工具，提供了便捷的数据模型定义、自动化迁移和直观的开发体验。在 Node.js 项目中，Prisma 是一个常见的技术选型，适合初学者和经验丰富的开发者。通过本文的介绍，希望你能更好地理解和使用 Prisma。

数据库ORM简明教程，prisma中文教程