Ocena migracji bazy danych dla rozszerzenia Oracle

Rozszerzenie Database Migration Assessment for Oracle w narzędziu Azure Data Studio ułatwia ocenę obciążenia Oracle pod kątem migracji do usług Azure SQL i Azure Database for PostgreSQL. Rozszerzenie identyfikuje odpowiedni element docelowy usługi Azure SQL lub PostgreSQL z zaleceniami dotyczącymi odpowiedniego określania rozmiaru i tym, jak złożona może być migracja.

Wymagania wstępne

Instalowanie rozszerzenia usługi Azure Data Studio

Wykonaj następujące kroki, aby zainstalować rozszerzenie Database Migration Assessment for Oracle w narzędziu Azure Data Studio.

  1. Otwórz menedżera rozszerzeń w narzędziu Azure Data Studio. Możesz wybrać ikonę rozszerzeń lub wybrać pozycję Rozszerzenia w menu Widok.

  2. Wpisz Oracle na pasku wyszukiwania.

  3. Wybierz rozszerzenie Database Migration Assessment for Oracle i wyświetl jego szczegóły.

  4. Wybierz Zainstaluj.

    Screenshot of installing the extension.

Konfigurowanie ustawień rozszerzenia

Po zainstalowaniu rozszerzenia można skonfigurować kilka ustawień rozszerzenia.

  1. Przejdź do pozycji Rozszerzenia i wybierz pozycję Ocena migracji bazy danych dla programu Oracle, wybierz ikonę zarządzania ustawieniami, a następnie wybierz pozycję Ustawienia rozszerzenia.

    Screenshot of extension.

  2. W obszarze Ustawienia rozszerzenia zmodyfikuj wszystkie ustawienia rozszerzenia, aby spełnić wymagania środowiska.

    Screenshot of extension properties settings.

    Uwaga

    Aby przeprowadzić ocenę kodu oracle to PostgreSQL, ścieżka główna klienta Oracle i ścieżka instalacji Ora2Pg są obowiązkowymi parametrami.

Uruchamianie oceny

Po zainstalowaniu rozszerzenia oceny następnym krokiem jest nawiązanie połączenia z bazą danych Oracle, zebranie informacji o metadanych z wystąpienia oracle i wygenerowanie raportu oceny.

  1. Przejdź do ikony połączeń na pasku menu.

    Screenshot of connections menu bar.

  2. W obszarze Szczegóły Połączenie ion wypełnij pola.

    1. W polu typ Połączenie ion wybierz pozycję Oracle.
    2. W polu Źródło danych wpisz nazwę i wystąpienie serwera Oracle.
      1. Możesz również podać nazwę TNS. (Upewnij się, że zmienna ORACLE_HOME środowiskowa jest ustawiona, a TNSNAMES.ORA plik znajduje się w pliku <ORACLE_HOME>/network/admin folder.
      2. W przypadku bazy danych kontenerów można połączyć główną bazę danych kontenera przy użyciu identyfikatora usługi CDB lub użyć nazwy usługi bazy danych z możliwością podłączenia, aby nawiązać połączenie z podłączaną bazą danych.
    3. Podaj nazwę użytkownika bazy danych w polu Identyfikator użytkownika.
    4. Podaj hasło bazy danych w polu Hasło .

    Screenshot of connection details.

  3. Wybierz pozycję Połącz.

  4. Teraz nowe połączenie zostanie wyświetlone w menu szczegółów połączenia.

  5. Kliknij prawym przyciskiem myszy połączenie Oracle i wybierz pozycję Zarządzaj.

    Screenshot showing the Manage database screen.

  6. Wybierz pozycję Ocena migracji.

    Screenshot showing the Migration Assessment database screen.

  7. Wybierz pozycję Uruchom nową ocenę.

    Screenshot showing the Run new Assessment screen.

  8. Podaj szczegóły oceny.

    1. W polu Nazwa oceny wprowadź tytuł, na przykład demo1.
    2. Wprowadź ustawienie Ocena.
      1. Wprowadź docelową bazę danych migracji w polu Platforma docelowa . Obecnie obsługuje ona usługi Azure SQL i PostgreSQL jako obiekty docelowe.

        Uwaga

        Obiekt docelowy postgreSQL jest w wersji zapoznawczej. Ta opcja docelowa zostanie przerwana. Należy wyeksportować wszystkie wcześniejsze oceny.

      2. W sekcji Zbieranie danych wydajności wybierz pozycję Uruchom zbieranie danych wydajności w bazie danych Oracle (połączone) lub Dodaj raport AWR.

        Zaleceniem jest użycie opcji połączonej, jeśli używasz tego narzędzia podczas szczytowego lub realistycznego obciążenia. W przeciwnym razie podaj raporty AWR wygenerowane w przeszłości na potrzeby zaleceń dotyczących wydajności i określania rozmiaru.

        Uwaga

        Opcja oceny raportu AWR nie jest włączona dla wtyczki bazy danych.

      3. Wprowadź wartość mnożnika w polu Współczynnik skalowania.

        • Jeśli zalecana jednostka SKU musi rozważyć inne obciążenia szczytowe, mnożnik współczynnika skalowania powinien być większy niż 1. Na przykład ładowanie w czasie serii, użycie sezonowe i planowanie pojemności w przyszłości. W przypadku migrowania częściowego obciążenia schematu Oracle mnożnik powinien być mniejszy niż 1.
      4. W polu Użycie percentylu wprowadź wartość percentylu na potrzeby określania rozmiaru elementu docelowego platformy Azure.

        • Wartość percentylu próbki wydajności, która ma być brana pod uwagę pod kątem określania rozmiaru elementu docelowego platformy Azure.

    Screenshot showing the assessment details screen.

  9. Istnieją dwa typy oceny:

    • Ocena obciążenia. W ramach tej oceny moduł oceny Oracle przeprowadza uproszczone odnajdywanie obiektów schematu i kategoryzuje złożoność schematu migracji do różnych kategorii z wysokim oszacowaniem godzin konwersji. Ta wstępna ocena pomaga znaleźć możliwość migracji na platformę docelową.

    • Ocena kodu. Ocena kodu wykonuje szczegółową ocenę obiektów schematu Oracle, a następnie sugeruje ogólną gotowość obiektów kodu z "gotowymi", "przeglądem potrzeb" i "nie gotowymi" typami obiektów na poziomie szczegółowym i powiązanymi z nimi godzinami konwersji z większą dokładnością.

      Uwaga

      Rozszerzenie używa konwertera schematu Ora2Pg typu open source na potrzeby ocen kodu.

      Jeśli klient Oracle i/lub Ora2Pg nie są zainstalowane na tej samej maszynie co program Azure Data Studio, zainstaluj je ręcznie lub użyj skryptu instalacji Ora2Pg z usługi GitHub.

      Jeśli zainstalowano klienta Oracle i rozwiązanie Ora2Pg, upewnij się, że ścieżka główna klienta Oracle i ścieżka instalacji Ora2Pg zostaną zaktualizowane w ustawieniach rozszerzenia.

      • Po wybraniu opcji Ocena kodu dla scenariuszy SQL wybierz schematy, do których chcesz uzyskać dostęp dla programu Oracle do konwersji i migracji SQL. Domyślnie wszystkie kwalifikujące się schematy są wybierane do oceny.
  10. Wybierz pozycję Uruchom walidację , aby wykonać wymagania wstępne i różne reguły walidacji związane z uprawnieniami zabezpieczeń, ustawieniami konfiguracji itp. Jeśli walidacja nie powiedzie się, należy naprawić błędy, aby kontynuować.

  11. Po pomyślnym zakończeniu walidacji możesz wybrać pozycję Uruchom ocenę.

  12. Teraz w sekcji "Ostatnie pięć ocen" zostanie wyświetlona nowa ocena.

    Screenshot showing the option to name the assessment.

  13. Wybierz link oceny, aby wyświetlić stronę szczegółów oceny. Możesz wyświetlić najnowszy stan oceny.

    Screenshot showing the latest assessment status.

  14. Wybierz pozycję Odśwież lub zaczekaj na zakończenie oceny. Domyślnie strona stanu oceny jest odświeżany co 15 sekund. Stan pokazuje jeden z czterech stanów: powodzenie, niepowodzenie, w toku lub anulowanie.

Wyświetlanie oceny

Po zakończeniu oceny skonsolidowane dane wyjściowe przy użyciu kart są generowane dla każdego obiektu docelowego usługi Azure SQL: programu SQL Server na maszynach wirtualnych platformy Azure, usłudze Azure SQL Database i usłudze Azure SQL Managed Instance lub usłudze Azure Database for PostgreSQL — serwer elastyczny.

Screenshot of the view assessment option.

Każda karta ma wiele sekcji. Karta pokazuje ogólną wykonalność migracji do celu. Możesz przejść do szczegółów różnych obciążeń w różnych kategoriach złożoności migracji:

  • Sekcja zgodność funkcji zawiera wynik przeglądu funkcji.
  • Zalecenie dotyczące jednostki SKU zapewnia prawidłowe ustalanie rozmiaru elementu docelowego.
  • Ocena kodu zapewnia złożoność kodu obiektów bazy danych.

Po wybraniu pozycji Wyświetl szczegóły raportu najpierw zostanie wyświetlone podsumowanie oceny.

Screenshot showing assessment summary.

Jeśli wybrany element docelowy to Database for Azure PostgreSQL, karta Szczegóły bazy danych lub karta Ocena kodu jest widoczna na podstawie wyboru typu oceny.

Poniższa karta Szczegóły bazy danych zawiera podział dla poszczególnych schematów. Przedstawia listę odnalezionych schematów, wykonalność migracji i szacowany czas konwersji schematu w godzinach.

Screenshot showing the breakdown per schema basis.

To oszacowanie jest oparte na modelu statystycznym, który ma zastosowanie do liczby obiektów, wierszy kodu, funkcji z obsługą i rozmiaru bazy danych. Aby uzyskać dokładniejsze oszacowanie konwersji kodu, użyj oceny kodu.

Uwaga

Następujące schematy wbudowane systemu lub oracle są wykluczone z oceny obciążenia:

APEXAPPQOSSYS, , , CSMIGAUDSYSCTXSYSDBMS_PRIVILEGE_CAPTUREDBSFWUSERDBSNMPDIPDMSYSDVFDVSYSEXFSYSFLOW_GSMADMIN_INTERNALLBACSYSMDDATAMDSYSMGDSYSMGMT_VIEWMTMSYSODMODM_MTROJVMSYSOLAPSYSORACLE_OCMORDDATAORDPLUGINSORDSYSOSE$HTTP$ADMINOUTLNOWBSYSOWBSYS_AUDITPERFSTATSDESI_INFORMTN_SCHEMASPATIAL_CSW_ADMIN_USRSPATIAL_WFS_ADMIN_USRSQLTXPLAINSYSSYSMANSYSTEMTRACESRVTSMSYSWEBSYSWKPROXYWKSYSWK_PROXYWK_TESTWMSYSXDBXS$NULL

Zalecenie dotyczące jednostki SKU zawiera następujące elementy:

  • Odpowiedni element docelowy platformy Azure.

  • Warstwa usługi.

  • Progi metryk są używane do zapewnienia zalecanej jednostki SKU.

    Screenshot showing SKU recommendations.

Zalecenie dotyczące jednostki SKU ocenia różne metryki wydajności, takie jak procesor CPU, pamięć, liczba operacji we/wy na sekundę, opóźnienie i magazyn. Na podstawie użycia i danych konfiguracji moduł polecający udostępnia odpowiedni element docelowy i odpowiednią warstwę usługi. Zalecenie jednostki SKU jest oparte na wystąpieniu głównym kontenera lub wykorzystaniu wtyczki bazy danych. Wybór schematu jest ignorowany i nie dotyczy określania rozmiaru jednostki SKU.

Uwaga

Jeśli funkcja automatycznego repozytorium obciążeń (AWR) jest włączona w wystąpieniu Oracle, zalecający jednostkę SKU będzie używać DBA_HIST_ widoków do zbierania metadanych metryk wydajności. W przeciwnym razie zalecający będzie używać konfiguracji serwera i innych informacji widoku systemu do określania rozmiaru obiektu docelowego usługi Azure SQL.

Zgodność kodu (tylko dla obiektów docelowych postgreSQL) zawiera podsumowanie obiektów schematu, które można przekonwertować na obiekt docelowy platformy Azure. Raport zawiera podział obiektów, które mogą być konwertowane automatycznie, gotowe z warunkami i muszą zostać skorygowane i przekonwertowane ręcznie.

Screenshot showing the code compatibility report.

Raport przedstawia łączną liczbę obiektów i godzin nakładu pracy konwersji wymaganych do migracji kodu do bazy danych Azure PostgreSQL. Obraz graficzny zawiera podział dla każdego typu obiektu schematu, takich jak tabele, widoki i klastry. Nakłady pracy są klasyfikowane jako "Gotowe — automatycznie konwertowane", "Wymaga przeglądu" i "Nie gotowe — wymaga konwersji ręcznej".

Przechodzenie do szczegółów sekcji "Nie gotowe" i "Wymaga przeglądu" zawiera listę zadań korygowania i godzin pracy dla każdego zadania.

Screenshot showing the remediation task.

Ocena funkcji zapewnia zamapowane funkcje bazy danych Oracle do miejsca docelowego danych platformy Azure oraz nakład pracy wymagany do migracji tych funkcji do miejsca docelowego platformy Azure.

Screenshot showing the mapped assessment.

Raport można pobrać do wyświetlania w trybie offline, wybierając pozycję Pobierz połączone raporty lub Pobierz poszczególne raporty.

Screenshot showing the download assessment report option.

Możesz również anulować bieżącą ocenę, usunąć ocenę i przenieść oceny do innego katalogu.

Zmień ścieżkę oceny

  1. Przejdź do witryny Marketplace rozszerzeń i wyszukaj pozycję Database Migration Assessment for Oracle.
  2. Wybierz ikonę Zarządzaj , a następnie wybierz pozycję Ustawienia rozszerzeń.
  3. Podaj nową ścieżkę oceny w obszarze Ocena Oracle: Ścieżka oceny.

Screenshot showing the Change assessment path option.

Rozwiązywanie problemów

Dzienniki

Rozszerzenie przechowuje błędy, ostrzeżenia i inne dzienniki diagnostyczne w domyślnym katalogu dziennika:

  • Windows — C:\Users\<username>.dmaoracle\logs\
  • Linux- ~/.dmaoracle/logs
  • Macos- /Users/<username>/.dmaoracle/logs

Uwaga

Domyślnie rozszerzenie przechowuje siedem ostatnich plików dziennika.

Aby zmienić katalog dziennika, zaktualizuj LogDirectory właściwość w pliku ustawień rozszerzenia.

System operacyjny Ścieżka
Windows C:\Users\<username>\.azuredatastudio\extensions\microsoft.azuredatastudio-dma-oracle-<VersionNumber>\bin\service\Properties\ConfigSettings\extension-settings.json
Linux ~/.azuredatastudio/extensions/microsoft.azuredatastudio-dma-oracle-<VersionNumber>/<VersionNumber>/bin/service/Properties/ConfigSettings/extension-settings.json
macOS /Users/<username>/.azuredatastudio/extensions/microsoft.azuredatastudio-dma-oracle-<VersionNumber>/<VersionNumber>/bin/service/Properties/ConfigSettings/extension-settings.json

Aby uzyskać więcej informacji na temat rozwiązywania problemów, zobacz Rozwiązywanie problemów z oceną migracji bazy danych pod kątem błędów rozszerzenia Oracle.

Znane problemy i ograniczenia

  • Podana ścieżka nie istnieje.

    Przyczyna: Brak plików lub brak uprawnień do folderu oceny.

    Możliwe rozwiązanie:

    • Użytkownik ma uprawnienia do odczytu i zapisu w folderze oceny.
    • Jeśli brakuje pliku lub folderu, usuń ocenę i wygeneruj nową ocenę.
  • Napotkano wyjątek przekroczenia limitu czasu połączenia podczas interakcji z oracle.

    Przyczyna: Nie można nawiązać połączenia z wystąpieniem Oracle.

    Możliwe rozwiązanie:

    • Sprawdź, czy reguły zapory blokują port nasłuchiwania Oracle.
    • Uruchom polecenie tnsping i sprawdź, czy identyfikator usługi zostanie rozwiązany.

Skontaktuj się z firmą Microsoft, aby uzyskać pomoc

Jeśli potrzebujesz dalszej pomocy od firmy Microsoft, skontaktuj się z @dmasupport. Aby przyspieszyć obsługę, możesz dołączyć dzienniki z domyślnego katalogu dziennika.