/ /

`rename` Evento

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

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 de flujo de cambios. Este valor se utiliza como resumeToken para el resumeAfter parámetro al reanudar un flujo de cambios. El _id objeto tiene la siguiente forma:

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

El _data tipo depende de las versiones de MongoDB y, en algunos casos, de la versión de compatibilidad de funciones (FCV) vigente al momento de la apertura o reanudación del flujo de cambios.Consulte Tokens de reanudación para ver la lista completa de _data tipos.

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.

En clústeres fragmentados, es posible que los eventos con el mismo clusterTime no se relacionen todos con la misma transacción. Algunos eventos no se relacionan con ninguna transacción.

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.

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

modify

Reemplazar