Migracja bazy danych Oracle do bazy danych PostgreSQL

Rozszerzenie PostgreSQL dla Visual Studio Code zapewnia pełny przepływ pracy migracji baz danych Oracle do bazy danych PostgreSQL. Kreator poprowadzi Cię przez proces łączenia ze źródłem Oracle, wybierania schematów, konfigurowania modelu Microsoft Foundry do konwersji DDL wspomaganej przez sztuczną inteligencję oraz wybierania roboczej bazy danych PostgreSQL do walidacji. Po utworzeniu projektu pulpit nawigacyjny śledzi wyodrębnianie, konwersję, eksportowanie i przeglądanie w jednym widoku.

Ważna

Przepływ migracji z Oracle do PostgreSQL jest dostępny tylko w programie Visual Studio Code.

Sposób dopasowania schematu i konwersji aplikacji

Rozszerzenie konwertuje obciążenie Oracle w dwóch przebiegach. Konwersja schematu jest uruchamiana jako pierwsza i tworzy język definicji danych PostgreSQL (DDL) dla obiektów bazy danych. Konwersja aplikacji zostanie uruchomiona później i zaktualizuje kod wywołujący te obiekty.

Konwersja schematu

Konwersja schematu odczytuje słownik danych Oracle dla wybranych schematów, grupuje wyodrębnione obiekty na fragmenty uporządkowane według zależności i konwertuje każdy fragment przy użyciu wdrożenia Microsoft Foundry. Przekonwertowane obiekty są kompilowane względem bazy danych tymczasowych przed ich zapisaniem, więc otrzymany plik DDL jest weryfikowany, a nie najlepiej odgadnąć. Przebieg tworzy:

  • Pliki PostgreSQL .sql na poziomie obiektu zorganizowane według schematu i typu obiektu Oracle.
  • Raport konwersji, który rejestruje, które obiekty zostały przekonwertowane, które zostały pominięte, i ogólny współczynnik powodzenia.
  • Przejrzyj zadania dotyczące obiektów wymagających oceny człowieka, takich jak rezerwowy język DDL lub zachowanie, które różnią się między bazą danych Oracle i PostgreSQL.
  • Uwagi dotyczące kodowania opisujące wzorce Oracle znalezione w schemacie i sposób ich mapowania na bazy danych PostgreSQL.

Konwersja aplikacji

Konwersja aplikacji jest przeznaczona dla kodu specyficznego dla oracle, który otacza bazę danych: skrypty SQL, wywołania procedury składowanej, pliki sterowania modułu ładującego, skrypty powłoki i pliki Java. Pobiera notatki kodujące z konwersji schematu jako dane wejściowe, więc przekonwertowany kod aplikacji tworzy się z nazwami obiektów, typami i konwencjami wywołującymi, które faktycznie produkowane przez konwersję schematu.

Możesz przekonwertować kod aplikacji powiązanej z bazą danych w tym rozszerzeniu lub przekazać pracę do rozszerzenia modernizacji usługi GitHub aplikacja Copilot w celu uzyskania pełnego przebiegu modernizacji.

Sekwencja dwóch przebiegów

Najpierw uruchom konwersję schematu. Konwersja aplikacji zależy od notatek kodowania i przekonwertowanych nazw obiektów generowanych przez konwersję schematu, więc konwertowanie kodu aplikacji przed osiedlenie schematu powoduje utworzenie kodu, który jest przeznaczony dla obiektów, które mogą nadal ulec zmianie. Jeśli ponownie uruchomisz konwersję schematu po zmianie zakresu schematu lub naprawisz obiekt źródłowy, ponownie przejrzyj kod aplikacji pod kątem zaktualizowanych notatek kodowania.

Wymagania wstępne

Zanim zaczniesz, upewnij się, że masz:

  • Zainstalowany program Visual Studio Code .
  • Zainstalowane rozszerzenie PostgreSQL .
  • Dostęp do źródłowej bazy danych Oracle z uprawnieniami do odczytu na potrzeby wyodrębniania schematów.
  • Serwer elastyczny Azure Database for PostgreSQL używany jako baza danych weryfikacji podstaw. Konwersja schematu nie obsługuje Azure HorizonDB jako bazy danych scratch.
  • Zasób Microsoft Foundry z wdrożonym gpt-5.2 modelem. Potrzebny jest adres URL punktu końcowego oraz klucz interfejsu API lub konto Microsoft Entra ID z dostępem.

Sprawdź, czy funkcja migracji jest włączona

Ustawienie pgsql.enableMigrations steruje widokiem Migracje i wszystkimi poleceniami migracji. To ustawienie jest domyślnie włączone.

Jeśli widok Migracje nie jest wyświetlany na pasku bocznym, otwórz ustawienia Visual Studio Code (Ctrl+, na Windows/Linux, Cmd+, w systemie macOS) i sprawdź, czy pgsql.enableMigrations ustawiono wartość true.

Tworzenie projektu migracji

Projekt migracji to czteroetapowy kreator, który przed utworzeniem obszaru roboczego projektu zbiera informacje o źródle, celu i konfiguracji AI.

Krok 1. Konfiguracja Project

  1. Otwórz widok Migracje na pasku bocznym.

  2. Rozpocznij nowy projekt na jeden z następujących sposobów:

    • Jeśli obszar roboczy nie zawiera jeszcze project migracji, wybierz pozycję + Utwórz migrację Project w widoku.
    • Wybierz przycisk na + pasku narzędzi widoku.
    • Kliknij prawym przyciskiem myszy folder obszaru roboczego w Eksploratorze i wybierz polecenie Otwórz Project migracji.

    Otworzy się strona Nowy projekt migracji z Oracle do Azure Database for PostgreSQL, zawierająca listę potrzebnych elementów:

    • Szczegóły połączenia źródłowej bazy danych
    • Nazwy schematów do konwersji
    • Adres URL i klucz punktu końcowego dla zasobu Microsoft Foundry
    • Nazwa połączenia dla istniejącego wystąpienia Azure Database for PostgreSQL

  3. Wprowadź nazwę w polu nazwa Project.

  4. Wybierz Dalej: Połączenie Oracle.

Zrzut ekranu nowej strony projektu migracji z polem Nazwa projektu.

Krok 2. Nawiązywanie połączenia z bazą danych Oracle

Strona Łączenie z bazą danych Oracle zbiera poświadczenia źródłowej bazy danych Oracle i umożliwia ładowanie schematów.

  1. Wypełnij pola połączenia Oracle:

    Pole Opis
    Nazwa hosta Oracle Nazwa hosta lub adres IP serwera bazy danych Oracle.
    Oracle Port Port odbiornika (wartość domyślna: 1521).
    Nazwa identyfikatora SID lub usługi Oracle Identyfikator SID lub nazwa usługi Oracle dla wystąpienia bazy danych.
    Nazwa użytkownika Oracle Użytkownik bazy danych z dostępem do odczytu do obiektów schematu.
    Hasło Oracle Hasło użytkownika Oracle.

  2. Wybierz pozycję Załaduj schematy , aby nawiązać połączenie i pobrać listę dostępnych schematów.

  3. Z listy rozwijanej Schematy wybierz co najmniej jeden schemat do migracji.

  4. Wybierz Dalej: Połączenie PostgreSQL.

Krok 3: Wybierz tymczasową bazę danych Azure Database for PostgreSQL

Na stronie Wybieranie tymczasowej bazy danych Azure Database for PostgreSQL można wybrać wystąpienie PostgreSQL używane przez model AI do weryfikacji przekonwertowanych plików DDL.

Note

Do walidacji użyj dedykowanej bazy danych tymczasowej. Rozszerzenie może wykonać konwersję DDL na tę bazę danych podczas procesu konwersji.

  1. Z listy rozwijanej Połączenie postgreSQL wybierz istniejący profil połączenia. Jeśli potrzebne połączenie nie jest wyświetlane, wybierz pozycję Odśwież profile , aby ponownie załadować dostępne profile, lub utwórz nowe połączenie w widoku Połączenia i tożsamość .
  2. Z listy rozwijanej Baza danych PostgreSQL wybierz docelową bazę danych. Wybierz pozycję Załaduj bazy danych , jeśli lista jest pusta.
  3. Po wybraniu bazy danych rozszerzenie automatycznie sprawdza, czy zainstalowane są zalecane rozszerzenia PostgreSQL. Możesz również wybrać pozycję Weryfikuj rozszerzenia , aby ręcznie uruchomić sprawdzanie. Jeśli brakuje jakichkolwiek rozszerzeń, strona wyświetla ich listę wraz z instrukcjami dotyczącymi dodawania do listy dozwolonych i instalacji.
  4. Wybierz pozycję Dalej: konfiguracja modelu Microsoft Foundry.

Krok 4. Konfigurowanie modelu Microsoft Foundry

Strona Wybieranie modelu Microsoft Foundry umożliwia skonfigurowanie wdrożenia Microsoft Foundry, które obsługuje konwersję schematu i kodu.

  1. Wypełnij pola modelu językowego:

    Pole Opis
    Nazwa modelu gpt-5.2.
    Punkt końcowy usługi Microsoft Foundry Adres URL punktu końcowego zasobu Microsoft Foundry (na przykład https://<resource>.openai.azure.com/).
    Metoda uwierzytelniania Wybierz Klucz API lub Microsoft Entra ID.
    klucz interfejsu API Microsoft Foundry Klucz interfejsu API dla zasobu Microsoft Foundry (wyświetlany, gdy metoda uwierzytelniania jest kluczem interfejsu API).
    konto Azure Konto Microsoft z dostępem do zasobu (wyświetlane, gdy Metoda uwierzytelniania jest ustawiona na Microsoft Entra Id).
    Najemca Microsoft Entra dzierżawę konta (wyświetlana, gdy metoda uwierzytelniania ma identyfikator Microsoft Entra).
    Nazwa wdrożenia Nazwa wdrożonego modelu w zasobie Microsoft Foundry.

  2. Wybierz pozycję Testuj połączenie Microsoft Foundry, aby zweryfikować łączność.

  3. Wybierz Utwórz projekt migracji.

Wskazówka

Microsoft Foundry zaleca 500 000 TPM (tokenów na minutę) dla optymalnej wydajności migracji.

Uruchamianie migracji schematu

Po utworzeniu projektu otworzy się panel Oracle Migration. Na pulpicie nawigacyjnym są wyświetlane karty Migracja schematu i Przegląd schematu wraz z akordeonem Ustawienia , które podsumowuje konfigurację projektu.

Wyodrębnianie i konwertowanie schematów

Karta Migracja schematu (krok 1) uruchamia wyodrębnianie, konwersję i eksportowanie jako potok ciągły.

  1. Na karcie Migracja schematu wybierz pozycję Migruj.

    Etykieta przycisku zmienia się w miarę postępu procesu:

    Status Etykieta przycisku
    Trwa wyodrębnianie Trwa wyodrębnianie...
    Ekstrakcja ukończona, konwersja oczekuje Wznów migrację
    Uruchomiono konwersję Konwertowanie ...
    Wszystkie fazy są ukończone Migracja zakończona

  2. Monitoruj postęp na rozwiniętej karcie:

    • Wyodrębnianie pokazuje liczbę wyodrębnionych obiektów (na przykład "15 z 42 wyodrębnionych obiektów") oraz przetwarzany bieżący schemat i obiekt.
    • Konwersja pokazuje liczbę przekonwertowanych fragmentów (na przykład „przekonwertowano 3 z 8 fragmentów”) oraz aktualnie przetwarzany fragment.

  3. Po zakończeniu eksportowania wybierz pozycję Wyświetl raport migracji , aby otworzyć wygenerowany raport migracji.

Przejrzyj zadania migracji

Karta Przegląd schematu (Krok 2) wyświetla elementy wymagające ręcznej uwagi po konwersji. Przełącznik Grupowane / zadania w górnej części obszaru przeglądu umożliwia wybranie sposobu pracy z listą.

Widok pogrupowany

Widok Pogrupowane porządkuje zadania przeglądu w zwijanych sekcjach akordeonowych według kategorii. Użyj tego widoku, jeśli chcesz przetwarzać powiązane problemy razem.

  1. Na karcie Przegląd schematu wybierz pozycję Przejrzyj , aby rozwinąć powierzchnię przeglądu, a następnie wybierz pozycję Zgrupowane.

  2. Użyj kart Oczekujące i Rozwiązane , aby przełączać się między zadaniami, które nadal wymagają uwagi i zadań, które zostały już zatwierdzone.

  3. Rozwiń grupę, aby wyświetlić jej metadane (schematy, typy obiektów, krytyczność) i poszczególne karty zadań.

  4. Użyj akcji na poziomie grupy, aby przetwarzać zadania zbiorcze:

    Akcja Opis
    Uruchom wszystko Otwórz każde oczekujące zadanie w grupie w trybie agenta Copilot na potrzeby przeglądu wspomaganego przez sztuczną inteligencję.
    Rozwiąż wszystkie problemy Oznacz wszystkie zadania w grupie jako rozwiązane. Przed kontynuowaniem zostanie wyświetlone okno dialogowe potwierdzenia nazwy grupy i liczby zadań.
    Resetuj wszystko Przywróć wszystkie rozwiązane zadania w grupie do stanu „Oczekujące”. Dostępne na karcie Rozwiązane .
    Wyświetl w zadaniach Przejdź do płaskiego widoku Zadania przefiltrowanego dla tej grupy.

  5. Aby wykonać działanie na pojedynczym zadaniu w obrębie grupy, wybierz pozycję Uruchom zadanie, aby otworzyć je w trybie agenta Copilot, lub wybierz pozycję Rozwiąż, aby oznaczyć je jako ukończone. Wybierz pozycję Resetuj w rozpoznanym zadaniu, aby przywrócić je do stanu oczekiwania.

Note

Rozwiąż wszystkie i Zresetuj wszystkie są wyłączone, gdy grupa zawiera więcej niż 800 zadań.

Widok zadań

Widok Zadania pokazuje wszystkie zadania do przeglądu w płaskiej tabeli. Użyj tego widoku, jeśli chcesz sortować, filtrować lub wyszukiwać we wszystkich zadaniach niezależnie od grupy.

  1. Wybierz pozycję Zadania w przełączniku.
  2. Użyj list rozwijanych filtrów (stan, krytyczność, typ obiektu, schemat), aby zawęzić listę zadań.
  3. Wybierz pozycję Uruchom zadanie w przypadku oczekującego elementu, aby otworzyć go w trybie agenta Copilot w celu przeprowadzenia przeglądu i korekty z pomocą SI.
  4. Po naprawieniu elementu wybierz Rozwiąż, aby oznaczyć go jako ukończony.

Wskazówka

Wybierz opcję Wyświetl dzienniki w panelu, aby przejrzeć pliki dziennika wyodrębniania i konwersji pod kątem rozwiązywania problemów.

Migrowanie kodu aplikacji

Po migracji schematu przekonwertuj kod aplikacji specyficzny dla Oracle (skrypty SQL, procedury składowane, pliki sterujące programu ładującego, skrypty powłoki lub pliki Java) na odpowiedniki zgodne z PostgreSQL. Migracja aplikacji to funkcja w wersji zapoznawczej.

Wybieranie metody migracji

Rozszerzenie oferuje dwie ścieżki migracji kodu aplikacji:

  • Pełna modernizacja aplikacji: jeśli zainstalujesz rozszerzenie modernizacji usługi GitHub aplikacja Copilot, wybierz pozycję Migruj przy użyciu modernizacji aplikacji, aby kontynuować migrację z notatek kodowania z konwersji schematu. Wybierz pozycję Wyświetl notatki dotyczące kodowania , aby przejrzeć wygenerowane wskazówki przed kontynuowaniem.
  • Opcja tylko do bazy danych: aby przekonwertować tylko kod aplikacji powiązany z bazą danych w ramach tego rozszerzenia, wybierz pozycję Migruj przy użyciu rozszerzenia PostgreSQL.

Konwertowanie kodu aplikacji w rozszerzeniu

  1. Na karcie Migracja aplikacji wybierz pozycję Migruj dane (lub Wybierz metodę , jeśli zostanie wykryte rozszerzenie modernizacji aplikacji).
  2. Na stronie Konwertuj aplikację wybierz pozycję Wybierz aplikację Oracle, aby przekonwertować , a następnie wybierz folder zawierający kod aplikacji Oracle.
  3. Wybierz połączenie PostgreSQL i bazę danych PostgreSQL na potrzeby kontekstu konwersji.
  4. Wybierz pozycję Załaduj bazy danych , jeśli lista baz danych jest pusta.
  5. Wybierz pozycję Konwertuj aplikację , aby rozpocząć konwersję.

Używanie narzędzi Copilot do migracji aplikacji

Rozszerzenie rejestruje dwa narzędzia do modelowania języka Copilot w celu uzyskania pomocy w migracji:

  • Program Oracle Client Code Application Converter (pgsql_migration_oracle_app): konwertuje kod aplikacji klienckiej Oracle na odpowiedniki postgreSQL przy użyciu szablonów monitów i wskazówek dotyczących kodowania z analizy migracji schematu. Akceptuje następujące parametry:

    • Folder codebase aplikacji (wymagany): lokalizacja kodu do przekonwertowania.
    • Ścieżka lokalizacji notatek kodowania (opcjonalnie): ścieżka do kodowania notatek z migracji schematu.
    • Nazwa bazy danych Postgres DB (opcjonalnie): nazwa bazy danych PostgreSQL na potrzeby kontekstu konwersji.
    • Połączenie bazy danych Postgres DB (opcjonalnie): nazwa połączenia bazy danych PostgreSQL.

  • Pokaż raport oracle to Postgres Migration Report (pgsql_migration_show_report): wyświetla raport migracji wygenerowany przez konwersję schematu. Wymaga parametru Ścieżka do pliku raportu.

Aby uzyskać więcej informacji na temat korzystania z narzędzi Copilot, zobacz Copilot integracja.

Porównywanie przekonwertowanych plików

Po konwersji przejrzyj zmiany obok siebie za pomocą wbudowanych poleceń diff.

  1. W Eksploratorze kliknij prawym przyciskiem myszy przekonwertowany plik SQL w folderze oracle lub postgres w projekcie migracji i wybierz pozycję Porównaj pary plików migracji DDL.
  2. W przypadku przekonwertowanych plików kodu aplikacji (.sql, .ctl, , .sh.loadlub .java) kliknij plik prawym przyciskiem myszy i wybierz pozycję Porównaj pary plików migracji aplikacji.

Widok różnic side-by-side pokazuje oryginalne źródło Oracle obok przekonwertowanych danych wyjściowych PostgreSQL, dzięki czemu można zidentyfikować wszystkie artefakty, które wymagają ręcznego dostosowania.

Note

Pliki DDL muszą mieć strukturę folder/oracle|postgres/SCHEMA_NAME/DDL-TYPE/filename.sql, aby polecenie compare mogło odnaleźć pasującą parę plików.

Zarządzanie projektami migracji

Użyj widoku Migracje na pasku bocznym, aby zarządzać projektami:

Akcja Opis
Otwarty projekt migracji Otwórz istniejący projekt migracji na pulpicie nawigacyjnym.
Pokaż w Eksploratorze Pokaż folder projektu w widoku Eksploratora.
Delete Usuń projekt migracji. Zostanie wyświetlony monit o potwierdzenie przed usunięciem.
Odświeżyć Załaduj ponownie listę projektów migracji w bieżącym obszarze roboczym.

Treści powiązane

  • Last updated on