Udostępnij za pośrednictwem


Uaktualnianie wersji interfejsu API konta usługi Azure Cosmos DB dla bazy danych MongoDB

DOTYCZY: MongoDB

W tym artykule opisano sposób uaktualniania wersji interfejsu API interfejsu API usługi Azure Cosmos DB dla konta bazy danych MongoDB. Po uaktualnieniu możesz użyć najnowszych funkcji w interfejsie API usługi Azure Cosmos DB dla bazy danych MongoDB. Proces uaktualniania nie przerywa dostępności konta i nie zużywa jednostek RU/s ani nie zmniejsza pojemności bazy danych w żadnym momencie. Ten proces nie ma wpływu na istniejące dane ani indeksy.

Podczas uaktualniania do nowej wersji interfejsu API zacznij od obciążeń programistycznych/testowych przed uaktualnieniem obciążeń produkcyjnych. Przed uaktualnieniem konta usługi Azure Cosmos DB dla bazy danych MongoDB ważne jest uaktualnienie klientów do wersji zgodnej z wersją interfejsu API.

Ostrzeżenie

W tej chwili tylko kwalifikujące się konta korzystające z serwera w wersji 3.2 można uaktualnić do wersji 3.6 lub nowszej. Jeśli Twoje konto nie wyświetla opcji uaktualnienia, utwórz bilet pomocy technicznej.

Uaktualnianie wersji

  1. Zaloguj się do Azure Portal.

  2. Przejdź do konta usługi Azure Cosmos DB dla bazy danych MongoDB. Otwórz okienko Przegląd i sprawdź, czy bieżąca wersja serwera to 3.2 lub 3.6.

    Zrzut ekranu przedstawiający sprawdzanie bieżącej wersji konta bazy danych MongoDB w witrynie Azure Portal.

  3. W menu po lewej stronie otwórz Features okienko. W tym okienku są wyświetlane funkcje na poziomie konta, które są dostępne dla konta bazy danych.

  4. Zaznacz wiersz Upgrade MongoDB server version. Jeśli ta opcja nie jest widoczna, Twoje konto może nie kwalifikować się do tego uaktualnienia. Utwórz bilet pomocy technicznej, jeśli tak jest.

    Zrzut ekranu przedstawiający stronę funkcji , aby uaktualnić konto.

  5. Przejrzyj wyświetlone informacje o uaktualnieniu. Wybierz Set server version to 4.2 pozycję (lub 4.0 lub 3.6 w zależności od bieżącej wersji).

    Zrzut ekranu przedstawiający wskazówki dotyczące uaktualniania i opcję wybierz uaktualnienie.

  6. Po uruchomieniu uaktualnienia menu Funkcja jest wyszarzone, a stan jest ustawiony na Oczekujące. Ukończenie uaktualnienia trwa około 15 minut. Ten proces nie ma wpływu na istniejące funkcje ani operacje konta bazy danych. Po zakończeniu aktualizacji stanu wersji serwera MongoDB zostanie wyświetlona uaktualniona wersja. Skontaktuj się z pomocą techniczną , jeśli wystąpił problem podczas przetwarzania żądania.

  7. Poniżej przedstawiono niektóre zagadnienia dotyczące uaktualniania konta:

    1. W przypadku uaktualnienia z wersji 3.2 wróć do okienka Przegląd i skopiuj nowe parametry połączenia do użycia w aplikacji. Stary parametry połączenia z systemem 3.2 nie jest przerywany. Aby zapewnić spójne środowisko, wszystkie aplikacje muszą korzystać z nowego punktu końcowego.

    2. W przypadku uaktualnienia z wersji 3.6 istniejąca parametry połączenia zostanie uaktualniona do określonej wersji i powinna być nadal używana.

Ważne

Podczas uaktualniania z wersji 3.2 sufiks punktu końcowego konta bazy danych zostanie zaktualizowany do następującego formatu: <your_database_account_name>.mongo.cosmos.azure.com. Ten punkt końcowy może mieć niewielkie różnice, jeśli twoje konto zostało utworzone w suwerennej, rządowej lub ograniczonej chmurze platformy Azure.

W przypadku uaktualniania z wersji 3.2 należy zastąpić istniejący punkt końcowy w aplikacjach i sterownikach łączących się z tym kontem bazy danych. Tylko połączenia korzystające z nowego punktu końcowego będą miały dostęp do funkcji w nowej wersji interfejsu API. Poprzedni punkt końcowy w wersji 3.2 powinien mieć sufiks .documents.azure.com. Podczas uaktualniania z wersji 3.2 do nowszych indeksy złożone są teraz wymagane do wykonywania operacji sortowania na wielu polach w celu zapewnienia stabilnej, wysokiej wydajności dla tych zapytań. Upewnij się, że te indeksy złożone są tworzone, aby sortowanie wielu pól powiodło się.

Obniżanie wersji

Możesz również obniżyć poziom konta do wersji 4.0 lub 3.6, wykonując te same kroki w sekcji Uaktualnianie wersji .

  1. Jeśli uaktualniono z wersji 3.2 do wersji i chcesz wrócić do wersji 3.2, wróć do poprzedniego (3.2) parametry połączenia z hostem accountname.documents.azure.com, który pozostaje aktywny po uaktualnieniu w wersji 3.2.

  2. Zmień parametry połączenia w aplikacji.