La integración de múltiples motores de bases de datos en una sola aplicación requiere una abstracción robusta de la capa de persistencia. Al combinar Amplication, una plataforma de generación automática de backend, con Prisma, un Object-Relational Mapper (ORM) moderno, es posible delegar la complejidad de la infraestructura de datos y centrarse en la lógica de negocio.

Ventajas de la Integración Amplication y Prisma

En arquitecturas distribuidas o sistemas que requieren poliglotismo de persistencia, esta combinación ofrece beneficios técnicos significativos:

• Abstracción de la capa de datos: Prisma unifica la interfaz de consulta, mientras que Amplication genera automáticamente los servicios, controladores y resolvers basados en el esquema.
• Agnosticismo de motor: Permite alternar o conectar simultáneamente motores como PostgreSQL, MySQL o SQLite modificando únicamente la configuración del proveedor.
• Consistencia estructural: El código generado por Amplication sigue patrones de diseño estandarizados (como NestJS), reduciendo la deuda técnica y los errores de implementación manual.

Configuración del Entorno de Desarrollo

Para inicializar un proyecto que aproveche estas herramientas, se debe configurar el espacio de trabajo base. En lugar de clonar repositorios internos, se recomienda utilizar la CLI oficial para generar la estructura del proyecto:

npx @amplication/cli init api-multi-db
cd api-multi-db
npm install

Definición del Esquema de Prisma

El núcleo de la integración reside en el archivo de esquema de Prisma. Para habilitar el soporte multi-base de datos, se debe configurar el bloque datasource apuntando a las variables de entorno correctas. A continuación, se muestra una configuración orientada a un clúster de MySQL:

datasource primary_db {
  provider = "mysql"
  url      = env("MYSQL_CONN_STRING")
}

generator client {
  provider = "prisma-client-js"
}

Diseño del Modelo de Datos

La definición de las entidades y sus relaciones dicta cómo se estructurarán las tablas en la base de datos. El siguiente ejemplo ilustra una relación uno a muchos entre una entidad Tienda y sus Productos, utilizando identificadores UUID para mayor escalabilidad:

model Tienda {
  id        String    @id @default(uuid())
  nombre    String
  ubicacion String
  productos Producto[]
}

model Producto {
  id          String  @id @default(uuid())
  sku         String  @unique
  descripcion String
  precio      Float
  tiendaId    String
  tienda      Tienda  @relation(fields: [tiendaId], references: [id])
}

Generación Automatizada de Código

Una vez definido el esquema, Amplication procesa los modelos para generar la API completa. Se puede personalizar el comportamiento del generador mediante un archivo de configuración en la raíz del proyecto:

// amplication.config.ts
export default {
  settings: {
    dbProvider: 'mysql',
    generateGraphQL: true,
    generateRestApi: true,
    authProvider: 'jwt'
  }
};

Para ejecutar el proceso de generación de servicios de datos (DSG), se ejecuta el siguiente comando:

npx @amplication/cli generate --config amplication.config.ts

Arquitectura del Generador de Servicios de Datos (DSG)

El proceso de generación de código en Amplication opera bajo una arquitectura basada en eventos. Cuando se dispara una compilación, el cliente envía una solicitud al servidor principal, el cual enruta el mensaje a través de un broker de Kafka hacia el BuildManager. Este componente orquesta la ejecución del LocalDSGRunner, que lee el esquema de Prisma, aplica las plantillas de AST (Abstract Syntax Tree) y emite el código fuente final de NestJS. Esta separación de responsabilidades permite escalar el proceso de generación sin bloquear el hilo principal del servidor.

Estructuración de Modelos Relacionales Complejos

Para sistemas más robustos, el diseño del esquema debe contemplar jerarquías y tenencia múltiple. Un modelo avanzado podría incluir entidades como Tenant (Inquilino), Workspace (Espacio de trabajo), Resource (Recurso) y AuditLog (Registro de auditoría). Al definir estas relaciones foráneas y restricciones de unicidad directamente en el esquema de Prisma, el generador de Amplication produce automáticamente los DTOs (Data Transfer Objects), las validaciones de entrada y los servicios de repositorio necesarios. Esto garantiza que la integridad referencial se mantenga en la capa de aplicación, independientemente de si el motor subyacente es PostgreSQL o MySQL.