/ /

insert

Esta versión de la documentación se archivó y ya no se admite. Para actualizar tu implementación de 6.0, consulta el Procedimientos de actualización de MongoDB 7.0 .

Resumen

insert: Un insert evento 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 resumeToken para el parámetro resumeAfter al reanudar un flujo de cambios. El objeto _id tiene la siguiente forma:

{
   "_data" : <BinData|hex string>
}

El tipo _data depende de las versiones de MongoDB y, en algunos casos, de la compatibilidad de características entre versiones (FCV) en el momento de la apertura o reanudación del flujo de cambios. Consulta Tokens de reanudación para la lista completa de tipos de _data.

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 oplog, las transacciones multidocumentos pueden crear varias entradas de oplog. En una transacción, los eventos de flujo de cambios organizados en una entrada determinada del oplog comparten el mismo clusterTime.

En clústeres fragmentados, los eventos con el mismo clusterTime no siempre están relacionados con la misma transacción. Algunos eventos no se relacionan en absoluto con una transacción.

Para identificar eventos para una única transacción, puedes usar la combinación de lsid y txnNumber en el documento de eventos del flujo de cambios.

collectionUUID

UUID

UUID que identifica la colección en la que se produjo el cambio.

Novedades en la versión 6.0.

El campo collectionUUID sólo se incluye si el flujo de cambios se crea con el campo showExpandedEvents configurado en true. Para más detalles, consulte showExpandedEvents.

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 opción changeStreamPreAndPostImages usando db.createCollection(), create o collMod, entonces el campo fullDocument mostrará el documento después de que se hubiera insertado, reemplazado o actualizado (la postimagen del documento). fullDocument siempre se incluye para los eventos de insert.

lsid

Documento

El identificador de la sesión asociada con la transacción.

Solo aparece si la operación forma parte de una transacción multi-documento.

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 se reporta en la notificación de cambio.

Devuelve un valor de insert para estos eventos de cambio.

txnNumber

NumberLong

Junto con el lsid, un número que ayuda a identificar de forma única una transacción.

Solo aparece si la operación forma parte de una transacción multi-documento.

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.

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 tanto el campo _id como el campo userName. Esto indica que la colección engineering.users está particionada, con una clave de partición en userName y _id.

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

Volver

dropIndexes

invalidate