insertar evento

Resumen

insert: Un evento insert ocurre cuando una operación agrega documentos a una colección.

Descripción

Campo	Tipo	Descripción
`_id`	Documento	A Objeto BSON, que sirve como identificador para el evento de flujo de cambios. Este valor se utiliza como el parámetro `resumeToken` para `resumeAfter` al reanudar un flujo de cambios. Los campos dentro del objeto `_id` dependen de las versiones de MongoDB y, en algunos casos, de la compatibilidad de características entre versiones (compatibilidad de características entre versiones) en el momento de la apertura o reanudación del flujo de cambios. Para obtener un ejemplo de reanudación de un flujo de cambios por `resumeToken`, consulta Reanudar un Change Stream.
`clusterTime`	Marca de tiempo	`clusterTime` es la marca de tiempo de la entrada de oplog asociada con el evento. Debido a los límites de tamaño del registro de operaciones, lastransacciones multidocumento pueden crear varias entradas del registro de operaciones. En una transacción, los eventos de flujo de cambios almacenados en una entrada del registro de operaciones comparten el `clusterTime` mismo. Los eventos con el mismo `clusterTime` pueden no estar todos relacionados con la misma transacción. Algunos eventos no están relacionados en absoluto con una transacción. A partir de MongoDB 8.0, esto puede ser cierto para eventos en cualquier implementación. En versiones anteriores, este comportamiento sólo era posible para eventos en un clúster particionado. Para identificar eventos para una sola transacción, puede utilizar la combinación de `lsid` y `txnNumber` en el documento de evento de flujo de cambios. Cambiado en la versión 8.0.
`collectionUUID`	UUID	UUID que identifica la colección donde ocurrió el cambio. Novedades en la versión 6.0. En MongoDB,,8.2.0 `collectionUUID` y updateDescription.disambiguatedPaths se incluyen en los eventos de cambio aplicables incluso si no se `showExpandedEvents` establece. En versiones de MongoDB anteriores a 8.2.0 y en versiones,,8 21 y posteriores, estos campos se incluyen solo si se abre el flujo de cambios `showExpandedEvents: true` con.
`documentKey`	Documento	Documento que contiene el valor `_id` del documento creado o modificado por la operación CRUD. Para los conjuntos particionados, este campo también muestra la clave de partición completa del documento. El campo `_id` no se repite si ya es parte de la clave de partición.
`fullDocument`	Documento	El documento creado por la operación. Cambiado en la versión 6.0. A partir de MongoDB 6.0, si configura la `changeStreamPreAndPostImages` opción usando,`db.createCollection()` `create`o,`collMod` el `fullDocument` campo muestra el documento después de que se insertó, reemplazó o actualizó (la imagen posterior del documento). `fullDocument` siempre se incluye para `insert` los eventos.
`lsid`	Documento	El identificador de la sesión asociada con la transacción. Sólo está presente si la operación es parte de una transacción de múltiples documentos.
`ns`	Documento	El namespace (base de datos o colección) afectado por el evento.
`ns.coll`	string	El nombre de la colección donde ocurrió el evento.
`ns.db`	string	El nombre de la base de datos donde ocurrió el evento.
`operationType`	string	El tipo de operación que informa la notificación de cambio. Devuelve un valor de `insert` para estos eventos de cambio.
`txnNumber`	Número largo	Junto con el lsid, un número que ayuda a identificar de forma única una transacción. Sólo está presente si la operación es parte de una transacción de múltiples documentos.
`wallTime`	ISODate	La fecha y hora del servidor de la operación de la base de datos. `wallTime` se diferencia de `clusterTime` en que `clusterTime` es una marca de tiempo tomada de la entrada oplog asociada con el evento de operación de la base de datos. Novedades en la versión 6.0.

Comportamiento

Operaciones de actualizar

El comando update puede producir diferentes eventos de cambio (no solo update) dependiendo de los cambios reales que realice en la colección.

Evento de cambio	Descripción
`update`	La operación de actualización modificó un documento existente.
`replace`	La operación de actualización reemplazó el documento o produjo una diferencia que era más detallada que el documento original, lo que provocó que MongoDB lo reemplazara.
`insert`	La operación de actualización intentó actualizar un documento inexistente y, en su lugar, lo agregó a la colección. Esto solo ocurre cuando la actualización se ejecuta con la opción `upsert` habilitada.

Ejemplo

El siguiente ejemplo ilustra un evento insert:

{
   "_id": { <Resume Token> },
   "operationType": "insert",
   "clusterTime": <Timestamp>,
   "wallTime": <ISODate>,
   "ns": {
      "db": "engineering",
      "coll": "users"
   },
   "documentKey": {
      "userName": "alice123",
      "_id": ObjectId("599af247bb69cd89961c986d")
   },
   "fullDocument": {
      "_id": ObjectId("599af247bb69cd89961c986d"),
      "userName": "alice123",
      "name": "Alice"
   }
}

El campo documentKey incluye los campos _id y userName. Esto indica que la colección engineering.users está fragmentada, con una clave de fragmentación en userName y _id.

El documento fullDocument representa la versión del documento en el momento de la inserción.

Volver

dropIndexes

invalidate