Transacciones y operaciones

Para las transacciones:

Puede crear colecciones e índices en las transacciones. Para obtener más información, consulte Crear colecciones e índices en una transacción
Las colecciones utilizadas en una transacción pueden encontrarse en diferentes bases de datos.
Nota
No puedes crear nuevas colecciones en transacciones de escritura entre particiones. Por ejemplo, si guardas en una colección existente en una partición y creas implícitamente una colección en una partición diferente, MongoDB no puede realizar ambas operaciones en la misma transacción.
No se puede escribir en colecciones con tamaño fijo.
No puedes usar la lectura de preocupación "snapshot"al leer desde una colección limitada. (A partir de MongoDB) 5.0
No puedes leer ni escribir en colecciones en las bases de datos config, admin o local.
No se puede escribir en las colecciones de system.*.
No puedes devolver el plan de query de las operaciones admitidas usando explain o comandos similares.

Para los cursores creados fuera de una transacción, no puedes llamar a getMore dentro de la transacción.
Para los cursores creados en una transacción, no puedes llamar a getMore fuera de la transacción.

No puede especificar el comando killCursors como la primera operación en una transacción.
Además, si ejecutas el comando killCursors dentro de una transacción, el servidor detiene inmediatamente los cursores especificados. No espera la confirmación de la transacción.

Operaciones admitidas en transacciones multidocumento

Operaciones CRUD

Las siguientes operaciones de lectura/escritura están permitidas en las transacciones:

Método	Comando	Nota
`db.collection.aggregate()`	`aggregate`	Excluyendo las siguientes etapas: `$collStats` `$currentOp` `$indexStats` `$listLocalSessions` `$listSessions` `$merge` `$out` `$planCacheStats` `$unionWith`
`db.collection.countDocuments()`		Excluyendo las siguientes expresiones de operador de consulta: `$where` `$near` `$nearSphere` El método utiliza la `$match` etapa de agregación para la consulta y `$group` la etapa de agregación con una `$sum` expresión para realizar el recuento.
`db.collection.distinct()`	`distinct`	Disponible en colecciones sin fragmentar. For sharded collections, use the aggregation pipeline with the `$group` stage. See Distinct Operation.
`db.collection.find()`	`find`
`db.collection.deleteMany()` `db.collection.deleteOne()` `db.collection.remove()`	`delete`
`db.collection.findOneAndDelete()` `db.collection.findOneAndReplace()` `db.collection.findOneAndUpdate()`	`findAndModify`	Si la operación de actualización o reemplazo se ejecuta con `upsert: true` en una colección no existente, la colección se crea implícitamente. Para obtener más detalles, consulte Operaciones de administración.
`db.collection.insertMany()` `db.collection.insertOne()`	`insert`	Si se ejecuta en una colección inexistente, la colección se crea implícitamente. Para obtener más detalles, consulte Operaciones de administración.
`db.collection.updateOne()` `db.collection.updateMany()` `db.collection.replaceOne()`	`update`	Si se ejecuta en una colección inexistente, la colección se crea implícitamente. Para obtener más detalles, consulte Operaciones de administración.
`db.collection.bulkWrite()` Various Bulk Operations		Si se ejecuta en una colección inexistente, la colección se crea implícitamente. Para obtener más detalles, consulte Operaciones de administración.

Nota

Actualizaciones de los valores de clave de fragmento

Puede actualizar el valor de la clave de fragmento de un documento (a menos que el campo de clave de fragmento sea el _id inmutable) mediante operaciones de actualización/findAndModify de un solo documento, ya sea en una transacción o como una escritura reintentable. Para obtener más información, consulte Cambiar el valor de la clave de fragmento de un documento.

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 administrativas

Puede crear colecciones e índices dentro de una transacción distribuida si la transacción es No es una transacción de escritura entre fragmentos.

Operaciones de creación explícitas

Comando	Método	notas
`create`	`db.createCollection()`	Consulta también las Operaciones implícitas de creación.
`createIndexes`	`db.collection.createIndex()` `db.collection.createIndexes()`	El índice a crear debe estar en una colección inexistente, en cuyo caso la colección se crea como parte de la operación, o en una nueva colección vacía creada anteriormente en la misma transacción.

Nota

Para la creación explícita de una colección o un índice dentro de una transacción, el nivel de consistencia de lectura de la transacción debe ser "local".

Para más información sobre cómo crear colecciones e índices en una transacción, consulta Crear colecciones e índices en una transacción.

Operaciones de creación implícitas

También puede crear implícitamente una colección a través de las siguientes operaciones de escritura en una colección inexistente:

Método ejecutado contra una colección inexistente	Ejecutar comando contra una colección inexistente
`db.collection.findAndModify()` with `upsert: true` `db.collection.findOneAndReplace()` with `upsert: true` `db.collection.findOneAndUpdate()` with `upsert: true`	`findAndModify` con `upsert: true`
`db.collection.insertMany()` `db.collection.insertOne()`	`insert`
`db.collection.updateOne()` with `upsert: true` `db.collection.updateMany()` with `upsert: true` `db.collection.replaceOne()` with `upsert: true`	`update` con `upsert: true`
`db.collection.bulkWrite()` with insert or `upsert:true` operations Various Bulk Operations with insert or `upsert:true` operations

Para otras operaciones CRUD permitidas en las transacciones, consulte Operaciones CRUD.

Para más información sobre cómo crear colecciones e índices en una transacción, consulta Crear colecciones e índices en una transacción.

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, pordb.createCollection() ejemplo, el método, e índices, pordb.collection.createIndexes() ejemplo, los métodos y, cuando se db.collection.createIndex() "local" utiliza un nivel de preocupación de lectura distinto de.
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.

Tip

Operaciones DDL y transacciones pendientes

Volver

API de drivers

Consideraciones de Producción