`rename` Evento

Resumen

rename: Se produce un evento rename cuando se cambia el nombre de una colección.

Descripción

Campo	Tipo	Descripción
`_id`	Documento	A ObjetoBSON, que sirve como identificador del evento del flujo de cambios. Este valor se utiliza como `resumeToken` para el `resumeAfter` parámetro al reanudar un flujo de cambios. Los campos del `_id` objeto dependen de las versiones de MongoDB y, en algunos casos, de la versión de compatibilidad de características (FCV) vigente al momento de la apertura o reanudación del flujo de cambios. Para ver un ejemplo de cómo reanudar un flujo de cambios `resumeToken` por, consulte Reanudar un flujo de cambios.
`clusterTime`	Marca de tiempo	`clusterTime` es la marca de tiempo de la entrada del registro de operaciones 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. Es posible que no todos los eventos con el mismo `clusterTime` se relacionen con la misma transacción. Algunos eventos no se relacionan con ninguna transacción. A partir de MongoDB 8.0, esto puede ocurrir con eventos en cualquier implementación. En versiones anteriores, este comportamiento solo era posible con eventos en un clúster fragmentado. 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.
`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 espacio de nombres (base de datos y/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 expandidos. Novedades en la versión 6.0.
`operationDescription.` `dropTarget`	UUID	UUID de la colección que se eliminó en la operación de cambio de nombre. Novedades en la versión 6.0.
`operationDescription.` `to`	Documento	El nuevo espacio de nombres de la colección después del cambio de 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 del cambio de nombre. Novedades en la versión 6.0.
`operationType`	string	El tipo de operación que informa la notificación de cambio. Devuelve un valor de `rename` para estos eventos de cambio.
`to`	Documento	El nuevo espacio de nombres de la colección después del cambio de 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 del cambio de nombre.
`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 del registro de operaciones 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 se establece en true para el flujo de cambios, el rename evento incluye un operationDescription documento. Este documento proporciona un to campo que muestra la base de datos y la colección modificadas, y un dropTarget campo 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 rename evento genera un evento de invalidación para los flujos de cambio abiertos contra su ns colección o su to colección.

Volver

refinar clave de fragmento de colección

Reemplazar