Tutorial: Integración con Prisma

Verifique los requisitos previos

Antes de empezar este tutorial, asegúrate de tener preparados los siguientes componentes:

• Una cuenta de MongoDB Atlas con un clúster configurado. Para ver las instrucciones, consulta la guía Primeros pasos con MongoDB.

• Node.js v16.20.1 o después.

Descarga la aplicación de ejemplo

Clona o descarga la aplicación de ejemplo del repositorio de ejemplos de Prisma.

Este ejemplo es una sencilla plataforma de gestión de contenidos para blogs que utiliza una base de datos SQLite. Los siguientes pasos modifican la aplicación para que utilice MongoDB en lugar de SQLite.

Configure tu esquema de Prisma

Navega al archivo prisma/schema.prisma en el directorio de la aplicación de ejemplo. En el objeto datasource db de este archivo, establece el campo provider en "mongodb" y el campo url en tu URI de conexión de Atlas.

En el modelo User en el mismo archivo, cambie el tipo de campo id de Int a String y establezca el valor por defecto en auto(). La propiedad id debe mapearse al campo _id de MongoDB. También debes instruir a Prisma para que establezca el tipo de datos para esta propiedad como ObjectId.

En el modelo Post, realiza los mismos cambios en el campo id que hiciste en el modelo User. Debes cambiar también el tipo de campo authorId de Int a String y establecer el tipo de datos en ObjectId.

Tu archivo schema.prisma debería parecerse al siguiente:

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[]
}

Este esquema define las colecciones User y Post por separado en tu base de datos MongoDB, donde cada Post contiene una referencia a un User.

Una vez que hayas realizado estos cambios, navega al directorio del proyecto en tu terminal y ejecuta los siguientes comandos para instalar las dependencias necesarias y generar el esquema:

npm install
npx prisma generate

Crear y poblar la base de datos MongoDB

Para poblar la base de datos con datos de muestra, ejecute el archivo prisma/seed.ts en el proyecto de ejemplo ejecutando el siguiente comando:

npx prisma db seed

Esto crea las colecciones User y Post según lo definido por el archivo schema.prisma y las rellena con datos de muestra.

Hacer que la aplicación de ejemplo sea compatible con MongoDB

Navegue hasta el directorio src del proyecto de ejemplo. En los archivos pages/api/post/[id].ts y pages/api/publish/[id].ts, reemplace todas las instancias de Number(postId) con postId. Esto es necesario porque los campos id en el esquema ahora son del tipo String en lugar de Int.

Ejecuta la aplicación

Para iniciar la aplicación, ejecuta el siguiente comando desde el directorio del proyecto:

npm run dev

Navega a http://localhost:3000 en tu navegador web para ver y ejecutar la aplicación. Puedes usar la aplicación para crear, redactar, publicar y borrar entradas de blog. Puedes consultar las definiciones de rutas de API en la carpeta pages/api del proyecto de ejemplo.