Upserts en MongoDB: actualizar o insertar

Upserts en MongoDB: actualizar o insertar | Nicolás Garzón

JavaScript

db.settings.updateOne(
  {
    businessId,
    key: 'checkout'
  },
  {
    $set: {
      value: input.value,
      updatedAt: new Date()
    },
    $setOnInsert: {
      createdAt: new Date(),
      schemaVersion: 1
    }
  },
  {
    upsert: true
  }
);

JavaScript

db.products.updateOne(
  {
    businessId,
    source: 'erp',
    externalId: payload.id
  },
  {
    $set: {
      name: payload.name,
      price: payload.price,
      sourceUpdatedAt: payload.updatedAt,
      syncedAt: new Date()
    },
    $setOnInsert: {
      createdAt: new Date()
    }
  },
  { upsert: true }
);

JavaScript

db.dailyMetrics.updateOne(
  {
    businessId,
    date: dayStart
  },
  {
    $inc: {
      orderCount: 1,
      revenueInCents: amount
    },
    $setOnInsert: {
      createdAt: new Date()
    }
  },
  { upsert: true }
);

Upserts

Idea principal

Problema que resuelve

Filtro e identidad lógica

`$setOnInsert`

Resultado

Documento insertado

Idempotencia

Upsert de contadores

Retry y duplicate key

Upsert con reemplazo

Upsert y tenant

Upsert y soft delete

Casos límite

Dos upserts concurrentes

Filtro con tipos distintos

`$setOnInsert` incompleto

Mensajes fuera de orden

Retry ambiguo

Upsert masivo

Errores frecuentes

Creer que `upsert: true` garantiza unicidad

Usar un filtro que no representa identidad

No revisar `upsertedId`

Incrementar durante retries sin idempotencia

Sobrescribir eventos nuevos con antiguos

Mezclar creación y actualización sin metadata separada

Cómo verificar

Qué debes recordar

Continúa con