Uppgradera API-versionen av ditt Azure Cosmos DB för MongoDB-konto
GÄLLER FÖR: 
MongoDB
Den här artikeln beskriver hur du uppgraderar API-versionen av azure Cosmos DB:s API för MongoDB-konto. Efter uppgraderingen 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 den förbrukar inte RU/s eller minskar databasens kapacitet när som helst. Den här processen påverkar inte befintliga data eller index.
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.
Varning
För närvarande kan endast kvalificerande konton som använder serverversion 3.2 uppgraderas till version 3.6 och senare. Om ditt konto inte visar uppgraderingsalternativet kan du skicka ett supportärende.
Uppgradera din version
Logga in på Azure-portalen.
Gå till ditt Azure Cosmos DB för MongoDB-konto. Öppna fönstret Översikt och kontrollera att den aktuella serverversionen är antingen 3.2 eller 3.6.
Öppna fönstret på
Featuresden vänstra menyn. I det här fönstret visas de funktioner på kontonivå som är tillgängliga för ditt databaskonto.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.
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).
När du har påbörjat uppgraderingen är funktionsmenyn nedtonad och statusen är inställd på Väntar. Uppgraderingen tar cirka 15 minuter att slutföra. Den här processen påverkar inte befintliga funktioner eller åtgärder för ditt databaskonto. När den är klar visar uppdateringsversionen av MongoDB-servern den uppgraderade versionen. Kontakta supporten om det uppstod ett problem med att bearbeta din begäran.
Följande är några saker att tänka på när du har uppgraderat ditt konto:
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 programmet. Den gamla anslutningssträng 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.
Om du har uppgraderat från 3.6 uppgraderas din befintliga anslutningssträng till den angivna versionen och bör fortsätta att användas.
Viktigt!
När du uppgraderar från 3.2 uppdateras databaskontots slutpunktssuffix till följande format: <your_database_account_name>.mongo.cosmos.azure.com. Den här slutpunkten kan ha små skillnader om ditt konto har skapats i ett nationellt, myndighetsbaserat eller begränsat Azure-moln.
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 måste sammansatta index nu utföra sorteringsåtgärder på flera fält för att säkerställa stabila, höga prestanda för dessa frågor. Se till att dessa sammansatta index skapas så att sorteringarna för flera fält lyckas.
Nedgradera din version
Du kan också nedgradera ditt konto till 4.0 eller 3.6 via samma steg i avsnittet uppgradera din version .
Om du har uppgraderat från 3.2 till och vill nedgradera tillbaka till 3.2 växlar du tillbaka till att använda din tidigare (3.2) anslutningssträng med värden
accountname.documents.azure.com, som fortfarande är aktiv efter uppgraderingen och kör version 3.2.Ändra anslutningssträng i programmet.