Transacciones

Crear colecciones e índices en una transacción

Puedes realizar las siguientes operaciones en una transacción si no se trata de una transacción de escritura entre fragmentos:

• Crea colecciones.

• Crea índices en nuevas colecciones vacías que se hayan creado anteriormente en la misma transacción.

Al crear una colección dentro de una transacción:

• Se puede crear implícitamente una colección, como con:

  • una operación de inserción para una colección inexistente, o

  • una operación de actualizar/encontrar&modificar con upsert: true para una colección inexistente.

• Puede crear explícitamente una colección utilizando el comando create o su asistente db.createCollection().

Cuando cree un índice dentro de una transacción [1], el índice que se va a crear debe estar en uno de los siguientes:

• una colección inexistente. La colección se crea como parte de la operación.

• una nueva colección vacía creada anteriormente en la misma transacción.

Operación de conteo

Para realizar una operación de conteo dentro de una transacción, utilice la etapa de agregación $count o la etapa de agregación $group (con una expresión $sum).

Los controladores de MongoDB proporcionan una API a nivel de colección countDocuments(filter, options) como un método asistente que utiliza el $group con una expresión $sum para realizar un conteo.

mongosh proporciona el método asistente db.collection.countDocuments() que utiliza $group con una expresión $sum para realizar un conteo.

Operación distinta

Para realizar una operación específica dentro de una transacción:

• Para colecciones no fragmentadas, puedes utilizar el método db.collection.distinct() o el comando distinct, así como la canalización de agregación con la etapa $group.

• Para colecciones fragmentadas, no puede utilizar el método db.collection.distinct() ni el comando distinct.

  Para encontrar los valores distintos de una colección fragmentada, utilice la canalización de agregación con la etapa $group en su lugar. Por ejemplo:

  • En lugar de db.coll.distinct("x"), utilice

    db.coll.aggregate([
       { $group: { _id: null, distinctValues: { $addToSet: "$x" } } },
       { $project: { _id: 0 } }
    ])

  • En lugar de db.coll.distinct("x", { status: "A" }), utilice:

    db.coll.aggregate([
       { $match: { status: "A" } },
       { $group: { _id: null, distinctValues: { $addToSet: "$x" } } },
       { $project: { _id: 0 } }
    ])

  El pipeline devuelve un cursor a un documento:

  { "distinctValues" : [ 2, 3, 1 ] }

  Itere el cursor para acceder al documento de resultados.

Operaciones de información

Los comandos informativos, como hello, buildInfo, connectionStatus (y sus métodos asistentes) están permitidos en las transacciones; sin embargo, no pueden ser la primera operación de la transacción.

Operaciones restringidas

Las siguientes operaciones no están permitidas en las transacciones:

• Creación de nuevas colecciones en transacciones de escritura entre particiones. Por ejemplo, si usted guarda en una colección existente en una partición y crea implícitamente una colección en una partición diferente, MongoDB no puede realizar ambas operaciones en la misma transacción.

• Creación explícita de colecciones, como por ejemplo: Método db.createCollection() e índices, por ejemplo: los métodos db.collection.createIndexes() y db.collection.createIndex(), cuando se utiliza un nivel de consistencia de lectura distinto de "local".

• Los comandos listCollections y listIndexes y sus métodos asistentes.

• Otras operaciones que no son CRUD ni informativas, tales como createUser, getParameter, count, etc. y sus asistentes.

• Operaciones paralelas. Para actualizar varios espacios de nombres simultáneamente, considera usar el comando bulkWrite en cambio.

Transacciones y preferencia de lectura

Las operaciones en una transacción utilizan la preferencia de lectura a nivel de transacción.

Usando los drivers, se puede establecer la preferencia de lectura a nivel de transacción al inicio de la transacción:

• Si la preferencia de lectura a nivel de transacción no está establecida, la transacción utiliza la preferencia de lectura a nivel de sesión.

• Si la preferencia de lectura a nivel de transacción y la de nivel de sesión no están establecidas, la transacción utiliza la preferencia de lectura a nivel de cliente. Por defecto, la preferencia de lectura a nivel de cliente es primary.

Transacciones que contienen operaciones de lectura deben usar la preferencia de lectura primary. Todas las operaciones en una transacción determinada deben dirigirse al mismo nodo.

Transacciones y nivel de consistencia de lectura

Las operaciones en una transacción utilizan el nivel de consistencia de lectura de la transacción. Esto significa que un nivel de consistencia de lectura establecido a nivel de colección y base de datos se ignora dentro de la transacción.

Puede establecer el nivel de consistencia de lectura a nivel de transacción al inicio de la transacción.

• Si el nivel de consistencia de lectura a nivel de transacción no está establecido, el nivel de consistencia de lectura a nivel de transacción por defecto se ajusta al nivel de consistencia de lectura a nivel de sesión.

• Si el nivel de consistencia de lectura de transacción y el de sesión no están configurados, el nivel de consistencia de lectura de transacción por defecto es el nivel de consistencia de lectura de cliente. Por defecto, el nivel de consistencia de lectura de es "local" para las lecturas en el primario. Véase también:

  • Transacciones y preferencia de lectura

  • Valores predeterminados de MongoDB

Las transacciones soportan los siguientes niveles de consistencia de lectura:

Transacciones y nivel de confirmación de escritura

Las transacciones utilizan el nivel de confirmación de escritura (write concern) a nivel de transacción para confirmar las operaciones de escritura. Las operaciones de escritura dentro de las transacciones deben ejecutarse sin una especificación explícita de nivel de confirmación de escritura (write concern) y utilizar el nivel de confirmación de escritura (write concern) por defecto. En el momento de la confirmación, las escrituras se confirman utilizando el nivel de confirmación de escritura (write concern) de la transacción.

Puede establecer el nivel de confirmación de escritura a nivel de transacción al inicio de la transacción:

• Si el nivel de confirmación de escritura a nivel de transacción no está establecido, se utiliza por defecto el nivel de confirmación de escritura a nivel de sesión para la confirmación.

• Si el nivel de confirmación de escritura a nivel de transacción y el nivel de confirmación de escritura a nivel de sesión no están configurados, el nivel de confirmación de escritura a nivel de transacción por defecto es el nivel de confirmación de escritura a nivel de cliente de:

  • w: "majority" en MongoDB 5.0 y posteriores, con diferencias para implementaciones que contienen árbitros. Consulte nivel de confirmación de escritura implícito por defecto.

  • w: 1

Las transacciones tienen soporte para todos los valores de w de nivel de confirmación de escritura, incluidos:

Consideraciones de Producción

Para transacciones en entornos de producción, consulte Consideraciones de producción. Además, para clústeres fragmentados, consulte Consideraciones de producción (Clústeres fragmentados).

Árbitros

No puedes cambiar una clave de fragmentación mediante una transacción si el set de réplicas tiene un árbitro. Los árbitros no pueden participar en las operaciones de datos requeridas para las transacciones de múltiples fragmentos.

Las transacciones cuyas operaciones de escritura abarcan varios fragmentos generarán un error y se abortarán si alguna operación de transacción lee o escribe en una partición que contiene un árbitro.

Restricción de configuración de fragmentos

No puedes ejecutar transacciones en un clúster que tenga una partición con writeConcernMajorityJournalDefault configurado en false (como una partición con un nodo votante que utiliza el motor de almacenamiento en memoria).

Diagnósticos

Para obtener el estado de la transacción y las métricas, utilice los siguientes métodos:

Compatibilidad de características entre versiones (FCV)

Para utilizar transacciones, la featureCompatibilityVersion de todos los miembros de la implementación debe ser al menos:

Para comprobar la compatibilidad de características entre versiones de un nodo, conéctese al nodo y ejecute el siguiente comando:

db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )

Para obtener más información, consulte la página de referencia setFeatureCompatibilityVersion.

Motores de almacenamiento

Transacciones son compatibles en conjuntos de réplicas y clústeres fragmentados donde:

• el primario utiliza el motor de almacenamiento WiredTiger, y

• los miembros secundarios utilizan el motor de almacenamiento WiredTiger o los motores de almacenamiento en memoria.

Limite el tiempo de espera de la sección crítica

A partir de MongoDB 5.2 (y 5.0.4):

• Cuando una query accede a un fragmento, una migración de fragmento o una operación DDL puede retener la sección crítica de la colección.

• Para limitar el tiempo que un fragmento espera por una sección crítica dentro de una transacción, utilice el parámetro metadataRefreshInTransactionMaxWaitMS.

  Nota

  A partir de MongoDB 8.1, el parámetro antiguo metadataRefreshInTransactionMaxWaitBehindCritSecMS se renombra a metadataRefreshInTransactionMaxWaitMS. Puedes continuar usando metadataRefreshInTransactionMaxWaitBehindCritSecMS como nombre de parámetro, pero está obsoleto y se eliminará en una versión futura de MongoDB.