Contenido del curso
Prisma ORM con PostgreSQL en Node.js
Conectar Prisma ORM con PostgreSQL te permite administrar tu base de datos desde una aplicación Node.js de forma programática, segura y escalable. Aquí aprendes a instalar Prisma, configurar el esquema, ejecutar migraciones y listar usuarios desde una API en Express.
Qué es Prisma y por qué usarlo con PostgreSQL
Prisma es un ORM (Object Relational Mapper) que traduce tu código JavaScript en consultas SQL. En lugar de escribir queries a mano, defines modelos en un archivo de esquema y Prisma se encarga del resto: conexión, validación de tipos y migraciones.
La idea es simple: tú describes cómo se ve un usuario en tu app y Prisma sincroniza esa estructura con tu base de datos PostgreSQL.
¿Qué es un ORM? Es una capa que conecta tu aplicación con la base de datos usando objetos en vez de SQL puro. Te ahorra escribir queries y reduce errores de sintaxis.
Qué paquetes necesito instalar para usar Prisma
Desde la terminal del proyecto, instala las dependencias en este orden [01:30]:
npm install prisma --save-dev para el CLI de Prisma como dependencia de desarrollo.npm install @prisma/client para el cliente que usarás dentro del código.npm install pg como driver oficial de PostgreSQL.Con estos tres paquetes ya tienes lo necesario para inicializar el proyecto.
Cómo inicializar Prisma en un proyecto Node.js
Ejecuta el comando npx prisma init [02:30]. Esto crea dos cosas clave: la carpeta prisma con el archivo schema.prisma y un archivo .env donde vivirá tu cadena de conexión.
El archivo schema.prisma es el corazón de tu configuración. Ahí defines el datasource (qué base de datos usas), el generator (qué cliente generar) y los models (la forma de tus tablas).
Un tip práctico: instala la extensión oficial de Prisma en tu editor. Te da resaltado de sintaxis y autocompletado, lo que vuelve mucho más legible el archivo de esquema.
Cómo defino el modelo de usuario en schema.prisma
El modelo de usuario sigue una estructura programática donde cada campo tiene un tipo explícito:
id como entero autoincremental y llave primaria.name como string obligatorio.email como string único para evitar duplicados.Este enfoque previene fallas comunes que aparecían cuando escribías SQL a mano, como permitir emails repetidos o tipos inconsistentes.
Cómo configuro la cadena de conexión a PostgreSQL
En el archivo .env actualiza la variable DATABASE_URL con tus credenciales reales [04:50]. La estructura es:
postgresql://USUARIO:PASSWORD@localhost:5432/postgres
Reemplaza USUARIO por el usuario que creaste en Postgres, PASSWORD por tu contraseña, y deja localhost:5432 si trabajas en local. El 5432 es el puerto por defecto de PostgreSQL.
Más adelante, cuando muevas la app a producción, solo cambias este string por uno que apunte a una base de datos en la nube.
Cómo genero el cliente de Prisma y ejecuto migraciones
Después de definir el modelo, corre npx prisma generate [04:00]. Este comando crea el cliente tipado que vas a importar en tu código.
Luego ejecuta la migración inicial con npx prisma migrate dev --name init [08:30]. Aquí pasan dos cosas importantes:
schema.prisma y genera archivos SQL dentro de prisma/migrations.¿Qué hace prisma migrate dev? Sincroniza tu esquema con la base de datos y guarda un historial de cambios versionados. Lo usas en desarrollo para iterar rápido.
Cómo conecto Prisma Client con Express
En tu archivo app.js importas el cliente y creas una instancia única:
js const { PrismaClient } = require('@prisma/client'); const prisma = new PrismaClient();
Esta instancia ya sabe leer la DATABASE_URL desde tus variables de entorno automáticamente, sin configuración extra.
Cómo listo usuarios desde la base de datos con Prisma
Ahora creas un endpoint GET /db-users que consulte la tabla. Como las operaciones de base de datos son asíncronas, la función debe ser async y usar try/catch para manejar errores [07:00]:
js app.get('/db-users', async (req, res) => { try { const users = await prisma.user.findMany(); res.json(users); } catch (error) { res.status(500).json({ error: 'Error al comunicarse con la base de datos' }); } });
El método findMany() trae todos los registros de la tabla user. Prisma expone también findUnique, create, update y delete, cubriendo el CRUD completo.
Por qué uso async await y try catch en este endpoint
La consulta a Postgres tarda milisegundos pero no es instantánea. Sin await, tu respuesta saldría antes de tener los datos. Y sin try/catch, cualquier fallo de conexión rompería el servidor entero.
El status 500 indica un error del lado del servidor, lo que ayuda al frontend a distinguir entre un problema de red y una respuesta válida vacía.
Cómo verifico que la conexión funciona correctamente
Levanta el servidor con npm run dev y visita http://localhost:PUERTO/db-users en el navegador [10:00]. Si ves un array vacío [], la conexión funciona pero aún no hay registros.
Si vieras el mensaje de error, revisa tres cosas:
DATABASE_URL con usuario y contraseña correctos.El siguiente paso natural es insertar usuarios usando prisma.user.create(). ¿Cómo crees que estructurarías ese endpoint? Cuéntame en los comentarios qué campos validarías antes de guardar.
Error: @prisma/client did not initialize yet. Please run "prisma generate" and try to import it again. ```En caso de que reciban un error al importar la dependencia '@prisma/client', como el que les comparto pueden probar tomando de referencia la documentación de Prisma e importarlo desde la carpeta './generated/prisma'.require('dotenv').config();const express = require('express');const { PrismaClient } = require('./generated/prisma');const prisma = new PrismaClient(); ```js require('dotenv').config(); const express = require('express'); const { PrismaClient } = require('./generated/prisma'); const prisma = new PrismaClient(); ```Me funcionó en Windows 11
También me pasó, gracias por compartir
Muchas gracias por compartir, no lograba hacerlo.
cambiar esta linea...si te sale error al intentar npm run dev
const { PrismaClient } = require('./generated/prisma');
efectivamente hay que cambiar esa linea con base en el output que se tenga en el archivo prisma/schema.prisma.
generator client {
provider = "prisma-client-js"
output = "../generated/prisma"
}
La configuración por defecto de Prisma está desañada para TypeScript. Como ha dicho Heider hay que configurar el provider = "prisma-client-js" en el fichero 'prisma/schema.prisma'.
Al ejecutar el comando npx prisma generate, lo generará para JavaScript en lugar de TypeScript. Para hacerlo funcionar yo tuve que añadir lo siguiente a la configuración:
npm i @prisma/adapter-pg Instalar el adaptador de prisma para postgreSQL.
const { PrismaPg } = require('@prisma/adapter-pg'); const { PrismaClient } = require('./generated/prisma'); const connectionString = `${process.env.DATABASE_URL}`; const adapter = new PrismaPg({ connectionString }); const prisma = new PrismaClient({ adapter });
el curso esta lleno de muchos "ah y por cierto debemos de", en lo personal, me parece que le falta orden y profundidad, se siente más como una práctica rápida para aquellos que ya tienen conocimiento más que un curso de aprendizaje.
He visto que varios han tenido problemas con Prisma 7 y si, yo también estuve igual, pero después de investigar un rato logré entender como funciona: Lo primero es que Prisma 7 trajo breaking changes, es decir, cambios importantes respecto a versiones anteriores, principalmente porque Prisma ha migrado su motor de Rust a TypeScript, lo que lo hace mucho más ligero y rápido pero un poco mas tedioso de configurar.
1. Instalación de dependencias
A diferencia de versiones anteriores, Prisma 7 recomienda el uso de Driver Adapters para una mejor integración con el ecosistema JS.
# Dependencias de desarrollo npm install prisma --save-dev # Dependencias del cliente y el adaptador para Postgres npm install @prisma/client @prisma/adapter-pg pg npm install @types/pg --save-dev
2. Inicialización del proyecto
Ejecuta el comando para crear la estructura base:
npx prisma init
Esto creará una carpeta prisma/ con el archivo schema.prisma y un archivo .env en la raíz.
3. Configuración del Esquema (schema.prisma)
En Prisma 7, el generador cambia ligeramente para aprovechar el nuevo motor. Edita prisma/schema.prisma:
generator client { provider = "prisma-client" // Nota: en Prisma 7 se prefiere "prisma-client" } datasource db { provider = "postgresql" url = env("DATABASE_URL") } // Ejemplo de un modelo básico model User { id Int @id @default(autoincrement()) email String @unique name String? }
4. Configuración de la base de datos (.env)
Configura tu cadena de conexión en el archivo .env:
DATABASE_URL="postgresql://USUARIO:PASSWORD@localhost:5432/NOMBRE_DB?schema=public"
5. Generar el Cliente y Migraciones
Aplica los cambios a tu base de datos y genera el cliente:
npx prisma migrate dev --name init npx prisma generate
6. Implementación en Express (Importación)
Dado que Prisma 7 utiliza el nuevo sistema de adaptadores, la forma recomendada de instanciarlo para evitar múltiples conexiones en desarrollo es mediante un Singleton.
import { PrismaClient } from '@prisma/client'; import { PrismaPg } from '@prisma/adapter-pg'; import pg from 'pg'; const pool = new pg.Pool({ connectionString: process.env.DATABASE_URL }); const adapter = new PrismaPg(pool); const prisma = new PrismaClient({ adapter }); export default prisma;
Es un poco mas tedioso instalar, configurar e instanciar todo así, pero heyy, trae ventajas como reducir el peso de node modules, las consultas son mucho mas rápidas, menos consumo de RAM en el servidor, etc.
Vaya, en mi caso, prisma me generó en mi archivo .env una url con una api key, y también me retornó un array vacío. ¿Acaso se creó una base de datos en la nube gratis?
A mi también, tuve que cambiarlo por
DATABASE_URL="postgresql://mi-usuario:contraseña@localhost:5432/pcbackexpress"
Yo no lo cambié, me pareció mucho mejor y más cómodo tener la BBDD en la nube. La UI es muy buena.
Para no tener problemas con el cliente de prisma
npm install express prisma@6.19.2 @prisma/client@6.19.2
Para añadir nuevos usuarios en una base de datos PostgreSQL utilizando Prisma, debes seguir los siguientes pasos:
schema.prisma.create de Prisma Client. Por ejemplo:const newUser = await prisma.user.create({ data: { name: "Nombre del Usuario", email: "email@ejemplo.com", }, });
Recuerda ejecutar el código dentro de una función asíncrona y manejar errores con un bloque try-catch.
Esto fue la solución de la IA que integra Platzi, y fue simplemente añadirla a un nuevo endpoint.
(Me quedó faltando la validación de la información que recibio)
app.post('/', async(req, res, next) =>{ try { const {name, email} = req.body; const newUser = await prisma.user.create({ data: { name, email, }, }); console.log(newUser) res.status(201).json(newUser) } catch (error) { next(new Error(error)) } })
Cuando se importa el PrismaClient ya sea en cada archivo o donde lo necesitemos, es importante saber que se puede saturar las conexiónes a la DB, es recomendable generar una sola instancia e importarla donde sea necesario.
Confirmen las rutas y si sn nuevas versiones validar con la documentación.
import { PrismaClient } from '@/src/generated/prisma/client'; import { PrismaPg } from '@prisma/adapter-pg'; import { Pool } from 'pg'; const globalForPrisma = global as unknown as { prisma: PrismaClient }; const connectionString = process.env.DATABASE_URL; const pool = new Pool({ connectionString }); const adapter = new PrismaPg(pool); export const prisma = globalForPrisma.prisma || new PrismaClient({ adapter: adapter, log: process.env.NODE_ENV === 'development' ? ['query', 'error', 'warn'] : ['error'], }); if (process.env.NODE_ENV !== 'production') globalForPrisma.prisma = prisma;
me sale este error si alguien puede ponerse en contacto conmigo para ayudarme.
Para los que tengan problemas con el cliente de prisma y el import del modulo.
En el schema.prisma debes quitar el output del generador del cliente:
Te debe quedar asi:
generator client {
provider = "prisma-client-js"
output = "../generated/prisma"
}
Vuelves a ejecutar npx prisma generate
Y en el require del PrismaClient ahora si usas '@prisma/client'.
Con respecto al video, puede que al iniciar prisma te venga con el schema de esa manera y al hace el prisma generate se genera el cliente en ese fichero y no en los node_modules. por lo tanto te toca referenciar ese fichero, pero si retiras el output, por defecto se generara en los node modules y ahora si podras usarlo con @prisma/client
Espero sea de ayuda!
hola team
a mi también me fallo como a todos con prisma version 7
mi solucion fue
npm install --save-dev prisma@6.19.2
npm install @prisma/client@6.19.2
npx prisma generate
el docker porque lo tengo con lo que mencionaron del otro curso
https://platzi.com/cursos/backend-nodejs-postgres/configuracion-de-postgres-en-docker/
docker-compose up -d
y pues iniciarla normalmente npm run dev
y ahi ya arranco bien
Hola!, asegúrense de preferencia instalar la versión 6 de prisma para no tener tantos problemas
Ojalá puedan actualizar esta clase 16. Nada de lo que está aquí funciona como se describe tanto en el video como en los recursos. El ORM de Prisma no corre con estas indicaciones.
Baja a la version 6 (es más estable) y con una fuerte discusion con gemini se arregla, así lo resolví
Para solucionar el error , de cuando se hace npm run dev al final
En app.js
const { PrismaClient } = require('./generated/prisma');
const prisma = new PrismaClient();
En schema.prisma
generator client {
provider = "prisma-client-js"
output = "../generated/prisma"
}
y al final volver a generar con:
npx prisma generate
Entonces, como podria hacer para conectar mi base de datos con un frontend
Corregir la URL de la ruta en la Sección de ¿Cómo probar la conexión a la base de datos? del Resumen.
La misma según la desarrollado previamente debe ser: http://localhost:3005/db-users
Saludos
Aquí un ejemplo sencillo para hacer POST de 1 user:
app.post('/db-users', async (req, res) => {
const { name, email } = req.body;
if (!name || !email) {
return res.status(400).json({ error: 'Name and email are required' });
}
if (name.length < 3) {
return res
.status(400)
.json({ error: 'Name must be at least 3 characters long' });
}
const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
if (!emailRegex.test(email)) {
return res.status(400).json({ error: 'Invalid email format' });
}
try {
const newUser = await prisma.user.create({
data: {
name,
email,
},
});
res
.status(201)
.json({ message: 'User created successfully', user: newUser });
} catch (error) {
if (error.code === 'P2002') {
return res.status(400).json({ error: 'Email already exists' });
}
res.status(500).json({ error: 'Error creating user in database' });
}
});
Si requieren nombrar las tablas de la base de datos en plural utilicen @@map([nombre_tabla]) al final de los campos del modelo:
model User { id Int @id @default(autoincrement()) name String email String @unique @@map("users") }