Prisma es un ORM (mapeo relacional de objetos) moderno que facilita la interacción con bases de datos en aplicaciones Node.js y TypeScript. Una de las características más importantes de Prisma es el sistema de migración, que le permite mantener el esquema de la base de datos sincronizado con el modelo de datos de la aplicación. En esta publicación, exploraremos el flujo de trabajo de Prisma mediante migraciones.

¿Qué son las migraciones?

Las migraciones son un método para controlar y aplicar cambios al esquema de la base de datos de forma sistemática y versionada. Le permiten definir cambios estructurales en la base de datos, como crear o alterar tablas, de manera incremental y reversible.

Flujo de trabajo de Prisma con migraciones

El flujo de trabajo típico con migraciones en Prisma implica los siguientes pasos:

1. Instalación y configuración inicial
2. Definición de esquema
3. Creando una migración
4. Aplicación de migración
5. Gestión de migración

Paso 1: Instalación y configuración inicial

Primero, necesitamos instalar Prisma en el proyecto e inicializarlo:

npm install @prisma/client
npx prisma init

Este comando crea un directorio prisma que contiene un archivo esquema.prisma, donde definimos nuestro modelo de datos.

Paso 2: Definición del esquema

En el archivo esquema.prisma, definimos los modelos que representan las tablas de la base de datos. Por ejemplo, definamos un modelo Usuario:

model User {
  id    Int     @id @default(autoincrement())
  email String  @unique
  name  String?
}

Aquí, estamos definiendo una tabla de Usuario con columnas de identificación, correo electrónico y nombre.

Paso 3: crear una migración

Después de definir o cambiar el esquema, creamos una migración para reflejar estos cambios en la base de datos:

npx prisma migrate dev --name init

El comando migrar dev crea una nueva migración y aplica los cambios a la base de datos. El parámetro --name le permite darle a la migración un nombre descriptivo, como init en el ejemplo anterior.

Paso 4: Solicitud de migración

Las migraciones se aplican automáticamente a la base de datos cuando usamos el comando migrar dev. Esto garantiza que la base de datos esté siempre sincronizada con el modelo de datos definido en esquema.prisma.

Si deseas aplicar migraciones en un entorno de producción, usa el comando:

npx prisma migrate deploy

Este comando aplica todas las migraciones pendientes a la base de datos de producción.

Paso 5: Gestión de la migración

Prisma mantiene un historial de todas las migraciones aplicadas a la base de datos. Esto es útil para rastrear cambios y revertir migraciones si es necesario. Para ver el historial de migración, puedes usar:

npx prisma migrate status

Este comando muestra el estado actual de las migraciones, incluidas las que se han aplicado y las que están pendientes.

Ejemplo práctico

Veamos un ejemplo práctico de cómo agregar un nuevo campo al modelo Usuario y crear una migración para este cambio.

1. Agregue el campo al modelo de usuario en esquema.prisma:
   

   model User {
     id        Int     @id @default(autoincrement())
     email     String  @unique
     name      String?
     birthdate DateTime?
   }
   
   

2. Crear una nueva migración:
   

   npx prisma migrate dev --name add-birthdate-to-user
   
   

3. Aplicar migración:

   El comando migrar dev ya aplica la migración a la base de datos. Ahora la base de datos tendrá el nuevo campo de fecha de nacimiento en la tabla Usuario.

4. Verificar estado migratorio:
   

   npx prisma migrate status
   
   

   Este comando mostrará que la migración de agregar fecha de nacimiento a usuario se aplicó correctamente.

Conclusión

El flujo de trabajo de Prisma que utiliza migraciones es una forma eficiente y segura de gestionar cambios en el esquema de la base de datos. A través de una secuencia clara de pasos (definir el esquema, crear migraciones, aplicar cambios y gestionar el historial de migraciones) es posible mantener la base de datos sincronizada con el modelo de datos de la aplicación, facilitando el desarrollo y mantenimiento del software.

Con Prisma, no solo simplifica la administración de la base de datos, sino que también obtiene una poderosa herramienta para garantizar que todos los cambios sean rastreables y reversibles, lo que contribuye a un proceso de desarrollo más sólido y ágil.