Transações e Operações

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

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 collections e índices em transações. Para obter detalhes, consulte Criar collections e índices em uma transação. A coletas 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 createUser como,, e seusgetParameter count auxiliares.
Operações paralelas. Para atualizar vários namespaces simultaneamente, considere usar o comando bulkWrite.
Escreve para coleções limitadas.
Usando preocupação "snapshot" de leitura ao ler de uma collection limitada. (Começando no 5.0 MongoDB)
Leituras/gravações em coletas nos bancos de dados config, admin ou local.
Escreve para coleções system.*.
Utilizando explain ou comandos semelhantes para retornar o plano de query da operação suportada.
Chamando em cursores criados fora getMore getMore de uma transação ou chamando fora de uma transação em cursores criados dentro de uma transação.
Especificar o comando como a primeira operação em killCursors uma transação.
Observação
Se você executar o killCursors comando 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