Meerdere bewerkingen groeperen in transacties in Azure Cosmos DB voor MongoDB vCore

VAN TOEPASSING OP: MongoDB vCore

Het is gebruikelijk om meerdere bewerkingen te groeperen in één transactie om samen te zetten of terug te draaien. In databaseprincipes implementeren transacties doorgaans vier belangrijke ACID-principes . ACID staat voor:

• Atomiciteit: Transacties worden helemaal voltooid of helemaal niet.
• Consistentie: Databases gaan van de ene consistente status naar de andere.
• Isolatie: afzonderlijke transacties worden afgeschermd van gelijktijdige transacties.
• Duurzaamheid: voltooide transacties zijn permanent, zodat gegevens consistent blijven, zelfs tijdens systeemfouten.

De ACID-principes in databasebeheer zorgen ervoor dat transacties betrouwbaar worden verwerkt. Azure Cosmos DB voor MongoDB vCore implementeert deze principes, zodat u transacties voor meerdere bewerkingen kunt maken.

Vereisten

• Een bestaand Azure Cosmos DB voor MongoDB vCore-cluster.
  • Als u geen Azure-abonnement hebt, maakt u gratis een account.
  • Als u een bestaand Azure-abonnement hebt, maakt u een nieuw Azure Cosmos DB voor MongoDB vCore-cluster.

Een transactie maken

Maak een nieuwe transactie met behulp van de juiste methoden uit de taal voor ontwikkelaars van uw keuze. Deze methoden bevatten doorgaans een wrappingmechanisme om meerdere transacties samen te groeperen en een methode om de transactie vast te leggen.

JavaScript

Notitie

In de voorbeelden in deze sectie wordt ervan uitgegaan dat u een verzamelingsvariabele hebt met de naam collection.

1. Hiermee startSession() maakt u een clientsessie voor de transactiebewerking.

   const transactionSession = client.startSession();
   

2. Maak een transactie met behulp van withTransaction() en plaats alle relevante transactiebewerkingen binnen de callback.

   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);
   });
   

3. Voer de transactie door met behulp van commitTransaction().

   transactionSession.commitTransaction();
   

4. Gebruik endSession() dit om de transactiesessie te beëindigen.

   transactionSession.endSession();
   

Java

Notitie

In de voorbeelden in deze sectie wordt ervan uitgegaan dat u een verzamelingsvariabele hebt met de naam databaseCollection.

1. Hiermee startSession() maakt u een clientsessie voor de transactiebewerking binnen een try blok.

   try (ClientSession session = client.startSession()) {
   }
   

2. Een transactie maken met behulp van startTransaction().

   session.startTransaction();
   

3. Neem alle relevante transactiebewerkingen op.

   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));
   

4. Voer de transactie door met behulp van commitTransaction().

   clientSession.commitTransaction();
   

Python

Notitie

In de voorbeelden in deze sectie wordt ervan uitgegaan dat u een verzamelingsvariabele hebt met de naam coll.

1. Hiermee start_session() maakt u een clientsessie voor de transactiebewerking.

   with client.start_session() as ts:
   

2. Maak binnen het sessieblok een transactie met behulp van start_transaction().

   ts.start_transaction()
   

3. Neem alle relevante transactiebewerkingen op.

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

4. Voer de transactie door met behulp van commit_transaction().

   ts.commit_transaction()
   

Een transactie terugdraaien

Soms moet u een transactie mogelijk ongedaan maken voordat deze wordt doorgevoerd.

JavaScript

1. Als u een bestaande transactiesessie gebruikt, moet u de transactie afbreken met abortTransaction().

   transactionSession.abortTransaction();
   

2. Beëindig de transactiesessie.

   transactionSession.endSession();
   

Java

1. Als u een bestaande transactiesessie gebruikt, moet u de transactie afbreken met ().

   clientSession.abortTransaction();
   

Python

1. Als u een bestaande transactiesessie gebruikt, moet u de transactie afbreken met abort_transaction().

   ts.abort_transaction()
   

Volgende stap

Een Node.js-webtoepassing maken