Gruppera flera åtgärder i transaktioner i Azure Cosmos DB för MongoDB vCore

GÄLLER FÖR: MongoDB vCore

Det är vanligt att man vill gruppera flera åtgärder i en enda transaktion för att antingen committa eller rulla tillbaka tillsammans. I databasprinciper implementerar transaktioner vanligtvis fyra viktiga ACID-principer . ACID står för:

• Atomicitet: Transaktioner slutförs helt eller inte alls.
• Konsekvens: Databaser övergår från ett konsekvent tillstånd till ett annat.
• Isolering: Enskilda transaktioner är avskärmade från samtidiga transaktioner.
• Hållbarhet: Slutförda transaktioner är permanenta, vilket säkerställer att data förblir konsekventa, även vid systemfel.

ACID-principerna i databashantering säkerställer att transaktioner bearbetas på ett tillförlitligt sätt. Azure Cosmos DB for MongoDB vCore implementerar dessa principer så att du kan skapa transaktioner för flera åtgärder.

Förutsättningar

• Ett befintligt Azure Cosmos DB för MongoDB vCore-kluster.
  • Om du inte har en Azure-prenumeration skapar du ett konto kostnadsfritt.
  • Om du har en befintlig Azure-prenumeration skapar du ett nytt Azure Cosmos DB för MongoDB vCore-kluster.

Skapa en transaktion

Skapa en ny transaktion med lämpliga metoder från valfritt utvecklarspråk. Dessa metoder omfattar vanligtvis en viss omslutningsmekanism för att gruppera flera transaktioner tillsammans och en metod för att genomföra transaktionen.

JavaScript

Anteckning

Exemplen i det här avsnittet förutsätter att du har en samlingsvariabel med namnet collection.

1. Använd startSession() för att skapa en klientsession för transaktionsåtgärden.

   const transactionSession = client.startSession();
   

2. Skapa en transaktion med withTransaction() och placera alla relevanta transaktionsåtgärder i återanropet.

   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. Genomför transaktionen med hjälp av commitTransaction().

   transactionSession.commitTransaction();
   

4. Använd endSession() för att avsluta transaktionssessionen.

   transactionSession.endSession();
   

Java

Kommentar

Exemplen i det här avsnittet förutsätter att du har en samlingsvariabel med namnet databaseCollection.

1. Använd startSession() för att skapa en klientsession för transaktionsåtgärden inom ett try block.

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

2. Skapa en transaktion med .startTransaction()

   session.startTransaction();
   

3. Inkludera alla relevanta transaktionsåtgärder.

   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. Genomför transaktionen med hjälp av commitTransaction().

   clientSession.commitTransaction();
   

Python

Anteckning

Exemplen i det här avsnittet förutsätter att du har en samlingsvariabel med namnet coll.

1. Använd start_session() för att skapa en klientsession för transaktionsåtgärden.

   with client.start_session() as ts:
   

2. I sessionsblocket skapar du en transaktion med hjälp av start_transaction().

   ts.start_transaction()
   

3. Inkludera alla relevanta transaktionsåtgärder.

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

4. Genomför transaktionen med hjälp av commit_transaction().

   ts.commit_transaction()
   

Återställa en transaktion

Ibland kan du behöva ångra en transaktion innan den genomförs.

JavaScript

1. Med hjälp av en befintlig transaktionssession avbryter du transaktionen med abortTransaction().

   transactionSession.abortTransaction();
   

2. Avsluta transaktionssessionen.

   transactionSession.endSession();
   

Java

1. Med hjälp av en befintlig transaktionssession avbryter du transaktionen med ().

   clientSession.abortTransaction();
   

Python

1. Med hjälp av en befintlig transaktionssession avbryter du transaktionen med abort_transaction().

   ts.abort_transaction()
   

Gå vidare

Skapa en Node.js webbapp