Agrupar várias operações em transações no Azure Cosmos DB para MongoDB vCore

Artigo
08/15/2024

APLICA-SE A: MongoDB vCore

É comum querer agrupar várias operações em uma única transação para confirmar ou reverter juntas. Nos princípios de banco de dados, as transações normalmente implementam quatro princípios ACID fundamentais. ACID significa:

Atomicidade: As transações são concluídas totalmente ou não são concluídas.
Consistência: os bancos de dados transitam de um estado consistente para outro.
Isolamento: As transações individuais são protegidas das simultâneas.
Durabilidade: As transações concluídas são permanentes, garantindo que os dados permaneçam consistentes, mesmo durante falhas do sistema.

Os princípios ACID no gerenciamento de banco de dados garantem que as transações sejam processadas de forma confiável. O Azure Cosmos DB para MongoDB vCore implementa esses princípios, permitindo que você crie transações para várias operações.

Pré-requisitos

Um cluster vCore existente do Azure Cosmos DB para MongoDB.
- Se você não tiver uma assinatura do Azure, crie uma conta gratuitamente.
- Se você tiver uma assinatura existente do Azure, crie um novo cluster vCore do Azure Cosmos DB para MongoDB.

Criar uma transação

Crie uma nova transação usando os métodos apropriados a partir da linguagem de desenvolvedor de sua escolha. Esses métodos geralmente incluem algum mecanismo de encapsulamento para agrupar várias transações e um método para confirmar a transação.

Nota

Os exemplos nesta seção pressupõem que você tenha uma variável de coleção chamada collection.

Use startSession() para criar uma sessão de cliente para a operação de transação.
```
const transactionSession = client.startSession();
```

Crie uma transação usando withTransaction() e coloque todas as operações de transação relevantes no retorno de chamada.

await transactionSession.withTransaction(async () => {
    await collection.insertOne({ name: "Coolarn shirt", price: 38.00 }, transactionSession);
    await collection.insertOne({ name: "Coolarn shirt button", price: 1.50 }, transactionSession);
});

Confirme a transação usando commitTransaction()o .
```
transactionSession.commitTransaction();
```
Use endSession() para encerrar a sessão de transação.
```
transactionSession.endSession();
```

Nota

Os exemplos nesta seção pressupõem que você tenha uma variável de coleção chamada databaseCollection.

Use startSession() para criar uma sessão de cliente para a operação de transação dentro de um try bloco.
```
try (ClientSession session = client.startSession()) {
}
```
Crie uma transação usando startTransaction()o .
```
session.startTransaction();
```

Inclua todas as operações de transação relevantes.

collection.insertOne(session, new Document().append("name", "Coolarn shirt").append("price", 38.00));
collection.insertOne(session, new Document().append("name", "Coolarn shirt button").append("price", 1.50));

Confirme a transação usando commitTransaction()o .
```
clientSession.commitTransaction();
```

Nota

Os exemplos nesta seção pressupõem que você tenha uma variável de coleção chamada coll.

Use start_session() para criar uma sessão de cliente para a operação de transação.
```
with client.start_session() as ts:
```
Dentro do bloco de sessão, crie uma transação usando start_transaction()o .
```
ts.start_transaction()
```

Inclua todas as operações de transação relevantes.

coll.insert_one({ 'name': 'Coolarn shirt', 'price': 38.00 }, session=ts)
coll.insert_one({ 'name': 'Coolarn shirt button', 'price': 1.50 }, session=ts)

Confirme a transação usando commit_transaction()o .
```
ts.commit_transaction()
```

Reverter uma transação

Ocasionalmente, pode ser necessário desfazer uma transação antes que ela seja confirmada.

Usando uma sessão de transação existente, anule a transação com abortTransaction().
```
transactionSession.abortTransaction();
```
Encerre a sessão de transação.
```
transactionSession.endSession();
```

Próximo passo

Criar um aplicativo Web Node.js

Partilhar via

Agrupar várias operações em transações no Azure Cosmos DB para MongoDB vCore

Pré-requisitos

Criar uma transação

Reverter uma transação

Próximo passo

Comentários

Recursos adicionais