Docs Menu
Docs Home
/ /

modify Evento

modify

Novedades en la versión 6.0.

Un evento modify ocurre cuando se modifica una colección, como cuando collMod El comando agrega o elimina opciones de una colección o vista. Este evento solo se recibe si el flujo de cambios tiene la opción showExpandedEvents establecida true en.

Nota

Desambiguación

Para obtener más información sobre los eventos que ocurren cuando se actualizan documentos individuales, consulte el update evento.

Campo
Tipo
Descripción

_id

Documento

Un objeto BSON 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.

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

Si el cambio se produjo en una colección, collectionUUID indica la colección UUID. Si el cambio ocurrió en una vista, collectionUUID no existe.

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.
index

Documento

El índice que fue modificado.

Novedades en la versión 6.0.

operationDescription.
indexes

arreglo

Una serie de documentos que enumeran los índices que fueron modificados por la operación.

operationType

string

El tipo de operación que informa la notificación de cambio.

Devuelve un valor de modify para estos eventos de cambio.

stateBeforeChange

Documento

El documento muestra las opciones de colección e índice antes de que la operación las cambiara.

stateBeforeChange.
collectionOptions

Documento

El documento muestra las opciones de recopilación antes de que la operación las cambiara.

stateBeforeChange.
indexOptions

Documento

El documento muestra las opciones de índice antes de que la operación las cambiara.

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

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.

El siguiente ejemplo muestra un evento modify:

{
"_id": { <ResumeToken> },
"operationType": "modify",
"clusterTime": Timestamp({ t: 1654878543, i: 1 }),
"collectionUUID": UUID("47d6baac-eeaa-488b-98ae-893f3abaaf25"),
"wallTime": ISODate("2022-06-10T16:29:03.704Z"),
"ns": {
"db": "test",
"coll": "authors" },
"operationDescription": {
"index": {
"name": "age_1",
"hidden": true
}
},
"stateBeforeChange": {
"collectionOptions": {
"uuid": UUID("47d6baac-eeaa-488b-98ae-893f3abaaf25")
},
"indexOptions": {
"hidden": false
}
}
}

Volver

invalidate

En esta página