`rename` Evento

Resumen

rename: Un evento rename ocurre cuando se renombra 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 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`. 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 única transacción, puedes usar la combinación de `lsid` y `txnNumber` en el documento de eventos del flujo de cambios. Cambiado en la versión 8.0.
`collectionUUID`	UUID	UUID que identifica la colección en la que se produjo el cambio. Novedades en la versión 6.0.
`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.db`	string	El nombre de la base de datos donde ocurrió el evento.
`ns.coll`	string	El nombre de la colección donde ocurrió el evento.
`operationDescription`	Documento	Información adicional sobre la operación de cambio. Este documento y sus subcampos solo aparecen cuando el flujo de cambios utiliza eventos ampliados. Novedades en la versión 6.0.
`operationDescription.` `dropTarget`	UUID	UUID de la colección que se descartó en la operación de cambio de nombre. Novedades en la versión 6.0.
`operationDescription.` `to`	Documento	El nuevo namespace de la colección después de cambiar el nombre. Novedades en la versión 6.0.
`operationDescription.` `to.coll`	Documento	El nuevo nombre de la colección después del cambio de nombre. Novedades en la versión 6.0.
`operationDescription.` `to.db`	Documento	El nuevo nombre de la base de datos después de la actualización. Novedades en la versión 6.0.
`operationType`	string	El tipo de operación que se reporta en la notificación de cambio. Devuelve un valor de `rename` para estos eventos de cambio.
`to`	Documento	El nuevo namespace de la colección después de cambiar el nombre.
`to.coll`	Documento	El nuevo nombre de la colección después del cambio de nombre.
`to.db`	Documento	El nuevo nombre de la base de datos después de la actualización.
`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.

Comportamiento

Información Ampliada del Evento

Cambiado en la versión 6.0.

A partir de MongoDB 6.0, cuando la opción showExpandedEvents está configurada como true para el flujo de cambios, el evento rename incluye un documento operationDescription. Este documento proporciona un campo to que muestra la base de datos y colección modificadas, y un campo dropTarget que indica si la rename operación eliminó la colección antes del cambio de nombre.

Ejemplo

El siguiente ejemplo ilustra un evento rename:

{
   "_id": { <Resume Token> },
   "operationType": "rename",
   "clusterTime": <Timestamp>,
   "wallTime": <ISODate>,
   "ns": {
      "db": "engineering",
      "coll": "users"
   },
   "to": {
      "db": "engineering",
      "coll": "people"
   },
   "operationDescription": {
      "to": {
         "db": "engineering",
         "coll": "people"
      }
   }
}

Un evento rename genera un evento de invalidación para las secuencias de cambio abiertas en su ns colección o to colección.

Volver

refineCollectionShardKey

Reemplazar