Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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.
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.
- Instancja PostgreSQL do użycia jako pomocnicza baza danych do walidacji (na przykład serwer elastyczny Azure Database for PostgreSQL).
- Zasób Microsoft Foundry z wdrożonym
gpt-5.2modelem. 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 (wersja zapoznawcza) i wszystkimi poleceniami migracji. To ustawienie jest domyślnie włączone.
Jeśli widok Migracje (wersja zapoznawcza) nie jest wyświetlany na pasku bocznym, sprawdź ustawienie:
- Otwórz ustawienia programu VS Code (Ctrl+, na Windows/Linux, Cmd+, w systemie macOS).
- Wyszukaj
pgsql.enableMigrations. - Upewnij się, że wartość to
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
Otwórz widok Migracje (wersja zapoznawcza) na pasku bocznym.
Wybierz przycisk + na pasku narzędzi widoku lub kliknij prawym przyciskiem myszy folder obszaru roboczego w Eksploratorze i wybierz pozycję Utwórz projekt 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
- Nazwa schematów do konwersji
- Adres URL i klucz punktu końcowego dla zasobu Microsoft Foundry
- Nazwa połączenia dla istniejącego wystąpienia bazy danych PostgreSQL
Wprowadź nazwę w polu nazwa Project.
Wybierz Dalej: Połączenie Oracle.
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.
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. Wybierz pozycję Załaduj schematy , aby nawiązać połączenie i pobrać listę dostępnych schematów.
Z listy rozwijanej Schematy wybierz co najmniej jeden schemat do migracji.
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.
- 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ść .
- Z listy rozwijanej Baza danych PostgreSQL wybierz docelową bazę danych. Wybierz pozycję Załaduj bazy danych , jeśli lista jest pusta.
- 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 je wyświetla i zawiera wskazówki dotyczące dodawania ich do listy dozwolonych oraz instalowania zgodnie z dokumentacją usługi Azure Database for PostgreSQL flexible server.
- 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.
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 Azure dzierżawa usługi AD dla konta (wyświetlana, gdy metoda uwierzytelniania ma identyfikator Microsoft Entra). Nazwa wdrożenia Nazwa wdrożonego modelu w zasobie Microsoft Foundry. Wybierz pozycję Testuj połączenie Microsoft Foundry, aby zweryfikować łączność.
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.
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 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.
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.
Na karcie Przegląd schematu wybierz pozycję Przejrzyj , aby rozwinąć powierzchnię przeglądu, a następnie wybierz pozycję Zgrupowane.
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.
Rozwiń grupę, aby wyświetlić jej metadane (schematy, typy obiektów, krytyczność) i poszczególne karty zadań.
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. 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.
- Wybierz pozycję Zadania w przełączniku.
- Użyj list rozwijanych filtrów (stan, krytyczność, typ obiektu, schemat), aby zawęzić listę zadań.
- 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.
- 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 zainstalowano rozszerzenie modernizacji usługi GitHub aplikacja Copilot, wybierz pozycję Migruj przy użyciu modernizacji aplikacji, aby kontynuować migrację za pomocą notatek kodowania z konwersji schematu. Wybierz pozycję Wyświetl notatki dotyczące kodowania , aby przejrzeć wygenerowane wskazówki przed kontynuowaniem.
- Opcja tylko dla bazy danych — Aby przekonwertować tylko kod aplikacji związany z bazą danych w tym rozszerzeniu, wybierz pozycję Migruj za pomocą rozszerzenia PostgreSQL.
Konwertowanie kodu aplikacji w rozszerzeniu
- Na karcie Migracja aplikacji wybierz pozycję Migruj dane (lub Wybierz metodę , jeśli zostanie wykryte rozszerzenie modernizacji aplikacji).
- Na stronie Konwertuj aplikację wybierz pozycję Wybierz aplikację Oracle, aby przekonwertować , a następnie wybierz folder zawierający kod aplikacji Oracle.
- Wybierz połączenie PostgreSQL i bazę danych PostgreSQL na potrzeby kontekstu konwersji.
- Wybierz pozycję Załaduj bazy danych , jeśli lista baz danych jest pusta.
- 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:
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 bazy kodu aplikacji (wymagany) — Lokalizacja kodu do konwersji.
- Ś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 dla bazy danych PostgreSQL.
Pokaż raport migracji Oracle do bazy danych Postgres (
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.
- W Eksploratorze kliknij prawym przyciskiem myszy przekonwertowany plik SQL w folderze
oraclelubpostgresw projekcie migracji i wybierz pozycję Porównaj pary plików migracji DDL. - 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 (wersja zapoznawcza) na pasku bocznym, aby zarządzać projektami:
| Akcja | Opis |
|---|---|
| Open Migration Project | 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. |