Prisma es un kit de herramientas (toolkit) de base de datos de código abierto. Reemplaza los ORM tradicionales y facilita el acceso a la base de datos con un generador de consultas o query builder automáticamente generado y type-safe que se adapta a nuestro esquema de base de datos.
Se compone principalmente de las siguientes partes:
- Prisma Client: generador de consultas, autogenerado y seguro para Node.js y TypeScript
- Prisma Migrate (experimental): sistema de migración y modelado de datos declarativos
- Prisma Studio (experimental): GUI para ver y editar datos en su base de datos
En este artículo veremos - mediante un ejemplo sencillo - cómo usar Prisma Client, la herramienta que nos permite interactuar con la base de datos desde nuestra aplicación de manera fácil y sencilla. Prisma Client proporciona una API intuitiva (auto-completado, validaciones de tipos, etc) y flexible para casos de uso comunes como paginación o filtrado y nos ahorra los boilerplates CRUD repetitivos.
1) Configurar Prisma
En éste ejemplo haremos un API REST sencilla con Express.js y TypeScript para una biblioteca con las operaciones CRUD para Libros, Autores y Reviews de los libros.
Prisma actualmente soporta PostgreSQL, MySQL y SQLite. Esta en desarrollo el soporte para otras BDs tanto SQL como NoSQL. Para éste ejemplo por razones de simplicidad estaremos usando SQLite. Puedes descargar el archivo para este ejemplo aquí.
Lo primero que haremos será crear un folder para nuestro proyecto, movernos dentro de éste e inicializar un proyecto de JavaScript:
$ mkdir prisma-example && cd prisma-example && npm init -y
Ahora instalaremos algunas dependencias:
$ npm i express morgan
$ npm i @prisma/cli typescript concurrently nodemon @types/express @types/morgan -D
Estamos instalando las dependencias de Express, TypeScript, sus definiciones de tipos correspondientes, y lo que nos interesa aquí es @prisma/cli: es la herramienta que nos permitirá autogenerar nuestro esquema de Prisma a partir de nuestro esquema de base de datos.
Creamos el archivo tsconfig.json para las opciones de TypeScript:
{
"compilerOptions": {
"sourceMap": true,
"outDir": "dist",
"strict": true,
"lib": ["esnext"],
"esModuleInterop": true
}
}
Y reemplazamos la parte de "scripts"
del archivo package.json
con lo siguiente:
{
//...
"scripts": {
"start": "concurrently \"tsc -w\" \"nodemon dist/index.js\""
}
//...
}
Hecho esto, podemos invocar a la CLI de Prisma mediante npx. Inicializamos Prisma con el sgte. comando:
$ npx prisma init
Éste comando creará una nueva carpeta llamada prisma
con los siguientes archivos:
- schema.prisma: El esquema de Prisma con la conexión a base de datos y el generador de Prisma Client
- .env: Archivo dotenv para definir variables de entorno (utilizado para la conexión a la base de datos)
Dentro de la carpeta prisma
, colocamos el archivo prisma_example.db
que descargamos anteriormente.
2) Conexión a la base de datos
Editamos el archivo schema.prisma
y reemplazamos el campo datasource
con lo siguiente:
datasource sqlite {
provider = "sqlite"
url = env("DATABASE_URL")
}
Y reemplazamos el contenido del archivo .env
con lo siguiente:
DATABASE_URL="file:./prisma_example.db"
La base de datos SQLite que hemos descargado tiene las sgtes 3 tablas ya creadas:
create table author(
id INTEGER PRIMARY KEY AUTOINCREMENT,
name VARCHAR(50),
surname VARCHAR(50),
age INTEGER
);
create table book(
id INTEGER PRIMARY KEY AUTOINCREMENT,
title VARCHAR(50),
page_count INTEGER,
published_date DATE,
genre VARCHAR(50),
author_id INTEGER,
CONSTRAINT fk_author
FOREIGN KEY (author_id)
REFERENCES author(id)
);
create table review(
id INTEGER PRIMARY KEY AUTOINCREMENT,
nickname VARCHAR(50),
content TEXT,
created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
book_id INTEGER,
CONSTRAINT fk_book
FOREIGN KEY (book_id)
REFERENCES book(id)
);
Como podemos ver, la tabla book
tiene una llave foránea a la tabla author
, y la tabla review
tiene una llave foránea a la tabla book
. Para obtener nuestro modelo de datos, usaremos la herramienta de análisis de Prisma, la cual lee nuestro esquema de base de datos y lo transforma en un modelo de datos de Prisma. Para ello, ejecutamos el siguiente comando:
$ npx prisma introspect
El comando anterior sobre escribe el archivo schema.prisma
, insertando el modelo de datos de Prisma obtenido durante el análisis de la base de datos:
generator client {
provider = "prisma-client-js"
}
datasource sqlite {
provider = "sqlite"
url = env("DATABASE_URL")
}
// LAS SIGUIENTES LINEAS FUERON AGREGADAS
model author {
age Int?
id Int @default(autoincrement()) @id
name String?
surname String?
book book[]
}
model book {
author_id Int?
genre String?
id Int @default(autoincrement()) @id
page_count Int?
published_date DateTime?
title String?
author author? @relation(fields: [author_id], references: [id])
review review[]
}
model review {
book_id Int?
content String?
created_at DateTime? @default(now())
id Int @default(autoincrement()) @id
nickname String?
book book? @relation(fields: [book_id], references: [id])
}
Éste modelo de datos es una representacion declarativa de nuestro esquema de base de datos, y será tomado por Prisma Client, el cual expondrá queries en TS/JS que estan adaptadas a éste modelo.
Adicionalmente, cambiaremos algunos nombres que están en singular y reprensentan conjuntos de datos para que tengan más sentido y sean mas entendibles al usar el cliente de Prisma en nuestra aplicación:
generator client {
provider = "prisma-client-js"
}
datasource sqlite {
provider = "sqlite"
url = env("DATABASE_URL")
}
model author {
age Int?
id Int @default(autoincrement()) @id
name String?
surname String?
// LA SIGUIENTE LINEA FUE CAMBIADA
books book[]
}
model book {
author_id Int?
genre String?
id Int @default(autoincrement()) @id
page_count Int?
published_date DateTime?
title String?
author author? @relation(fields: [author_id], references: [id])
// LA SIGUIENTE LINEA FUE CAMBIADA
reviews review[]
}
model review {
book_id Int?
content String?
created_at DateTime? @default(now())
id Int @default(autoincrement()) @id
nickname String?
book book? @relation(fields: [book_id], references: [id])
}
3) Generar Prisma Client para nuestro modelo de datos
Ahora que tenemos nuestro modelo de datos de Prisma, vamos a generar nuestro Prisma Client para poder usarlo en nuestra aplicación de Express. Para ello debemos instalar el modulo @prisma/client
$ npm i @prisma/client
y luego generamos nuestro cliente con el comando:
$ npx prisma generate
Genial!, ya tenemos nuestro Prisma Client listo para ser usado en nuesta aplicación. Recuerda que cada vez que agreguemos o modifiquemos alguna tabla en nuestra base de datos, debemos ejecutar nuevamente los siguientes comandos para actualizar nuestro modelo de datos de prisma asi como nuestro Prisma Client:
$ npx prisma instrospect
$ npx prisma generate
Ahora, pasemos a crear nuestra API REST con Express.
4) Crear el API REST con Express
Primero creamos una carpeta src
en la raiz de nuestro proyecto y dentro creamos un archivo index.ts
con el siguiente contenido:
// src/index.ts
import express, { Router } from 'express'
import morgan from 'morgan'
import {
getBooks, getBookById, createBook, deleteBookById, updateBookById,
getAuthors, getAuthorById, createAuthor, updateAuthor, deleteAuthorById,
createReview,
} from './controllers'
const app = express()
// middlewares
app.use(morgan('tiny'))
app.use(express.json())
app.use(express.urlencoded({ extended: false }))
const router = Router()
// Rutas para los libros
router.get('/books', getBooks)
router.get('/books/:id', getBookById)
router.post('/books', createBook)
router.patch('/books', updateBookById)
router.delete('/books/:id', deleteBookById)
// Rutas para los autores
router.get('/authors', getAuthors)
router.get('/authors/:id', getAuthorById)
router.post('/authors', createAuthor)
router.patch('/authors', updateAuthor)
router.delete('/authors/:id', deleteAuthorById)
// Rutas para reviews
router.post('/reviews', createReview)
// pasamos las rutas a nuestro servidor
app.use(router)
// levantamos nuestro servidor en el puerto 5000
app.listen(5000, () => console.log('Server on port 5000'))
Aquí simplemente estamos creando nuestro servidor y algunas rutas para nuestra API. Tambien creamos un archivo controllers.ts
con el siguiente contenido:
// src/controllers.ts
import { Request as Req, Response as Res } from 'express'
export const getBooks = (req: Req, res: Res) => {
res.send('Hola mundo!!')
}
export const getBookById = (req: Req, res: Res) => { }
export const createBook = (req: Req, res: Res) => { }
export const updateBookById = (req: Req, res: Res) => { }
export const deleteBookById = (req: Req, res: Res) => { }
export const getAuthors = (req: Req, res: Res) => { }
export const getAuthorById = (req: Req, res: Res) => { }
export const createAuthor = (req: Req, res: Res) => { }
export const updateAuthor = (req: Req, res: Res) => { }
export const deleteAuthorById = (req: Req, res: Res) => { }
export const createReview = (req: Req, res: Res) => { }
Una vez hecho ésto, ejecutamos el siguiente comando para levantar nuestro servidor local:
$ npm start
Ahora si llamamos a la ruta http://localhost:5000/books/
desde Postman o Insomina o Curl o algun otro cliente REST, veremos que nos responde el texto Hola Mundo!
5) Usando Prisma Client
Por fin llego el momento de ver a Prisma Client en acción! Comenzamos por importar e instanciar el módulo:
// src/controllers.js
import { PrismaClient } from "@prisma/client"
const prisma = new PrismaClient()
//...
Ahora en nuestra función getBooks
, hacemos una query al modelo book
y devolvemos el resultado :
// src/controllers.js
// ...
// Colocamos `async` porque utilizaremos código asíncrono
export const getBooks = async (req: Req, res: Res) => {
const books = await prisma.book.findMany()
console.table(books)
res.json({ books })
}
// ...
Aquí podemos ver cómo el autocompletado nos indica los modelos y los métodos que tenemos disponibles:
Volvemos a invocar la ruta http://localhost:5000/books/
y vemos el resultado de nuestra consulta, tanto en la consola como en nuestro cliente REST:
Actualmente tenemos unos cuantos libros en nuestra base de datos, pero no sabemos quien los escribió ☹️. Veamos los datos de los autores! para ello modificamos nuestra función de la siguente manera:
// src/controllers.js
// ...
export const getBooks = async (req: Req, res: Res) => {
const books = await prisma.book.findMany({
include: {
author: true
}
})
res.json({ books })
}
// ...
Una vez mas, vemos como el autocompletado nos ayuda muchísimo a saber lo que podemos solicitar 😎:
Invocamos a nuestra API y vemos ahora sí la información de los autores 🤓:
Podemos buscar también un libro específico por ID, para ello vamos a modificar nuestra función getBookById
de la siguiente manera:
// src/controllers.ts
// ...
export const getBookById = async (req: Req, res: Res) => {
// éste parametro viene de la ruta `/books/:id`
const bookId = Number(req.params.id);
const book = await prisma.book.findOne({
where: { id: bookId },
include: { author: true }
})
if (book)
res.json({ book })
else
res.status(404).json({ message: 'Book not found!' })
}
// ...
Invocamos la ruta http://localhost:5000/books/2
:
Y que pasaría si invocamos un libro que no existe?
Ahora creemos un libro 🤓. Modificamos nuestra función createBook
:
// src/controllers.ts
// ...
export const createBook = async (req: Req, res: Res) => {
const { title, author_id, genre, page_count, published_date } = req.body
const createdBook = await prisma.book.create({
data: {
title,
genre,
page_count,
published_date,
author: {
connect: {
id: author_id
}
}
},
include: { author: true }
})
res.status(201).json({ createdBook })
}
// ...
Aqui estamos extrayendo los valores del request y le estamos diciendo a prisma que cree un nuevo libro con ésta información, adicionalmente estamos indicando que el autor
va a hacer referencia a un elemento del modelo autor con dicho ID.
Finalmente implementaremos los metodos para actualizar y eliminar libros, y haremos lo propio para los modelos author
y review
. Nuestro archivo controllers.ts
debe quedar asi:
import { Request as Req, Response as Res } from 'express'
import { PrismaClient } from '@prisma/client'
const prisma = new PrismaClient()
export const getBooks = async (req: Req, res: Res) => {
const books = await prisma.book.findMany({
include: {
author: true,
reviews: {
select: {
nickname: true,
content: true,
created_at: true
}
}
}
})
res.json({ books })
}
export const getBookById = async (req: Req, res: Res) => {
const bookId = Number(req.params.id);
const book = await prisma.book.findOne({
where: { id: bookId },
include: { author: true }
})
if (book)
res.json({ book })
else
res.status(404).json({ message: 'Book not found!' })
}
export const createBook = async (req: Req, res: Res) => {
const { title, author_id, genre, page_count, published_date } = req.body
const createdBook = await prisma.book.create({
data: {
title,
genre,
page_count,
published_date,
author: {
connect: {
id: author_id
}
}
},
include: { author: true }
})
res.json({ createdBook })
}
export const updateBookById = async (req: Req, res: Res) => {
const bookId = Number(req.params.id)
const updatedBook = await prisma.book.update({
where: { id: bookId },
data: req.body,
include: { author: true }
})
res.json({ updatedBook })
}
export const deleteBookById = async (req: Req, res: Res) => {
const bookId = Number(req.params.id)
const deletedBook = await prisma.book.delete({
where: { id: bookId },
include: { author: true }
})
res.json({ deletedBook })
}
export const getAuthors = async (req: Req, res: Res) => {
const authors = await prisma.author.findMany({
include: {
books: {
select: {
title: true,
genre: true
}
}
}
})
res.json({ authors })
}
export const getAuthorById = async (req: Req, res: Res) => {
const authorId = Number(req.params.id);
const author = await prisma.author.findOne({
where: { id: authorId },
include: {
books: {
select: {
title: true,
genre: true
}
}
}
})
if (author)
res.json({ author })
else
res.status(404).json({ message: 'Book not found!' })
}
export const createAuthor = async (req: Req, res: Res) => {
const { name, surname, age } = req.body
const createdAuthor = await prisma.author.create({
data: { name, surname, age }
})
res.json({ createdAuthor })
}
export const updateAuthor = async (req: Req, res: Res) => {
const authorId = Number(req.params.id)
const updatedAuthor = await prisma.author.update({
where: { id: authorId },
data: req.body,
})
res.json({ updatedAuthor })
}
export const deleteAuthorById = async (req: Req, res: Res) => {
const authorId = Number(req.params.id)
const deletedAuthor = await prisma.author.delete({
where: { id: authorId },
include: {
books: {
select: {
title: true,
genre: true,
}
}
}
})
if (deletedAuthor)
res.json({ deletedAuthor })
else
res.status(404).json({ deletedAuthor })
}
export const createReview = async (req: Req, res: Res) => {
const { nickname, content, book_id } = req.body
const createdReview = await prisma.review.create({
data: {
nickname,
content,
book: {
connect: {
id: book_id
}
}
}
})
res.json({ createdReview })
}
Y eso es! ahora podemos crear libros, consultarlos (podemos ver la información del autor y las reviews), actualizarlos y eliminarlos, al igual que con los autores, y podemos crear reviews para los libros.
Resumen
En éste post hemos podido apreciar como Prisma nos facilita el trabajo con la base de datos en nuesta app al abstraer esa capa y proveernos de un API intuitiva y poderosa obtenida de un análisis e introspección de nuestra BD. Como desarrolladores, ésta herramienta nos va a permitir acelerar nuestros tiempos de desarrollo a la vez que nos permite tener un mejor control y acceso a los datos que estemos manejando.
Si tienes un proyecto en Node.js con MySQL, PostgreSQL o SQLite, echale un ojo a Prisma, te va a ser muy útil!
0 comentarios:
Publicar un comentario