Tutorial: Integrate with Prisma教程：与Prisma集成

Verify the prerequisites验证先决条件

Before you begin this tutorial, ensure you have the following components prepared:在开始本教程之前，请确保您已准备好以下组件：

• A MongoDB Atlas account with a configured cluster. To view instructions, see the MongoDB Get Started guide.一个配置了集群的MongoDB Atlas帐户。要查看说明，请参阅MongoDB入门指南。
• Node.js v16.20.1 or later.v16.20.1或更高版本。

Download the example application下载示例应用程序

Clone or download the example application from the Prisma examples repository.从Prisma示例存储库克隆或下载示例应用程序。

This example is a simple blog content management platform that uses a SQLite database. The following steps modify the application to use MongoDB instead of SQLite.这个例子是一个使用SQLite数据库的简单博客内容管理平台。以下步骤修改应用程序以使用MongoDB而不是SQLite。

Configure your Prisma schema配置Prisma架构

Navigate to the prisma/schema.prisma file in the example application directory. In the datasource db object of this file, set the provider field to "mongodb" and the url field to your Atlas connection URI.导航到示例应用程序目录中的prisma/schema.prisma文件。在该文件的datasource db对象中，将provider字段设置为"mongodb"，将url字段设置为Atlas连接URI。

In the User model in the same file, change the id field type from Int to String and set the default value to auto(). 在同一文件的User模型中，将id字段类型从Int更改为String，并将默认值设置为auto()。The id property must map to the MongoDB _id field. You must also instruct Prisma to set the data type for this property to ObjectId.id属性必须映射到MongoDB _id字段。您还必须指示Prisma将此属性的数据类型设置为ObjectId。

In the Post model, perform the same changes to the id field as you did in the User model. You must also change the authorId field type from Int to String and set the data type to ObjectId.在Post模型中，对id字段执行与在User模型中相同的更改。您还必须将authorId字段类型从Int更改为String，并将数据类型设置为ObjectId。

Your schema.prisma file should resemble the following:您的schema.prisma文件应类似于以下内容：

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

datasource db {
  provider = "mongodb"
  url      = "<your connection URI>"
}

model Post {
  id        String   @id @default(auto()) @map("_id") @db.ObjectId
  createdAt DateTime @default(now())
  updatedAt DateTime @updatedAt
  title     String
  content   String?
  published Boolean  @default(false)
  viewCount Int      @default(0)
  author    User     @relation(fields: [authorId], references: [id])
  authorId  String   @db.ObjectId
}

model User {
  id    String  @id @default(auto()) @map("_id") @db.ObjectId
  email String  @unique
  name  String?
  posts Post[]
}

This schema defines separate User and Post collections in your MongoDB database, where each Post contains a reference to a User.此模式在MongoDB数据库中定义了单独的User和Post集合，其中每个Post都包含对User的引用。

Once you have made these changes, navigate to the project directory in your terminal and run the following commands to install the necessary dependencies and generate the schema:完成这些更改后，导航到终端中的项目目录，并运行以下命令以安装必要的依赖关系并生成模式：

npm install
npx prisma generate

Create and populate the MongoDB database创建并填充MongoDB数据库

To populate the database with sample data, run the prisma/seed.ts file in the example project by running the following command:要用示例数据填充数据库，请通过运行以下命令在示例项目中运行prisma/seed.ts文件：

npx prisma db seed

This creates the User and Post collections as defined by the schema.prisma file and populates them with sample data.这将创建schema.prisma文件定义的User和Post集合，并用示例数据填充它们。

Make the example application compatible with MongoDB使示例应用程序与MongoDB兼容

Navigate to the src directory of the example project. In the pages/api/post/[id].ts and pages/api/publish/[id].ts files, replace all instances of Number(postId) with postId. 导航到示例项目的src目录。在pages/api/post/[id].ts和pages/api/publish/[id].ts文件中，将Number(postId)的所有实例替换为postId。This is necessary because the id fields in the schema are now of type String instead of Int.这是必要的，因为模式中的id字段现在的类型是String而不是Int。

Run the application运行应用程序

To start the application, run the following command from the project directory:要启动应用程序，请从项目目录运行以下命令：

npm run dev

Navigate to http://localhost:3000 in your web browser to view and run the application. You can use the application to create, draft, publish, and delete blog posts. 导航到http://localhost:3000在您的网络浏览器中查看和运行应用程序。您可以使用该应用程序创建、起草、发布和删除博客文章。You can reference the API route definitions in the pages/api folder of the example project.您可以引用示例项目的pages/api文件夹中的API路由定义。