Join us at MongoDB.local London on 7 May to unlock new possibilities for your data. Use WEB50 to save 50%.
Register now >
Docs Menu
Docs Home
/ /

crear Evento

create

Novedades en la versión 6.0.

Un evento create ocurre cuando se crea una colección en una base de datos observada y el flujo de cambios tiene la La opción showExpandedEvents está establecida true en.

Campo
Tipo
Descripción

_id

Documento

Un objeto BSON, que actúa como identificador del evento del 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 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.

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

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

nsType

string

Muestra el tipo de namespace de la colección creada por este evento.

"collection"
Indica que el evento crea una colección.
"timeseries"
Indica que el evento crea una colección de series temporales.
"view"
Indica que el evento crea una vista que no es de serie temporal.

Novedades en la versión 8.1: (también disponible en 8.0.5).

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

Documento

El índice por defecto de _id para una nueva colección.

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 create para estos eventos de cambio.

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 oplog 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 create:

{
"_id": { <ResumeToken> },
"operationType": "create",
"clusterTime": Timestamp({ t: 1654894547, i: 24 }),
"collectionUUID": UUID("98046a1a-b649-4e5b-9c75-67594221ce19"),
"wallTime": ISODate("2022-06-10T20:55:47.947Z"),
"ns": {
"db": "test",
"coll": "names"
},
"operationDescription": {
"idIndex": { "v": 2, "key": { _id: 1 }, "name": "_id_" }
}
}

Volver

Eventos de cambios

En esta página