Eventos de cambios

Esta versión de la documentación está archivada y ya no recibe soporte. Para actualizar su implementación 6.0, consulte Procedimientos de actualización de MongoDB.7.0

Los flujos de cambios supervisan las colecciones, las bases de datos o las implementaciones para detectar cambios.

Cuando se produce un cambio en un recurso supervisado, el flujo de cambios devuelve un documento de notificación de evento de cambio, con información sobre la operación y los cambios realizados.

Tipos de operaciones

Evento	Descripción
`create`	Se produce en la creación de una colección. Requiere que configure la opción showExpandedEvents en `true`. Novedades en la versión 6.0.
`createIndexes`	Se produce al crear índices en la colección. Requiere que configure la opción showExpandedEvents en `true`. Novedades en la versión 6.0.
`delete`	Ocurre cuando se elimina un documento de la colección.
`drop`	Se produce cuando se descarta una colección de una base de datos.
`dropDatabase`	Ocurre cuando se descarta una base de datos.
`dropIndexes`	Ocurre cuando se descarta un índice de la colección. Requiere que configure la opción showExpandedEvents en `true`. Novedades en la versión 6.0.
`insert`	Se produce cuando una operación agrega documentos a una colección.
`invalidate`	Se produce cuando una operación hace que el flujo de cambios sea inválido.
`modify`	Se produce cuando se modifica una colección. Requiere que configure la opción showExpandedEvents en `true`. Novedades en la versión 6.0.
`rename`	Se produce cuando se cambia el nombre a una colección.
`replace`	Se produce cuando una operación de actualización remueve un documento de una colección y lo reemplaza por uno nuevo.
`reshardCollection`	Se produce cuando la clave de partición de una colección y la distribución de datos cambian. Requiere que configure la opción showExpandedEvents en `true`. Nuevo en la versión 6.1: (también disponible en 6.0.14)
`shardCollection`	Se produce cuando una colección se particiona. Requiere que configure la opción showExpandedEvents en `true`. Novedades en la versión 6.0.
`update`	Se produce cuando una operación actualiza un documento en una colección.

Nota

El servidor podría procesar y devolver internamente operaciones de actualización como operaciones de reemplazo si la representación de las operaciones de reemplazo es más concisa. Si se escuchan operaciones de actualización, recomendamos encarecidamente que también se escuchen operaciones de reemplazo.

Token de reanudación

Cada evento de cambio incluye un campo _id que contiene un documento. Este documento puede servir como el token de reanudación al iniciar un flujo de cambios.

Eventos ampliados

Novedades en la versión 6.0.

A partir de MongoDB 6.0, los flujos de cambios admiten notificaciones de cambios para eventos DDL, como los eventos createIndexes y dropIndexes. Para incluir eventos expandidos en un flujo de cambios, cree el cursor del flujo de cambios utilizando la opción showExpandedEvents.

Por ejemplo:

let cur = db.names.aggregate( [ {
   $changeStream: {
       showExpandedEvents: true
     }
   }
 ] )
cur.next()

Volver

Recomendaciones de producción

Cree