Cambias tu script de seed para que una sucursal quede desactivada (isActive: false), ejecutas pnpm prisma db seed y el comando termina sin errores:
Running seed command `tsx prisma/seed.ts` ...
The seed command has been executed.
Pero al revisar la base de datos, el registro sigue activo. No hay ningún mensaje de error, y al volver a ejecutar el seed nada cambia. Lo curioso es que en una base de datos recién creada el valor sí es el correcto. Este artículo explica por qué upsert se comporta así y cómo escribir un seed idempotente que actualice lo que debe actualizar. La reproducción se hizo con Prisma 6.19.3 y SQLite.
Por qué pasa
El método upsert tiene tres opciones obligatorias: where, create y update. La documentación de Prisma explica que, si existe un registro que cumple el where, se aplican los datos de update; si no existe, se crea con los datos de create. Además, el where solo admite campos únicos.
El seed original se parecía a esto:
await prisma.sucursal.upsert({
where: { code: 'CENTRO' },
update: {},
create: { code: 'CENTRO', name: 'Sucursal Centro', isActive: false },
});
Con la tabla vacía, Prisma crea la fila con isActive: false. Con la fila ya creada (por una ejecución anterior del seed, con otro valor), toma la rama update, que está vacía: no toca ningún campo. El valor de isActive aparece solo en create, y esa rama no se ejecuta para filas existentes.
Un update: {} no es un error: la propia documentación de Prisma lo usa en su ejemplo de seed para "crear si no existe y dejar intacto si existe". El problema aparece cuando asumes que el seed también sincroniza valores. Y suele pasar desapercibido porque en desarrollo, tras un prisma migrate reset, la base de datos se recrea y el seed (que en Prisma 6 y anteriores se ejecuta automáticamente tras el reinicio) siempre toma la rama create. El desfase solo se ve en entornos con datos previos, como staging o producción.
Solución
-
Comprueba el estado real. Un script de consulta evita adivinar. Con
tsx:// ver.ts import { PrismaClient } from '@prisma/client'; const prisma = new PrismaClient(); async function main() { const filas = await prisma.sucursal.findMany({ select: { code: true, isActive: true }, orderBy: { code: 'asc' }, }); console.table(filas); } main().finally(() => prisma.$disconnect());pnpm tsx ver.ts -
Decide qué campos "pertenecen" al seed. Un campo que el seed debe mantener sincronizado (por ejemplo, el nombre de un catálogo o el estado de activación definido en código) va en
createy enupdate. Un campo que los usuarios pueden modificar después desde la aplicación y que el seed solo debe establecer al crear (un valor inicial) va únicamente encreate. Es una decisión de diseño, así que tómala campo por campo. -
Deriva
createyupdatede un mismo objeto. Así no puedes olvidar un campo en una de las dos ramas:const datos = { name: 'Sucursal Centro', isActive: false }; await prisma.sucursal.upsert({ where: { code: 'CENTRO' }, create: { code: 'CENTRO', ...datos }, update: datos, }); -
Haz explícito lo opcional con una variable de entorno. Si sobrescribir ciertos campos en filas existentes puede pisar cambios hechos desde la aplicación, no lo hagas por defecto: actívalo solo cuando lo pidas.
// prisma/seed.ts import { PrismaClient } from '@prisma/client'; const prisma = new PrismaClient(); // Con SEED_SYNC_ACTIVE=true el seed también fuerza isActive en filas existentes. const sincronizarActivo = process.env.SEED_SYNC_ACTIVE === 'true'; const sucursales = [ { code: 'CENTRO', name: 'Sucursal Centro', isActive: true }, { code: 'NORTE', name: 'Sucursal Norte', isActive: false }, ]; async function main() { for (const { code, name, isActive } of sucursales) { await prisma.sucursal.upsert({ where: { code }, create: { code, name, isActive }, update: { name, ...(sincronizarActivo ? { isActive } : {}) }, }); } } main() .then(() => prisma.$disconnect()) .catch(async (error) => { console.error(error); await prisma.$disconnect(); process.exit(1); });Para ejecutarlo en la modalidad que sincroniza el estado, en Bash y en PowerShell respectivamente:
SEED_SYNC_ACTIVE=true pnpm prisma db seed$env:SEED_SYNC_ACTIVE = 'true'; pnpm prisma db seed; Remove-Item Env:SEED_SYNC_ACTIVE -
Confirma que el comando de seed está configurado. En Prisma 6.19 puedes declararlo en
prisma.config.ts:import { defineConfig } from 'prisma/config'; export default defineConfig({ schema: 'prisma/schema.prisma', migrations: { seed: 'tsx prisma/seed.ts', }, });La clave
prisma.seeddepackage.jsonsigue funcionando en esa versión, pero Prisma muestra el aviso de que está obsoleta y se eliminará en Prisma 7. Ten en cuenta que, cuando existeprisma.config.ts, Prisma no carga por sí mismo los archivos.env("Prisma config detected, skipping environment variable loading").
Cómo verificar que quedó resuelto
Parte de un estado donde las filas ya existen con valores distintos a los del seed y ejecuta tres veces, mirando el estado con ver.ts:
- Sin la variable:
pnpm prisma db seedactualizaname, peroisActiveconserva el valor que tenía. - Con
SEED_SYNC_ACTIVE=true:isActivepasa a coincidir con el seed (CENTROactiva,NORTEinactiva). - Repite el comando con la variable: el resultado debe ser idéntico y el número de filas no debe cambiar. Eso es la idempotencia: ejecutar el seed N veces deja el mismo estado que ejecutarlo una.
Añade esa comprobación a la rutina de despliegue de staging antes de confiar en el seed en producción.
Variantes y errores relacionados
createMany con skipDuplicates tampoco actualiza
Según la referencia de Prisma, skipDuplicates omite los registros cuyos campos únicos o clave ya existen: no los modifica. Para sincronizar valores necesitas upsert (o un updateMany aparte).
El seed no borra lo que quitas del código
Si eliminas una sucursal del arreglo, upsert no borra la fila existente. Una forma segura de retirar un elemento de un catálogo es marcarlo como inactivo (y, con la variable de sincronización, aplicar ese estado), en lugar de eliminar datos en un script de seed.
Seeds concurrentes
La referencia de Prisma advierte que, si dos upsert se ejecutan a la vez y el registro no existe, uno puede fallar con P2002; el consejo es reintentar. Un seed ejecuta sus operaciones en secuencia, así que normalmente no ocurre, pero sí puede pasar si dos despliegues lo lanzan al mismo tiempo.
El seed automático tras un reinicio no sirve para probar esto
En Prisma 6 y anteriores, el seed se dispara automáticamente cuando Prisma Migrate reinicia la base de datos de desarrollo (por ejemplo con migrate reset); puedes evitarlo con --skip-seed. En entornos desplegados lo ejecutas tú con prisma db seed.
Resumen
- En
upsert, la ramaupdatesolo modifica los campos que le indicas; un campo presente únicamente encreateno cambia en filas existentes. - Un
update: {}vacío es intencional en muchos seeds ("crear si falta"), pero no sincroniza nada. - Deriva
createyupdatede un mismo objeto y decide, campo por campo, qué debe pisar el seed. - Haz explícito lo opcional con una variable de entorno y verifica la idempotencia ejecutando el seed varias veces.
- Tras un reinicio de la base de datos de desarrollo el defecto no se ve; pruébalo en un entorno con datos previos.
Comentarios
Publicar un comentario