Samouczek: konwersja aplikacji z Oracle do Azure Database for PostgreSQL — serwer elastyczny (wersja zapoznawcza)

Ten samouczek przeprowadzi Cię przez proces konwertowania kodu aplikacji klienckiej Oracle na Azure Database for PostgreSQL przy użyciu rozszerzenia Visual Studio Code PostgreSQL z trybem agenta GitHub Copilot w celu zautomatyzowania i weryfikowania transformacji kodu.

Obejmuje ona konfigurowanie środowiska, importowanie bazy kodu aplikacji, uruchamianie procesu konwersji i przeglądanie wygenerowanego kodu zgodnego z bazą danych PostgreSQL. Przed rozpoczęciem upewnij się, że ukończono projekt konwersji schematu w celu uzyskania optymalnych wyników.

Oto, czego można oczekiwać podczas konwersji:

• Konfiguracja środowiska: Konfigurowanie trybu agenta GitHub Copilot przy użyciu odpowiedniego modelu sztucznej inteligencji
• Importowanie bazy kodu: Organizowanie kodu aplikacji w strukturze projektu migracji
• przetwarzanie AI: GitHub Copilot przetwarza i konwertuje kod aplikacji przy użyciu kontekstu bazy danych
• Wykonywanie zadań TODO: Automatyczne generowanie listy zadań i systematyczna konwersja
• Generowanie raportu: kompleksowy raport konwersji z wynikami i zaleceniami
• Porównanie plików: wbudowane narzędzia różnic do przeglądania oryginalnego i przekonwertowanego kodu

Wymagania wstępne

W tej sekcji opisano wymagania wstępne dotyczące używania funkcji konwersji aplikacji z Oracle do Azure Database for PostgreSQL w programie Visual Studio Code przed rozpoczęciem konwersji.

Wymagania systemowe

Requirement	Specyfikacja
wersja Visual Studio Code	1.95.2 lub nowszy
subskrypcja GitHub Copilot	Pro+, Business, Enterprise

Obsługa systemów operacyjnych

Platform	Architecture
Windows	x64 i ARM64
Linux	x64 i ARM64
macOS	x64 (Intel) i ARM64 (Apple Silicon)

Wymagania dotyczące modelu AI

Potrzebny jest jeden z następujących modeli sztucznej inteligencji skonfigurowany w trybie agenta GitHub Copilot:

Model	wersja
Claude	Sonnet 4.6 lub Opus 4.6 lub nowszy

Przed rozpoczęciem konwersji aplikacji ustaw model trybu agenta GitHub Copilot na Claude Sonnet 4.6 lub Claude Opus 4.6 lub nowszy, aby uzyskać optymalne wyniki przekształcania kodu.

Obsługa wersji bazy danych PostgreSQL

Docelowa baza danych	wersja
Elastyczny serwer Azure Database for PostgreSQL	PostgreSQL w wersji 15 lub nowszej
Azure HorizonDB	PostgreSQL w wersji 17 lub nowszej

Zalecenie dotyczące konwersji schematu

Chociaż wcześniej nie jest wymagane przeprowadzenie konwersji schematu bazy danych, najpierw zaleca się ukończenie migracji schematu. Jeśli schemat Oracle został już przekonwertowany na postgreSQL, proces konwersji aplikacji zapewnia dokładniejszy kontekst i wyniki przekształcania kodu o wyższej jakości za pośrednictwem:

• Uwagi dotyczące kodowania: artefakty metadanych generowane podczas konwersji schematu (zobacz Co to są uwagi programistyczne? poniżej)
• Kontekst bazy danych: bezpośredni dostęp do przekonwertowanych obiektów schematu
• Mapowania typów danych: Dokładne zrozumienie przekształceń typów

Inne wymagania wstępne

• Połączenie z bazą danych dla instancji Azure Database for PostgreSQL
• Dostęp do rynku rozszerzeń Visual Studio Code i usług GitHub Copilot

Co to są notatki dotyczące kodowania?

Notatki kodujące to artefakty metadanych generowane automatycznie podczas fazy konwersji schematu. Przechwytują kluczowe szczegóły transformacji i informacje z konwersji schematu z Oracle do PostgreSQL, które proces później wykorzystuje do przekształcania kodu aplikacji.

Notatki programistyczne mogą zawierać informacje, takie jak:

• Mapowania typów danych i zmiany strukturalne
• Szczegóły konwersji dla sekwencji, identyfikatorów i typów złożonych
• Korekty implementacji daty/godziny lub interwału
• Odwołania do tabel z ograniczeniami integralności referencyjnej
• Podsumowania złożonych pakietów Oracle, w tym podpisów procedur i funkcji
• Dodatkowe wskazówki generowane przez sztuczną inteligencję w celu zwiększenia dokładności tłumaczenia kodu

Podczas konwersji aplikacji model sztucznej inteligencji używa tych notatek jako sygnałów kontekstowych do tworzenia bardziej precyzyjnego i semantycznie wyrównanego kodu zgodnego z bazą danych PostgreSQL.

Proces konwersji aplikacji

W tej sekcji przedstawiono pełny przepływ pracy konwersji aplikacji: konfigurowanie środowiska, importowanie bazy kodu, uruchamianie konwersji, przeglądanie wygenerowanego raportu i porównywanie zmian plików.

Krok 1. Konfigurowanie środowiska

• Otwórz Visual Studio Code z zainstalowanym rozszerzeniem PostgreSQL.
• Otwórz interfejs czatu GitHub Copilot.
• Wybierz pozycję Claude Sonnet 4.6 lub Claude Opus 4.6 dla modelu.

W celu uzyskania optymalnych wyników konwersji aplikacji wymagane jest użycie programu Claude Sonnet 4.6 lub Claude Opus 4.6. Niższe modele mogą generować mniej dokładne konwersje.

Krok 2. Otwieranie projektu migracji

• Otwórz obszar roboczy zawierający projekt konwersji schematu.

• Przejdź do struktury folderów projektu migracji:

  .github/postgres-migration/project_name/
  

• Sprawdź, czy struktura projektu zawiera niezbędne foldery i pliki z konwersji schematu.

Krok 3. Kopiowanie bazy kodu do projektu migracji

• Znajdź folder application_code w twoim projekcie:

  .github/postgres-migration/project_name/application_code/
  

• Skopiuj folder codebase, który chcesz zmigrować do folderu application_code wewnątrz folderu projektu.

• Organizuj pliki logicznie w celu ułatwienia systematycznej konwersji.

Zachowaj oryginalny kod aplikacji w oddzielnej lokalizacji jako kopię zapasową. Skopiuj tylko pliki, które chcesz przekonwertować na strukturę projektu migracji.

Krok 4. Rozpoczęcie migracji kodu klienta

• W panelu Migracja rozszerzenia PostgreSQL wybierz pozycję Migruj aplikację , aby uruchomić kreatora konwersji aplikacji.
• Po załadowaniu formularza wybierz folder, który skopiowałeś do katalogu głównego obszaru roboczego.
• Wybierz bazę danych z kontekstem aplikacji:
  • Baza danych PostgreSQL, w której wdrożono przekonwertowany język DDL lub
  • Baza danych PostgreSQL, w której schemat aplikacji już istnieje
• Wybierz pozycję Konwertuj aplikację.

Ta akcja inicjuje następujące procesy:

• Wywołuje niestandardowy złożony monit i narzędzie Trybu Agenta
• Generuje listę zadań do wykonania, nad którymi działa tryb agenta
• Nawiązuje połączenie z bazą danych i odczytuje bazę danych w celu uzyskania rozszerzonego kontekstu
• Systematycznie konwertuje pliki kodu aplikacji

Krok 5. Monitorowanie postępu konwersji

• Obejrzyj interfejs trybu agenta GitHub Copilot podczas przetwarzania plików.
• Agent systematycznie pracuje nad wygenerowaną listą zadań do wykonania.
• Przejrzyj wszelkie monity lub pytania od agenta, które mogą wymagać odpowiedzi.
• Zezwól na pełne ukończenie procesu konwersji przed przejrzeniem wyników.

Krok 6. Ulepszona konwersja Java z rozszerzeniem GitHub Copilot App Modernization (opcjonalnie)

Jeśli pracujesz z kodem Java: Możesz ulepszyć proces konwersji, instalując rozszerzenie GitHub Copilot App Modernization Extension przed rozpoczęciem konwersji.

Automatyczna kompilacja testów

Dwa rozszerzenia programu VS Code komunikują się ze sobą w celu zapewnienia bezproblemowej integracji. Podczas konwertowania kodu Java rozszerzenie modernizacji aplikacji automatycznie wykonuje kompilację testową przekonwertowanego kodu w celu zidentyfikowania błędów składniowych lub problemów z kompilacją na wczesnym etapie procesu.

Automatyczne generowanie testów jednostkowych

Na podstawie przekonwertowanej bazy kodu rozszerzenie modernizacji aplikacji automatycznie generuje testy jednostkowe, aby ułatwić sprawdzenie, czy przekonwertowana aplikacja działa prawidłowo. Ta integracja korzysta z możliwości rozszerzenia Modernizacja aplikacji w celu:

• Analizowanie przekonwertowanych klas i metod Java
• Generowanie odpowiednich przypadków testowych dla krytycznych ścieżek kodu
• Tworzenie urządzeń testowych, które współpracują z połączeniami bazy danych PostgreSQL

Zainstalowanie rozszerzenia GitHub Copilot App Modernization jest zdecydowanie zalecane w przypadku projektów migracji Java, ponieważ znacznie przyspiesza walidację i poprawia jakość konwersji dzięki automatycznym testom kompilacji i generowaniu testów.

Krok 7. Przegląd raportu konwersji kodu

• Po zakończeniu konwersji aplikacji w trybie agenta program automatycznie generuje i otwiera kompleksowy raport.
• Raport zawiera szczegółowe wyniki i zalecane następne kroki konwersji.

W przypadku kompleksowych wskazówek dotyczących raportów: Zobacz wygenerowane raporty z konwersji aplikacji Oracle do Azure Database for PostgreSQL (wersja zapoznawcza), aby uzyskać szczegółowe informacje na temat interpretacji wyników konwersji, zrozumienia statusu plików oraz planowania strategii walidacji.

Krok 8. Porównanie zmian kodu przy użyciu funkcji różnic plików

• Kliknij prawym przyciskiem myszy przekonwertowany plik (na przykład .java plik) i wybierz pozycję Porównaj pary plików migracji aplikacji.
• Spowoduje to otwarcie obok siebie widoku oryginalnych i przekonwertowanych plików.
• Użyj tego polecenia, aby zweryfikować przekształcenia krytyczne przed rozpoczęciem testowania.

Efektywna strategia porównywania plików: Zobacz raporty wygenerowane przy konwersji aplikacji z Oracle do Azure Database dla PostgreSQL (Podgląd), aby uzyskać wskazówki dotyczące priorytetyzacji plików do przeglądu i skupienia wysiłków weryfikacyjnych.

Krok 9. Weryfikowanie przekonwertowanego kodu aplikacji

Podstawowe kroki weryfikacji:

• Konfigurowanie środowiska testowego nieprodukcyjnego przy użyciu przekonwertowanego schematu bazy danych PostgreSQL
• Testowanie łączności z bazą danych przy użyciu nowych parametrów połączenia bazy danych PostgreSQL
• Wykonywanie krytycznych przepływów pracy biznesowych w celu zweryfikowania zachowania aplikacji
• Weryfikowanie wyników zapytania SQL względem oczekiwanych wyników z bazy danych Oracle
• Adres oflagowanych obszarów zidentyfikowanych w raporcie konwersji

Ważna

Systemy sztucznej inteligencji mogą czasami popełniać błędy. Aby zapobiec regresji funkcjonalnej, problemom z zabezpieczeniami lub problemom z dostępem do danych, niezależnie zweryfikuj cały przekonwertowany kod aplikacji przed wdrożeniem w środowisku produkcyjnym.

Systematyczne podejście do walidacji: Użyj ram walidacyjnych w Najlepsze praktyki konwersji kodu aplikacji Oracle na Azure Database for PostgreSQL (Preview), aby priorytetyzować testowanie na podstawie złożoności twojej integracji Oracle oraz wyników raportu konwersji.

Kroki po konwersji

Po zakończeniu konwersji aplikacji:

• Uruchamianie testów jednostkowych: wykonaj zestaw testów aplikacji względem przekonwertowanego kodu.
• Testowanie integracji: przetestuj aplikację przy użyciu bazy danych PostgreSQL.
• Testowanie wydajności: sprawdź, czy wydajność zapytań spełnia wymagania.
• Przegląd kodu: członkowie zespołu mogą przeglądać przekonwertowany kod pod kątem dokładności.
• Aktualizacja dokumentacji: zaktualizuj dowolną dokumentację, która odwołuje się do funkcji specyficznych dla firmy Oracle.

Kompleksowe strategie walidacji: Zobacz Najlepsze praktyki przekształcania kodu aplikacji Oracle do Azure Database for PostgreSQL (wersja zapoznawcza) dla szczegółowych struktur walidacyjnych, priorytetów testowania oraz metod koordynacji zespołu, w oparciu o złożoność Twojej konwersji.

Aby uzyskać więcej informacji na temat rozszerzenia Visual Studio Code, odwiedź stronę Rozszerzenie PostgreSQL dla Visual Studio Code

Treści powiązane

• Czym jest konwersja aplikacji Oracle do Azure Database for PostgreSQL (wersja zapoznawcza)?
• Raporty wygenerowane podczas konwersji aplikacji z Oracle do Azure Database for PostgreSQL (wersja próbna)
• Najlepsze praktyki dotyczące konwertowania kodu aplikacji Oracle na Azure Database for PostgreSQL (wersja zapoznawcza)
• Ograniczenia konwersji aplikacji z Oracle do Azure Database for PostgreSQL (wersja zapoznawcza)