Transações e Operações

O MongoDB oferece a capacidade de usar transações em diversas operações, coleções, bancos de dados, documentos e fragmentos.

Operações suportadas em transações multidocumentos

Operações CRUD

As seguintes operações de leitura/gravação são permitidas nas transações:

Método	Comando	Observação
`db.collection.aggregate()`	`aggregate`	Excluindo os seguintes estágios: `$collStats` `$currentOp` `$indexStats` `$listLocalSessions` `$listSessions` `$merge` `$out` `$planCacheStats` `$unionWith`
`db.collection.countDocuments()`		Excluindo as seguintes expressões do operador de query: `$where` `$near` `$nearSphere` O método utiliza o estágio de aggregation `$match` para a query e estágio de aggregation `$group` com uma expressão `$sum` para executar a contagem.
`db.collection.distinct()`	`distinct`	Disponível em coleções não partilhadas. 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`	Se a operação de atualização ou substituição for executada com `upsert: true` em uma coleção inexistente, a coleção será implicitamente criada. Para obter mais detalhes,consulte Operações de administração.
`db.collection.insertMany()` `db.collection.insertOne()`	`insert`	Se for executado em uma coleção inexistente, a coleção será criada implicitamente. Para obter mais detalhes,consulte Operações de administração.
`db.collection.updateOne()` `db.collection.updateMany()` `db.collection.replaceOne()`	`update`	Se for executado em uma coleção inexistente, a coleção será criada implicitamente. Para obter mais detalhes,consulte Operações de administração.
`db.collection.bulkWrite()` Various Bulk Operations		Se for executado em uma coleção inexistente, a coleção será criada implicitamente. Para obter mais detalhes,consulte Operações de administração.

Observação

Atualizações nos valores da chave de shard

Você pode atualizar o valor da chave do fragmento de um documento (a menos que o campo da chave do fragmento seja o campo imutável _id) emitindo operações de atualização/encontro de documento único e modificação em uma transação ou como escrita repetível. Para obter detalhes, consulte Alterar o valor chave do fragmento de um documento.

Operação de contagem

Para realizar uma operação de contagem dentro de uma transação, use o estágio de agregação $count ou o estágio de agregação $group (com uma expressão $sum de agregação.

Os drivers do MongoDB fornecem uma API de collection countDocuments(filter, options) como um método auxiliar que usa o $group com uma expressão $sum para executar uma contagem.

O mongosh fornece o método auxiliar db.collection.countDocuments(), que usa o $group com a expressão $sum para executar uma contagem.

Operação Distinta

Para realizar uma operação distinta dentro de uma transação:

Para coleções não fragmentadas, você pode usar o db.collection.distinct() método /o distinct comando , bem como o pipeline de agregação com o estágio $group .
Para coleções fragmentadas, você não pode utilizar o método db.collection.distinct() ou o comando distinct.
Para localizar os valores distintos para uma coleção fragmentada, use o pipeline de agregação com o estágio $group. Por exemplo:
- Em vez de db.coll.distinct("x"), use
  db.coll.aggregate([ { $group: { _id: null, distinctValues: { $addToSet: "$x" } } }, { $project: { _id: 0 } } ])
- Em vez de db.coll.distinct("x", { status: "A" }), use:
  db.coll.aggregate([ { $match: { status: "A" } }, { $group: { _id: null, distinctValues: { $addToSet: "$x" } } }, { $project: { _id: 0 } } ])
O pipeline retorna um cursor para um documento:
```
{ "distinctValues" : [ 2, 3, 1 ] }
```
Itere o cursor para acessar o documento de resultados.

Operações de administração

Você pode criar coleções e índices em transações. Para obter detalhes, consulte Criar coleções e índices em uma transação. As coleções utilizadas em uma transação podem estar em diferentes bancos de dados.

Observação

Você não pode criar uma nova coleta em transações de gravação entre fragmentos. Por exemplo, se você gravar em uma coleta existente em um fragmento e criar implicitamente uma coleta em um fragmento diferente, o MongoDB não poderá executar ambas as operações na mesma transação.

Você pode criar coleção e indexes dentro de uma transaction distribuída se a transaction não for uma transação de escrita de estilhaço cruzado.

Operações de criação explícitas

Comando	Método	Notas
`create`	`db.createCollection()`	Consulte também as Operações de criação implícitas.
`createIndexes`	`db.collection.createIndex()` `db.collection.createIndexes()`	O índice a criar tem de estar numa recolha não existente, caso em que a recolha é criada como parte da operação, ou numa nova recolha vazia criada anteriormente na mesma transação.

Observação

Para a criação explícita de uma collection ou de um índice em uma transação, o nível de read concern da transação deve ser "local".

Para obter mais informações sobre como criar coleções e índices em uma transação, consulte Criar coleções e índices em uma transação.

Operações de criação implícitas

Você também pode criar implicitamente uma coleção por meio das seguintes operações de gravação em uma coleção não existente:

Método executado em uma coleção inexistente	Comando Executar em collection inexistente
`db.collection.findAndModify()` with `upsert: true` `db.collection.findOneAndReplace()` with `upsert: true` `db.collection.findOneAndUpdate()` with `upsert: true`	`findAndModify` com `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` com `upsert: true`
`db.collection.bulkWrite()` with insert or `upsert:true` operations Various Bulk Operations with insert or `upsert:true` operations

Para outras operações CRUD permitidas em transações, consulte Operações CRUD.

Para obter mais informações sobre como criar coleções e índices em uma transação, consulte Criar coleções e índices em uma transação.

Operações Informativas

Comandos informativos, como hello, buildInfo, connectionStatus (e seus métodos de ajuda) são permitidos em transações; no entanto, eles não podem ser a primeira operação na transação.

Operações Restritas

As seguintes operações não são permitidas nas transações:

Criação de nova coleta em transações de gravação entre fragmentos. Por exemplo, se você gravar em uma coleta existente em um fragmento e criar implicitamente uma coleta em um fragmento diferente, o MongoDB não poderá executar ambas as operações na mesma transação.
Criação explícita de coleções, por exemplo, Método db.createCollection() e índices, por exemplo, db.collection.createIndexes() e métodos db.collection.createIndex() ao utilizar um nível de preocupação de leitura diferente de "local".
Os comandos listCollections e listIndexes e seus métodos de auxiliar.
Outras operações não CRUD e não informacionais, tais como createUser, getParameter, count e seus assistentes.
Operações paralelas. Para atualizar vários namespaces simultaneamente, considere usar o comando bulkWrite.
Grava para coleções limitadas.
Usando preocupação de leitura "snapshot" ao ler de uma coleção limitada. (Começando no MongoDB 5.0)
Leituras/gravações em coleções nos bancos de dados config, admin ou local.
Grava para system.* coleções.
Utilizando explain ou comandos semelhantes para retornar o plano de query da operação suportada.
Chamando getMore em cursores criados fora de uma transação ou chamando getMore fora de uma transação em cursores criados dentro de uma transação.
Especificar o comando killCursors como a primeira operação em uma transação.
Observação
Se você executar o comando killCursors dentro de uma transação, o servidor interromperá imediatamente os cursores especificados. Não espera que a transação seja confirmada.

Dica

Operações e Transações DDL Pendentes

Voltar

API de drivers

Considerações de produção