/ /

`shardCollection` Evento

Esta versión de la documentación se archivó y ya no se admite. Para actualizar tu implementación de 6.0, consulta el Procedimientos de actualización de MongoDB.7.0

Resumen

shardCollection: Novedades en la versión 6.0.
Se produce un evento de shardCollection cuando una colección es particionada.

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

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

El tipo _data depende de las versiones de MongoDB y, en algunos casos, de la compatibilidad de características entre versiones (FCV) en el momento de la apertura o reanudación del flujo de cambios. Consulta Tokens de reanudación para la lista completa de tipos de _data.

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.

En clústeres fragmentados, los eventos con el mismo clusterTime no siempre están relacionados con la misma transacción. Algunos eventos no se relacionan en absoluto con una 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 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.

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.

numInitialChunks

long

Número de fragmentos creados en cada fragmento durante una shardCollection operación.

Novedades en la versión 6.0.

operationDescription.

presplitHashedZones

booleano

Indica si las particiones de fragmentos fueron pre-divididos de acuerdo a las zonas cuando la colección se volvió particionado.

Novedades en la versión 6.0.

operationDescription.

shardKey

Documento

La clave de partición de la colección donde se produjo el cambio.

Novedades en la versión 6.0.

operationDescription.

unique

booleano

Esto tiene un valor de verdadero si la colección se dividió con una clave de fragmento única.

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

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.

Ejemplo

El siguiente ejemplo muestra un evento shardCollection:

{
   "_id": { <ResumeToken> },
   "operationType": "shardCollection",
   "clusterTime": Timestamp({ t: 1654894852, i: 52 }),
   "collectionUUID": UUID("98046a1a-b649-4e5b-9c75-67594221ce19"),
   "wallTime": ISODate("2022-06-10T21:00:52.854Z"),
   "ns": {
      "db": "test",
      "coll": "authors"
   },
   "operationDescription": {
      "shardKey": { "age": "hashed" },
      "unique": false,
      "numInitialChunks": Long("0"),
      "presplitHashedZones": false
   }
}

Volver

reshardCollection

update