Transações

Crie coleções e índices em uma transação

É possível executar as seguintes operações em uma transação distribuída quando a transação não é uma transação de gravação entre fragmentos:

• Criar coleções

• Crie índices na nova coleta vazia criada anteriormente na mesma transação.

Ao criar uma coleta dentro de uma transação:

• Você pode criar uma coleção de forma implicativa, como:

  • uma operação insert para uma coleção inexistente, ou

  • uma operação update/findAndModify com upsert: true para uma coleção inexistente.

• Você pode criar uma coleção explicitamente utilizando o comando create ou seu auxiliar db.createCollection().

Ao criar um índice dentro de uma transação [1], o índice a ser criado deve estar em:

• uma coleção inexistente. A coleção é criada como parte da operação.

• uma nova coleta vazia criada anteriormente na mesma transação.

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. A API count() está obsoleta.

mongosh fornece o método auxiliar db.collection.countDocuments() que usa o $group com uma 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 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 db.collection.createIndex() métodos, ao usar um nível de read concern diferente "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, etc. e seus auxiliares.

Transações e preferência de leitura

As operações em uma transação usam a preferência de leituraem nível de transação.

Usando os drivers, você pode definir a preferência de leitura no nível da transação no início da transação:

• Se a preferência de leitura no nível da transação não estiver definida, a transação usará a preferência de leitura no nível da sessão.

• Se a read preference da transação e da sessão não estiver definida, a transação usará a read preference do cliente. Por padrão, a read preference do cliente é primary.

Transações distribuídas que contêm operações de leitura devem utilizar a read preference primary. Todas as operações em uma determinada transação devem ser roteadas para o mesmo membro.

Transações e preocupação de leitura

As operações em uma transação usam preocupação de leitura no nível da transação. Isso significa que uma preocupação de leitura definida no nível da coleção e do banco de dados é ignorada na transação.

Você pode definir a preocupação de leitura no nível da transação no início da transação.

• Se a preocupação de leitura no nível da transação não estiver definida, a preocupação de leitura no nível da transação será padronizada para a preocupação de leitura no nível da sessão.

• Se a preocupação de leitura no nível da transação e no nível da sessão não estiverem definidos, a preocupação de leitura no nível da transação será padronizada para a preocupação de leitura no nível do cliente. Por padrão, a preocupação de leitura no nível do cliente é "local" para leituras no primário. Veja também:

  • Transações e preferência de leitura

  • Preocupações de leitura/preocupações de gravação padrão do MongoDB

As transações suportam os seguintes níveis de preocupação de leitura:

Transações e preocupações com escrita

As transações usam a preocupação de gravação em nível de transação para confirmar as operações de gravação As operações de gravação dentro das transações devem ser executadas sem uma especificação explícita de preocupação de gravação e usar a preocupação de gravação padrão. No momento de confirmação, as gravações são confirmadas usando a preocupação de gravação no nível da transação.

Você pode definir a write concern no nível da transação no início da transação:

• Se a preocupação de gravação no nível da transação não estiver definida, a preocupação de gravação no nível da transação será padronizada para a preocupação de gravação no nível da sessão para o commit.

• Se a preocupação de gravação no nível da transação e a preocupação de gravação no nível da sessão não estiverem definidas, a preocupação de gravação no nível da transação será padronizada para a preocupação de gravação no nível do cliente de:

  • w: "majority" no MongoDB 5.0 e posterior, com diferenças para implantações contendo arbiters. Consulte Write concern padrão implícita.

  • w: 1

As transações suportam todos os valores w de preocupação de gravação, incluindo:

Considerações de produção

Para transações em ambientes de produção, consulte Considerações de produção. Além disso, para clusters fragmentados, consulte Considerações de produção (clusters fragmentados).

Árbitros

As transações cujas operações de gravação abrangem vários fragmentos gerarão o erro e serão abortadas se qualquer operação de transação ler ou gravar em um fragmento que contenha um árbitro.

Restrição de configuração de fragmento

Não é possível executar transações em um cluster fragmentado que tenha um shard com writeConcernMajorityJournalDefault definido como false (como um shard com um membro votante que usa o mecanismo de armazenamento na memória).

Diagnóstico

Para obter o status e as métricas da transação, use os seguintes métodos:

Versão de compatibilidade de recursos (fCV)

Para usar transações, a featureCompatibilityVersion para todos os membros da implantação deve ser pelo menos:

Para verificar o fCV de um membro, conecte-se ao membro e execute o comando:

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

Para mais informações, consulte a página de referência do setFeatureCompatibilityVersion.

Storage Engines

As transações distribuídas são compatíveis com conjuntos de réplicas e clusters fragmentados onde:

• o primário usa o mecanismo de armazenamento WiredTiger e

• os membros secundários usam o mecanismo de armazenamento WiredTiger ou os mecanismos de armazenamento na memória .

Limitar o tempo de espera da seção crítica

A partir do MongoDB 5.2 (e 5.0.4):

• Quando uma query acessa um fragmento, uma migração de bloco ou operação de DDL pode manter a seção crítica para a coleta.

• Para limitar o tempo que um fragmento espera por uma seção crítica em uma transação, use o parâmetro metadataRefreshInTransactionMaxWaitBehindCritSecMS.