Tutorial: Integración con Prisma

Verificar los prerrequisitos

Antes de comenzar este tutorial, asegúrese de tener los siguientes componentes preparados:

• Una cuenta de MongoDB Atlas con un clúster configurado. Para ver las instrucciones, consulte la guía de introducción a MongoDB.

• Node.js 1620v..1 o posterior.

Descargar la aplicación de ejemplo

Clone o descargue la aplicación de ejemplo del repositorio de ejemplos de Prisma.

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

Configura tu esquema Prisma

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

En el modelo User del mismo archivo, cambie el tipo de campo id de Int a String y establezca el valor predeterminado en auto(). La propiedad id debe asignarse al campo _id de MongoDB. También debe indicar a Prisma que establezca el tipo de dato de esta propiedad en ObjectId.

En el modelo Post, realice los mismos cambios en el campo id que en el modelo User. También debe cambiar el tipo de campo authorId de Int a String y establecer el tipo de dato en ObjectId.

Su 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 colecciones User y Post separadas en su base de datos MongoDB, donde cada Post contiene una referencia a un User.

Una vez que haya realizado estos cambios, navegue al directorio del proyecto en su terminal y ejecute los siguientes comandos para instalar las dependencias necesarias y generar el esquema:

npm install
npx prisma generate

Crear y rellenar la base de datos MongoDB

Para completar 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 llena con datos de muestra.

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

Navegue al 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) por postId. Esto es necesario porque los campos id del esquema ahora son de tipo String en lugar de Int.

Ejecutar la aplicación

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

npm run dev

Acceda a http://localhost:3000 en su navegador web para ver y ejecutar la aplicación. Puede usarla para crear, redactar, publicar y eliminar entradas de blog. Puede consultar las definiciones de ruta de la API en la carpeta pages/api del proyecto de ejemplo.