Wyświetl raport HTML na potrzeby konwersji schematu Oracle

Po uruchomieniu konwersji schematu z Oracle do Azure Database for PostgreSQL w rozszerzeniu PostgreSQL dla Visual Studio Code użyj raportu HTML, aby przejrzeć zarejestrowane wyniki. Raport łączy odnajdywanie, wyodrębnianie, wyniki konwersji, szczegóły środowiska i linki do raportów na poziomie obiektu dla sesji konwersji.

Służy do potwierdzania zakresu, badania obiektów wymagających uwagi i udostępniania wyników zespołowi ds. migracji. Aby zapoznać się z przepływem pracy konwersji, zobacz Samouczek: konwertowanie schematów Oracle na Azure Database for PostgreSQL.

Otwieranie raportu

Raport HTML zostanie otwarty automatycznie po zakończeniu konwersji schematu. Można go również otworzyć na jeden z następujących sposobów:

  • Na stronie Podsumowanie konwersji wybierz pozycję Raport konwersji.
  • W danych wyjściowych migracji przejdź do convert\sessions\<session-id>\reports i otwórz report.html w przeglądarce internetowej.

Sprawdź identyfikator sesji w nagłówku Konwersja raportu, aby potwierdzić, że przeglądasz zamierzone uruchomienie. Zacznij od podsumowania ogólnego i wybierz linki podsumowania lub rozwiń nagłówki sekcji, aby wyświetlić więcej szczegółów.

Przeczytaj ogólne podsumowanie

Podsumowanie oddziela wyniki każdej fazy:

Podsumowanie Co należy przejrzeć
Odkrycie Odnalezione obiekty w źródle, w tym liczby dla Do wyodrębnienia, Wykluczone i Nieprawidłowe.
Ekstrakcja Definicje pobrane ze źródła wraz z liczbą Nieudane i Wykluczone. Wyodrębniona definicja nie jest przekonwertowanym obiektem.
Konwersja Przekonwertowane i nieprzekonwertowane liczniki dla sesji konwersji.
Współczynnik konwersji (%) Przekonwertowane obiekty podzielone przez sumę konwersji wyrażone jako wartość procentowa.

Odnajdywanie, wyodrębnianie i konwersja nie muszą liczyć tych samych obiektów. Na przykład konwersja może obejmować wygenerowane obiekty schematu. Użyj sumy konwersji pokazanej w raporcie, a nie sumy wykrywania ani ekstrakcji podczas interpretowania współczynnika konwersji. Rozwiń węzeł Słownik, aby wyświetlić reguły zliczania i definicje używane przez raport.

W obszarze Konwersja na poziomie schematu przejrzyj liczniki i współczynnik konwersji każdego schematu. Kolumna Rola odróżnia wybrane schematy od innych dołączonych schematów. Użyj Wyszukaj schematy, aby znaleźć schemat lub wybrać jego nazwę, aby otworzyć wyniki typu obiektu.

Zrzut ekranu przedstawiający podsumowanie raportu HTML z sumami faz, współczynnikami konwersji, typami obiektów do przejrzenia i wynikami na poziomie schematu.

Znajdź obiekty wymagające uwagi

Zacznij od 5 typów obiektów do przejrzenia, aby zobaczyć pięć najniższych współczynników konwersji wśród typów z nieskonwertowanymi obiektami. Ta lista nie klasyfikuje krytyczności biznesowej. Wybierz typ obiektu, aby go zbadać, lub wybierz pozycję Wyświetl więcej , aby otworzyć pełną sekcję konwersji typu obiektu .

W raporcie głównym zbadaj wyniki konwersji:

  1. Rozwiń węzeł Konwersja, a następnie rozwiń węzeł Konwersja typu obiektu.
  2. Aby zawęzić tabelę, wybierz pozycję Wszystkie typy obiektów, wybierz co najmniej jeden typ, a następnie wybierz pozycję Gotowe. W tabeli przedstawiono sumę filtrowaną dla wybranych typów. Aby przywrócić wszystkie typy, otwórz ponownie kontrolkę, wybierz pozycję Wyczyść filtr, a następnie wybierz pozycję Gotowe.
  3. Wybierz nazwę typu obiektu, aby otworzyć raport na poziomie obiektu.
  4. Użyj nazwy schematu , aby zawęzić wyniki według schematu, gdy ten filtr jest dostępny. Użyj Nazwa wyszukiwania, aby znaleźć nazwę źródła Oracle lub nazwę docelową PostgreSQL.
  5. Wybierz nagłówek kolumny z możliwością sortowania, taki jak Nazwa źródła lub Stan, aby posortować wiersze. Wybierz go ponownie, aby odwrócić kolejność.
  6. Przejrzyj kolumnę Status, w której jest wyświetlana wartość Przekonwertowano lub Nie przekonwertowano. Wybierz pozycję Uwagi, jeśli są dostępne, aby odczytać zarejestrowane notatki konwersji obiektu.

Panel notatek identyfikuje obiekt i zawiera zarejestrowane wyjaśnienie, takie jak zmiana konwersji, niepowodzenie weryfikacji lub różnica, która wymaga przeglądu. Przejrzyj uwagi dotyczące przekonwertowanych obiektów, a także obiektów, które nie zostały przekonwertowane.

Zrzut ekranu przedstawiający przefiltrowane wyniki obiektów z nazwami źródłowymi i docelowymi, stanami konwersji oraz uwagami dotyczącymi konwersji wybranego obiektu.

Ważne

Przekonwertowany wynik sam w sobie nie potwierdza powodzenia kompilacji, uwzględnienia we wdrożeniu ani równoważnego zachowania w środowisku uruchomieniowym. Kontrole poprawności kompilacji sprawdzają składnię i strukturę, a nie dane ani zachowanie aplikacji. Ukończ oddzielne testowanie środowiska uruchomieniowego przed użyciem produkcyjnym.

Przeglądanie składników pakietu

Wróć do głównego raportu i rozwiń węzeł Konwersja i Konwersja pakietu , aby przejrzeć wyniki na poziomie pakietu i na poziomie elementu członkowskiego. Użyj Nazwa schematu i Filtruj pakiety, aby znaleźć pakiet. W tabeli przedstawiono stan pakietu, liczbę elementów członkowskich, przekonwertowane i niekonwertowane liczby elementów członkowskich oraz współczynnik konwersji składowych.

Wybierz nazwę pakietu, aby otworzyć raport składowych. Przejrzyj nazwę źródła, typ źródła, nazwę docelową, typ docelowy, zmianę, stan i uwagi , aby dowiedzieć się, jak poszczególne elementy członkowskie są mapowe na postgreSQL.

Pakiet może być nieskonwertowany nawet wtedy, gdy niektóre jego elementy członkowskie są konwertowane. Liczby pakietów, liczby treści pakietu i liczby elementów członkowskich opisują różne populacje. Nie dodawaj sum członków do sum typu obiektu. Współczynnik n/a oznacza, że nie ma obiektów ani członków dla tego obliczenia, a nie 0% współczynnika konwersji.

Zbadaj wykrywanie i wyodrębnianie

Jeśli w wynikach konwersji brakuje oczekiwanego obiektu, wróć do raportu głównego i przejrzyj wcześniejsze fazy:

  1. Rozwiń Discovery. Przejrzyj temat Obsługiwane typy obiektów i Nieobsługiwane typy obiektów i wybierz nazwę typu obiektu, aby otworzyć szczegóły odnajdywania.
  2. Przejrzyj odpowiednie grupy Do wyodrębnienia, Wykluczone i Nieprawidłowe . Użyj filtrów schematu i tekstu, aby znaleźć obiekt i odczytać jego przyczynę wykluczenia lub nieważności, jeśli została podana.
  3. Przejrzyj uprawnienia źródła i schematy zależne, aby sprawdzić zarejestrowany dostęp do źródła i zależności schematów. Liczby odwołań do zależności nie są liczbami obiektów.
  4. Rozwiń Wyodrębnianie, aby przejrzeć liczby: wyodrębnione, nieudane, wykluczone i nieprawidłowe. Rozwiń węzeł Wyodrębnione obiekty według typu , aby przejrzeć definicje pobrane z bazy danych Oracle według typu obiektu.

Wykluczony obiekt został pominięty podczas ekstrakcji; ten status nie potwierdza, że zamiennik istnieje w PostgreSQL. Liczba nieudanych operacji wyodrębniania reprezentuje definicje, których nie można pobrać, a nie liczbę nieskonwertowanych w fazie konwersji.

Przegląd środowiska i informacji pomocniczych

Skorzystaj z pozostałych sekcji, aby zrozumieć kontekst uruchomienia i zaplanować dalsze działania:

Section Co należy przejrzeć
Środowisko Szczegóły źródła, docelowa baza danych konwersji, rozszerzenia używane przez konwersję schematu i ustawienia LLM.
Następne kroki - Konfiguracja Wskazówki dotyczące łączności docelowej, uprawnień, schematów i wymagań wstępnych dotyczących rozszerzeń przed konfiguracją.
Dokumentacja Linki do dokumentacji publicznej, pliku CSV mapowania obiektów i lokalizacji raportu.
Słownik Definicje stanów, współczynników konwersji, liczby pakietów i członków oraz innych terminów raportu.

W obszarze Odwołania otwórz object_mapping_summary.csv dla nazw obiektów źródłowych i docelowych oraz typów, zarejestrowanych stanów i wymaganych akcji. Wpisy mapowania mogą różnić się od sum obiektów raportu, dlatego nie należy używać liczby wierszy CSV jako mianownika współczynnika konwersji.

Użyj Kolejne kroki — konfiguracja jako wskazówek dotyczących przygotowania. Sam raport nie jest skryptem wdrażania.

Udostępnij raport

Dołącz cały katalog raportów podczas przenoszenia lub udostępniania wyników konwersji.

Katalog raportów może zawierać nazwy baz danych i schematów, nazwy obiektów, informacje o środowisku oraz uwagi dotyczące konwersji. Przejrzyj zawartość przed udostępnieniem, postępuj zgodnie z wymaganiami dotyczącymi postępowania z danymi obowiązującymi w Twojej organizacji i usuń poświadczenia lub poufne dane ze wszystkiego, co udostępniasz.