Rozszerzenie migracji rdzeni wirtualnych usługi Azure Cosmos DB dla bazy danych MongoDB dla usługi Azure Data Studio (wersja zapoznawcza)

  • Artykuł

Rozszerzenie migracji usługi Azure Cosmos DB dla bazy danych MongoDB ułatwia migrowanie obciążeń bazy danych MongoDB do usługi Azure Cosmos DB. Za pomocą tego rozszerzenia możesz wykonać następujące czynności:

  • Uruchom kompleksową ocenę obciążenia i zapoznaj się z niezbędnymi działaniami, które należy wykonać, aby przeprowadzić migrację obciążeń do usługi Azure Cosmos DB dla rdzeni wirtualnych bazy danych MongoDB.
  • Wykonaj operację migracji z wybranymi bazami danych i kolekcjami w usłudze Azure Cosmos DB dla rdzeni wirtualnych bazy danych MongoDB.

Ważne

Obecnie to rozszerzenie nie obsługuje następujących scenariuszy:

  • Migracja online dla usługi Azure Cosmos DB dla rdzeni wirtualnych bazy danych MongoDB.
  • Migracje online/offline dla usługi Azure Cosmos DB dla jednostek RU bazy danych MongoDB.

Aby uzyskać więcej informacji na temat alternatywnych rozwiązań dla interfejsu API dla rdzeni wirtualnych bazy danych MongoDB, zobacz opcje migracji.

Wymagania wstępne

Przygotowywanie

Przed rozpoczęciem migracji przed rozpoczęciem migracji należy przeprowadzić wcześniejsze planowanie i podejmowanie decyzji dotyczących migracji, zanim rzeczywiście przeniesiesz jakiekolwiek dane.

Instalowanie rozszerzenia

Przed rozpoczęciem migracji zainstaluj rozszerzenie migracji usługi Azure Cosmos DB dla bazy danych MongoDB w narzędziu Azure Data Studio.

  1. Otwórz menedżera rozszerzeń w narzędziu Azure Data Studio. Wybierz ikonę rozszerzeń lub wybierz pozycję Rozszerzenia w menu Widok.

  2. Na pasku wyszukiwania wprowadź Cosmos.

  3. Wybierz rozszerzenie Azure Cosmos DB Migration for MongoDB i wyświetl jego szczegóły.

    Zrzut ekranu przedstawiający przycisk instalacji rozszerzenia migracji usługi Azure Cosmos DB dla bazy danych MongoDB.

  4. Wybierz Zainstaluj.

Konfigurowanie ustawień rozszerzenia

Niektóre ustawienia rozszerzenia można skonfigurować po zainstalowaniu rozszerzenia. To krok jest opcjonalny. Jeśli żadne ustawienia nie są jawnie skonfigurowane, rozszerzenie używa ustawień domyślnych.

  1. Przejdź do pozycji Rozszerzenia i wybierz pozycję Migracja usługi Azure Cosmos DB dla bazy danych MongoDB, wybierz ikonę zarządzania ustawieniami, a następnie wybierz pozycję Ustawienia rozszerzenia.

    Zrzut ekranu przedstawiający wybór ustawień rozszerzenia.

  2. W obszarze ustawienia rozszerzenia dla tego rozszerzenia podaj wartość Assessment path , aby zmienić lokalizację, w której są przechowywane metadane oceny. Jeśli pole pozostanie puste, zostanie użyta lokalizacja domyślna.

Połączenie do źródła bazy danych MongoDB

Użyj rozszerzenia po raz pierwszy, aby nawiązać połączenie z istniejącym wystąpieniem "źródłowym" bazy danych MongoDB. Przed rozpoczęciem tej sekcji upewnij się, że masz poświadczenia połączenia dla źródła gotowego.

  1. Znajdź ikonę połączeń na pasku menu i wybierz pozycję Nowy Połączenie ion.

    Zrzut ekranu przedstawiający pasek menu połączeń w rozszerzeniu.

  2. W okienku Połączenie ion wypełnij następujące pola:

    Wartość
    Connection type (Typ połączenia) Azure Cosmos DB for MongoDB
    ciąg/parametry Połączenie ion Użyj parametry połączenia lub parametrów dla istniejącego źródłowego wystąpienia bazy danych MongoDB.
    Server group (Grupa serwerów) Default
    Name (optional) (Nazwa — opcjonalnie) Podaj unikatową nazwę dla tego połączenia.

  3. Wybierz pozycję Połącz.

  4. Otwórz menu kontekstowe nowego połączenia w okienku Połączenie ions. Następnie wybierz pozycję Zarządzaj.

    Zrzut ekranu przedstawiający ekran Zarządzanie bazą danych.

  5. Wybierz pozycję Migracja usługi Azure Cosmos DB.

    Zrzut ekranu przedstawiający ekran bazy danych oceny migracji.

Uruchamianie oceny

Ocena sprawdza bieżące wykorzystanie i wykorzystanie danych bazy danych MongoDB. Następnie funkcja oceny generuje kompleksowy raport, który pomaga zidentyfikować niezbędne działania, które należy wykonać przed migracją obciążeń do usługi Azure Cosmos DB dla bazy danych MongoDB.

  1. Znajdź i przejdź do karty Pulpit nawigacyjny . Następnie wybierz pozycję Oceń i migruj bazy danych.

    Zrzut ekranu przedstawiający kartę Pulpit nawigacyjny w ramach funkcji migracji rozszerzenia.

  2. Ukończ kreatora, aby podać szczegóły rozszerzenia, aby umożliwić przeprowadzenie oceny.

    Zrzut ekranu przedstawiający szczegóły oceny przed zweryfikowaniem poświadczeń.

    1. W polu Nazwa oceny wprowadź tytuł.

    2. Wybierz docelowe konto usługi Azure Cosmos DB dla bazy danych MongoDB z listy rozwijanej Oferta .

    3. Podaj ścieżkę do dzienników bazy danych MongoDB.

      Napiwek

      Jest to pole opcjonalne, które zapewnia, że ścieżka dzienników daje bardziej szczegółowe informacje na poziomie kolekcji. Gdy folder dziennika nie zostanie określony, narzędzie opiera się na informacjach z serverStatus polecenia oceny. Pamiętaj, że polecenie "serverStatus" zgłasza użycie funkcji tylko od czasu ostatniego ponownego uruchomienia serwera. Aby uzyskać ocenę, która dokładnie odzwierciedla rzeczywiste obciążenie, upewnij się, że upłynął wystarczający czas od czasu ostatniego ponownego uruchomienia serwera.

    4. Podaj ścieżkę do dzienników oceny danych.

      Napiwek

      Chociaż to pole pozostaje opcjonalne, w tym dzienniki oceny danych, mogą oferować bardziej szczegółowy wgląd w obciążenie. Te dzienniki są uzyskiwane przez skanowanie danych i przeglądanie szczegółowych dzienników. Ocena danych jest wykonywana niezależnie jako interfejs wiersza polecenia (CLI) przed zainicjowaniem oceny migracji, a wynikowy kod JSON jest następnie udostępniany tutaj. Pobierz interfejs wiersza polecenia oceny danych tutaj.

    5. Wybierz pozycję Uruchom walidację , aby zweryfikować dane wejściowe oceny.

  3. Po pomyślnym zakończeniu walidacji wybierz pozycję Rozpocznij ocenę , aby uruchomić ocenę.

    Zrzut ekranu przedstawiający szczegóły oceny po zweryfikowaniu poświadczeń.

  4. W zależności od rozmiaru serwera źródłowego ocena trwa kilka minut. Przed kontynuowaniem poczekaj na ukończenie oceny.

    Zrzut ekranu przedstawiający nową ocenę w toku.

  5. Po zakończeniu oceny powinien zostać wyświetlony raport oceny.

    Zrzut ekranu przedstawiający nowy raport oceny dla źródłowego wystąpienia bazy danych MongoDB.

  6. W raporcie oceny wybierz nazwę wystąpienia, aby przejrzeć listę problemów dotyczących całego serwera. Wybierz określoną bazę danych, aby wyświetlić problemy, które mają zastosowanie tylko do wybranej bazy danych.

    Zrzut ekranu przedstawiający nowy raport oceny dla wybranej bazy danych w źródłowym wystąpieniu bazy danych MongoDB.

  7. Wybierz pozycję Pobierz raport , aby uzyskać skonsolidowany raport do pobrania.

  8. Zapoznaj się z raportem oceny, aby zidentyfikować wszelkie działania, które należy wykonać w celu bezproblemowej migracji obciążeń w usłudze Azure Cosmos DB dla bazy danych MongoDB. Przed przejściem do następnego kroku upewnij się, że wszystkie problemy blokujące zgłoszone w ocenie są obsługiwane. Jeśli występują jakiekolwiek nierozwiązane problemy, możesz zakończyć proces i obsłużyć je później. Po rozwiązaniu problemów możesz wrócić i ponownie uruchomić proces oceny i migracji.

Przeprowadzanie migracji w trybie offline

Teraz użyj raportu oceny, aby przeprowadzić migrację danych w trybie offline ze źródłowego wystąpienia bazy danych MongoDB do docelowego konta usługi Azure Cosmos DB dla rdzeni wirtualnych bazy danych MongoDB.

  1. Na ekranie raportu oceny wybierz wszystkie bazy danych, które mają być migrowane. Następnie wybierz Dalej.

    Zrzut ekranu przedstawiający bazę danych wybraną do migracji.

  2. Zawęź listy, aby wybrać docelowe konto usługi Azure Cosmos DB dla bazy danych MongoDB, filtrując według subskrypcji, a następnie grupę zasobów. Następnie podaj wszelkie poświadczenia połączenia niezbędne do nawiązania połączenia z kontem.

    Zrzut ekranu przedstawiający wybór docelowego konta usługi Azure Cosmos DB dla bazy danych MongoDB.

  3. Wybierz pozycję Testuj połączenie , aby zweryfikować poświadczenia dla konta usługi Azure Cosmos DB dla bazy danych MongoDB. Wybierz przycisk Dalej , aby przejść do mapowania kolekcji ze źródła na obiekt docelowy.

    Ważne

    Obecnie rozszerzenie nie obsługuje źródłowego ani docelowego wystąpienia bazy danych MongoDB z włączonym prywatnym punktem końcowym.

    • Skonfiguruj źródłowe wystąpienie bazy danych MongoDB, aby zezwalać na połączenia z globalnych centrów danych platformy Azure.
    • Dodaj wyjątki zapory do konta docelowego rdzenia wirtualnego usługi Azure Cosmos DB dla bazy danych MongoDB, aby zezwolić na połączenia z globalnych centrów danych platformy Azure.
    • Aby zlokalizować odpowiednie informacje o zakresie adresów IP, pobierz kod JSON z globalnych zakresów adresów IP platformy Azure i wyszukaj ciąg "AzureCloud.{ Docelowy region konta usługi Cosmos DB}" w pliku JSON.

  4. Wybierz pozycję Pomiń lub Migruj dla każdej kolekcji na liście mapowań. Kolekcje, które już istnieją w obiekcie docelowym, są automatycznie oznaczone ikoną i domyślnie mają wartość Pomiń . Wybierz przycisk Dalej , aby skonfigurować usługę Azure Database Migration Service (DMS).

    Zrzut ekranu przedstawiający mapowanie kolekcji ze źródła na obiekt docelowy.

    Ostrzeżenie

    Wybranie opcji Migracja istniejącej kolekcji spowoduje zastąpienie całej kolekcji, co spowoduje nieodwracalną utratę danych. Podczas wybierania tej opcji należy zachować ostrożność.

  5. Wybierz istniejące wystąpienie usługi Azure Database Migration Service z listy rozwijanej lub wybierz pozycję Utwórz nową , aby utworzyć nową usługę migracji. Azure Database Migration Service to usługa, która migruje dane do i z platform danych platformy Azure przy użyciu infrastruktury chmury do transferu danych, zamiast polegać na zasobach lokalnych.

    Zrzut ekranu przedstawiający opcję wybrania usługi migracji.

    Ważne

    Jeśli używasz usługi Database Migration Service po raz pierwszy, upewnij się, że dostawca zasobów Microsoft.DataMigration jest zarejestrowany w subskrypcji.

  6. Wybierz przycisk Dalej , aby wyświetlić podsumowanie migracji. Po przejrzeniu i potwierdzeniu szczegółów wybierz pozycję Utwórz schemat , aby utworzyć zasoby na koncie docelowym.

    Zrzut ekranu przedstawiający opcję wyświetlania podsumowania migracji.

  7. Wybierz pozycję Rozpocznij migrację , aby zainicjować transfer danych przy użyciu wybranej usługi migracji.

    Zrzut ekranu przedstawiający opcję rozpoczęcia migracji przy użyciu usługi migracji.

  8. Wyświetl stan migracji na stronie pulpitu nawigacyjnego po zainicjowaniu zadań.

    Zrzut ekranu przedstawiający pulpit nawigacyjny ze stanem migracji.

  9. Wybierz określoną migrację z listy migracji, aby wyświetlić więcej szczegółów. Przed kontynuowaniem poczekaj na ukończenie migracji.

    Zrzut ekranu kolekcji ze stanem migracji.

    Uwaga

    Nie musisz pozostawać połączony z usługą migracji ani narzędziem Azure Data Studio, podczas gdy zadania migracji są wykonywane zdalnie i asynchronicznie. Zadania migracji są wykonywane w usłudze migracji, a stan zostanie zaktualizowany na pulpicie nawigacyjnym w częstych odstępach czasu.

    Jeśli wybrano więcej niż 50 kolekcji do migracji, zadanie migracji zostanie podzielone na wiele zadań w usłudze migracji, z których każda zawiera maksymalnie 50 kolekcji.

  10. Po zakończeniu zadania stan migracji wskazuje powodzenie.

    Zrzut ekranu przedstawiający powodzenie migracji.

Wyświetlanie przeszłych migracji i ocen

Często warto przejrzeć wcześniejsze oceny i migracje. Rozszerzenie udostępnia interfejs do przeglądania podsumowań przeszłych ocen i migracji. Rozszerzenie zapewnia również możliwość przeglądania szczegółowych raportów dotyczących oceny historycznej.

  1. Aby wyświetlić wcześniejsze migracje, wybierz kartę Migracje na pasku narzędzi. Lista migracji zawiera wszystkie migracje zainicjowane na bieżącej maszynie. Aby uzyskać więcej szczegółów, możesz wybrać określoną migrację na liście.

    Zrzut ekranu przedstawiający listę wszystkich migracji utworzonych przy użyciu rozszerzenia .

  2. Aby wyświetlić wcześniejsze oceny, wybierz kartę Oceny na pasku narzędzi. Lista ocen zawiera wszystkie oceny zainicjowane na bieżącej maszynie.

    Zrzut ekranu przedstawiający listę wszystkich ocen wykonanych przy użyciu rozszerzenia.

Następny krok

Zapoznaj się z często zadawanymi pytaniami dotyczącymi rozszerzenia migracji usługi Azure Cosmos DB dla bazy danych MongoDB