Uppgradera API-versionen av ditt Azure Cosmos DB for MongoDB-konto

  • Artikel

GÄLLER FÖR: Mongodb

I den här artikeln beskrivs hur du uppgraderar API-versionen av Ditt Azure Cosmos DB:s API för MongoDB-konto. När du har uppgraderat kan du använda de senaste funktionerna i Azure Cosmos DB:s API för MongoDB. Uppgraderingsprocessen avbryter inte tillgängligheten för ditt konto och förbrukar inte RU/s eller minskar databasens kapacitet när som helst. Inga befintliga data eller index påverkas av den här processen.

När du uppgraderar till en ny API-version börjar du med utvecklings-/testarbetsbelastningar innan du uppgraderar produktionsarbetsbelastningar. Det är viktigt att uppgradera dina klienter till en version som är kompatibel med den API-version som du uppgraderar till innan du uppgraderar ditt Azure Cosmos DB för MongoDB-konto.

Anteckning

För närvarande kan endast kvalificerade konton som använder serverversion 3.2 uppgraderas till version 3.6 och senare. Om ditt konto inte visar uppgraderingsalternativet skapar du ett supportärende.

Uppgradera till 4.2, 4.0 eller 3.6

Fördelar med att uppgradera till version 4.2:

  • Flera större förbättringar av aggregeringspipelinen, till exempel stöd för $merge, Trigonometry, aritmetiska uttryck med mera.
  • Stöd för uppslagning på klientsidan som ytterligare skyddar databasen genom att göra det möjligt att selektivt kryptera enskilda fält och upprätthålla sekretessen för krypterade data från databasanvändare och värdleverantörer.

Fördelar med att uppgradera till version 4.0

Följande är de nya funktionerna som ingår i version 4.0:

  • Stöd för transaktioner med flera dokument i ohardade samlingar.
  • Nya sammansättningsoperatorer
  • Förbättrad genomsökningsprestanda
  • Snabbare, effektivare lagring

Fördelar med att uppgradera till version 3.6

Följande är de nya funktionerna som ingår i version 3.6:

  • Bättre prestanda och stabilitet
  • Stöd för nya databaskommandon
  • Stöd för sammansättningspipeline som standard samt nya aggregeringsfaser
  • Stöd för ändringsströmmar
  • Stöd för sammansatta index
  • Stöd för följande åtgärder mellan olika partitioner: update, delete, count och sort
  • Bättre prestanda för följande aggregeringsåtgärder: $count, $skip, $limit och $group
  • Nu finns stöd för indexering med jokertecken

Ändringar från version 3.2

  • Som standard är funktionen för återförsök på serversidan (SSR) aktiverad, så att begäranden från klientprogrammet inte returnerar 16500-fel. I stället återupptas begäranden tills de har slutförts eller nått tidsgränsen på 60 sekunder.
  • Tidsgränsen för begäranden är inställd på 60 sekunder.
  • Endast _id-egenskapen indexeras som standard för MongoDB-samlingar som skapats på den nya trådprotokollversionen.

Åtgärd krävs vid uppgradering från 3.2

När du uppgraderar från 3.2 uppdateras databaskontots slutpunktssuffix till följande format:

<your_database_account_name>.mongo.cosmos.azure.com

Om du uppgraderar från version 3.2 måste du ersätta den befintliga slutpunkten i dina program och drivrutiner som ansluter till det här databaskontot. Endast anslutningar som använder den nya slutpunkten får tillgång till funktionerna i den nya API-versionen. Den tidigare 3.2-slutpunkten ska ha suffixet .documents.azure.com.

När du uppgraderar från 3.2 till nyare versioner krävs nu sammansatta index för att utföra sorteringsåtgärder på flera fält för att säkerställa stabila och höga prestanda för dessa frågor. Se till att dessa sammansatta index skapas så att sorteringarna för flera fält lyckas.

Anteckning

Den här slutpunkten kan ha små skillnader om ditt konto har skapats i ett nationellt Azure-moln, ett myndighetsmoln eller ett begränsat Azure-moln.

Så här uppgraderar du

  1. Logga in på Azure Portal.

  2. Gå till ditt Azure Cosmos DB för MongoDB-konto. Öppna fönstret Översikt och kontrollera att din aktuella serverversion är antingen 3.2 eller 3.6.

    Kontrollera den aktuella versionen av ditt MongoDB-konto från Azure Portal.

  3. Öppna fönstret i Features den vänstra menyn. Det här fönstret visar de funktioner på kontonivå som är tillgängliga för ditt databaskonto.

  4. Välj raden Upgrade MongoDB server version. Om du inte ser det här alternativet kanske kontot inte är kvalificerat för den här uppgraderingen. Skicka in ett supportärende om så är fallet.

    Öppna bladet Funktioner och uppgradera ditt konto.

  5. Granska informationen som visas om uppgraderingen. Välj Set server version to 4.2 (eller 4.0 eller 3.6 beroende på din aktuella version).

    Läs uppgraderingsvägledningen och välj uppgradera.

  6. När du har startat uppgraderingen är funktionsmenyn nedtonad och statusen är väntande. Uppgraderingen tar cirka 15 minuter att slutföra. Den här processen påverkar inte databaskontots befintliga funktioner eller åtgärder. När det är klart visar uppdateringsstatusen för MongoDB-servern den uppgraderade versionen. Kontakta supporten om det uppstod ett problem med att bearbeta din begäran.

  7. Följande är några saker att tänka på när du har uppgraderat ditt konto:

    1. Om du har uppgraderat från 3.2 går du tillbaka till fönstret Översikt och kopierar den nya anslutningssträngen som ska användas i ditt program. Den gamla anslutningssträngen som kör 3.2 avbryts inte. För att säkerställa en konsekvent upplevelse måste alla program använda den nya slutpunkten.

    2. Om du har uppgraderat från 3.6 uppgraderas den befintliga anslutningssträngen till den angivna versionen och ska fortsätta att användas.

Så här nedgraderar du

Du kan också nedgradera ditt konto till 4.0 eller 3.6 via samma steg i avsnittet Så här uppgraderar du.

Om du har uppgraderat från 3.2 till och vill nedgradera tillbaka till 3.2 kan du helt enkelt växla tillbaka till att använda din tidigare (3.2) anslutningssträng med värden accountname.documents.azure.com som förblir aktiv efter uppgraderingen och kör version 3.2.

Nästa steg