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

  • Artykuł

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 wpłynie na istniejące dane ani indeksy.

W przypadku uaktualniania do nowej wersji interfejsu API rozpocznij od obciążeń programistycznych/testowych przed uaktualnieniem obciążeń produkcyjnych. Ważne jest, aby uaktualnić klientów do wersji zgodnej z wersją interfejsu API, do której uaktualniasz przed uaktualnieniem konta usługi Azure Cosmos DB dla bazy danych MongoDB.

Uwaga

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 uaktualniania, utwórz bilet pomocy technicznej.

Uaktualnianie do wersji 4.2, 4.0 lub 3.6

Zalety uaktualniania do wersji 4.2:

  • Kilka głównych ulepszeń potoku agregacji, takich jak obsługa $merge, trigonometrii, wyrażeń arytmetycznych i nie tylko.
  • Obsługa szyfrowania pól po stronie klienta, która dodatkowo zabezpiecza bazę danych, umożliwiając selektywne szyfrowanie poszczególnych pól i zachowanie prywatności zaszyfrowanych danych od użytkowników bazy danych i dostawców hostingu.

Zalety uaktualnienia do wersji 4.0

Poniżej przedstawiono nowe funkcje dostępne w wersji 4.0:

  • Obsługa transakcji obejmujących wiele dokumentów w kolekcjach nieudostępnianych.
  • Nowe operatory agregacji
  • Większa wydajność skanowania
  • Szybszy i wydajniejszy magazyn

Zalety uaktualnienia do wersji 3.6

Poniżej przedstawiono nowe funkcje dostępne w wersji 3.6:

  • Udoskonalona wydajność i stabilność
  • Obsługa nowych poleceń bazy danych
  • Domyślna obsługa potoków agregacji i nowe etapy agregacji
  • Obsługa zmiany strumieni
  • Obsługa indeksów złożonych
  • Obsługa następujących operacji na wielu partycjach: update, delete, count i sort
  • Ulepszona wydajność dla następujących operacji agregowania: $count, $skip, $limit i $group
  • Indeksowanie symboli wieloznacznych jest teraz obsługiwane

Zmiany w stosunku do wersji 3.2

  • Domyślnie funkcja Ponawianie po stronie serwera (SSR) jest włączona, aby żądania z aplikacji klienckiej nie zwracały błędów 16500. Zamiast tego żądania będą wznawiane do momentu zakończenia lub przekroczenia limitu czasu (60 sekund).
  • Limit czasu na żądanie jest ustawiony na 60 sekund.
  • Kolekcje usługi MongoDB utworzone w nowej wersji protokołu Wire będą mieć indeksowaną domyślnie tylko właściwość _id.

Akcja wymagana w przypadku uaktualniania z wersji 3.2

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

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ę.

Uwaga

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.

Jak przeprowadzić uaktualnianie

  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.

    Sprawdź bieżącą wersję konta bazy danych MongoDB z 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. Jeśli tak jest, utwórz bilet pomocy technicznej .

    Otwórz blok Funkcje i uaktualnij swoje 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).

    Przejrzyj wskazówki dotyczące uaktualniania i wybierz pozycję Uaktualnij.

  6. Po rozpoczęciu uaktualniania menu Funkcja jest wyszarzone, a stan jest ustawiony na Oczekujące. Ukończenie uaktualnienia trwa około 15 minut. Ten proces nie wpłynie 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. Stare parametry połączenia działające w wersji 3.2 nie zostaną przerwane. Aby zapewnić spójne środowisko, wszystkie aplikacje muszą korzystać z nowego punktu końcowego.

    2. W przypadku uaktualnienia z wersji 3.6 istniejące parametry połączenia zostaną uaktualnione do określonej wersji i powinny być nadal używane.

Jak zmienić wersję na starszą lub mniej zaawansowaną wersję

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

Jeśli przeprowadzono uaktualnienie z wersji 3.2 do wersji i chcesz wrócić do wersji 3.2, możesz po prostu przełączyć się z powrotem na poprzednie parametry połączenia (3.2) z hostem accountname.documents.azure.com , który pozostaje aktywny po uaktualnieniu w wersji 3.2.

Następne kroki