Självstudie: programkonvertering från Oracle till Azure Database for PostgreSQL – flexibel server (förhandsversion)

Den här handledningen vägleder dig genom konverteringen av Oracle-klientprogramkod till Azure Database for PostgreSQL, med hjälp av Visual Studio Code PostgreSQL-tillägget och GitHub Copilot Agent Mode för att automatisera och validera kodtransformeringen.

Den beskriver hur du konfigurerar din miljö, importerar programkodbasen, kör konverteringsprocessen och granskar den genererade PostgreSQL-kompatibla koden. Innan du börjar kontrollerar du att du har slutfört ett schemakonverteringsprojekt för optimala resultat.

Det här kan du förvänta dig under konverteringen:

Miljökonfiguration: Konfigurera GitHub Copilot agentläge med lämplig AI-modell
Codebase-import: Organisera programkoden i migreringsprojektstrukturen
AI-bearbetning: GitHub Copilot processer och konverterar programkod med hjälp av databaskontext
Körning av TODO-uppgift: Automatisk generering av uppgiftslistor och systematisk konvertering
Rapportgenerering: Omfattande konverteringsrapport med resultat och rekommendationer
Filjämförelse: Inbyggda diff-verktyg för att granska original eller konverterad kod

Förutsättningar

I det här avsnittet beskrivs kraven för att använda Oracle till Azure Database for PostgreSQL-konverteringsfunktionen i Visual Studio Code innan du påbörjar en konvertering.

Systemkrav

Krav	Specifikation
Visual Studio Kod version	1.95.2 eller senare
GitHub Copilot prenumeration	Pro+, Business, Enterprise

Stöd för operativsystem

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

Krav för AI-modell

Du behöver någon av följande AI-modeller som konfigurerats i GitHub Copilot agentläge:

Modell	Version
Claude	Sonett 4.6 eller Opus 4.6 eller senare

Innan du påbörjar programkonverteringen anger du din GitHub Copilot agentlägesmodell till Claude Sonnet 4.6 eller Claude Opus 4.6 eller senare för optimala kodtransformeringsresultat.

Stöd för PostgreSQL-version

Måldatabas	Version
Flexibel server för Azure Database for PostgreSQL	PostgreSQL version 15 eller senare
Azure HorizonDB	PostgreSQL version 17 eller senare

Rekommendation för schemakonvertering

Även om det inte krävs för att utföra en databasschemakonvertering i förväg rekommenderar vi starkt att du slutför en schemamigrering först. Om du redan har konverterat Oracle-schemat till PostgreSQL ger programkonverteringsprocessen mer exakt kontext och kodtransformeringsresultat av högre kvalitet genom:

Kodningsanteckningar: Metadataartefakter som genereras under schemakonvertering (se Vad är kodningsanteckningar? nedan)
Databaskontext: Direktåtkomst till konverterade schemaobjekt
Datatypsmappningar: Korrekt förståelse av typtransformeringar

Övriga förutsättningar

Databasanslutning till din Azure Database for PostgreSQL-instans
Åtkomst till marketplace- och GitHub Copilot-tjänster för Visual Studio Code tillägg

Vad är kodningsanteckningar?

Kodningsanteckningar är metadataartefakter som genereras automatiskt under schemakonverteringsfasen. De samlar in viktig transformeringsinformation och insikter från din Oracle-till-PostgreSQL-schemakonvertering som processen senare använder för att förbättra programkodkonverteringen.

Kodningsanteckningar kan innehålla information som:

Datatypsmappningar och strukturella ändringar
Konverteringsinformation för sekvenser, identiteter och sammansatta typer
Justeringar av implementeringar av datum/tid eller intervall
Referenser till tabeller med referensintegritetsbegränsningar
Sammanfattningar av komplexa Oracle-paket, inklusive procedurer och funktionssignaturer
Ytterligare AI-genererade tips för att förbättra kodöversättningens noggrannhet

Under programkonverteringen använder AI-modellen dessa anteckningar som sammanhangsbaserade signaler för att producera mer exakt och semantiskt justerad PostgreSQL-kompatibel kod.

Programkonverteringsprocess

Det här avsnittet går igenom det fullständiga arbetsflödet för programkonvertering: konfigurera din miljö, importera din kodbas, köra konverteringen, granska den genererade rapporten och jämföra filändringar.

Steg 1: Konfigurera din miljö

Öppna Visual Studio Code med PostgreSQL-tillägget installerat.
Öppna GitHub Copilot chattgränssnittet.
Välj Claude Sonnet 4.6 eller Claude Opus 4.6 som modell.

Användning av Claude Sonnet 4.6 eller Claude Opus 4.6 krävs för optimala programkonverteringsresultat. Lägre modeller kan ge mindre exakta konverteringar.

Steg 2: Öppna migreringsprojektet

Öppna arbetsytan som innehåller ditt schemakonverteringsprojekt.
Gå till mappstrukturen för migreringsprojekt:
```
.github/postgres-migration/project_name/
```
Kontrollera att projektstrukturen innehåller nödvändiga mappar och filer från schemakonvertering.

Steg 3: Kopiera din kodbas till migreringsprojektet

application_code Leta upp mappen i projektet:

.github/postgres-migration/project_name/application_code/

Kopiera den kodbasmapp som du vill migrera till mappen i projektmappen application_code .
Organisera filer logiskt för att underlätta systematisk konvertering.

Behåll den ursprungliga programkoden på en separat plats som en säkerhetskopia. Kopiera endast de filer som du vill konvertera till migreringsprojektstrukturen.

Steg 4: Starta migrering av klientkod

I migreringspanelen för PostgreSQL-tillägget väljer du Migrera program för att starta guiden för programkonvertering.
I det formulär som öppnas väljer du den mapp som du kopierade till arbetsytans rot.
Välj den databas som har kontexten för ditt program:
- PostgreSQL-databasen där du distribuerade din konverterade DDL, eller
- PostgreSQL-databasen där programschemat redan finns
Välj Konvertera program.

Den här åtgärden initierar följande processer:

Anropar en anpassad sammansatt fråga och agentlägesverktyget
Genererar en TODO-lista över uppgifter som agentläget fortsätter att arbeta med
Ansluter till och läser databasen för förbättrad kontext
Konverterar systematiskt programkodfiler

Steg 5: Övervaka konverteringsframsteg

Titta på GitHub Copilot agentlägesgränssnittet när det bearbetar filer.
Agenten arbetar systematiskt med den genererade TODO-listan.
Granska eventuella uppmaningar eller frågor från agenten som kan kräva information.
Tillåt att konverteringsprocessen slutförs helt innan du granskar resultaten.

Steg 6: Förbättrad Java konvertering med GitHub Copilot appmoderniseringstillägg (valfritt)

Om du arbetar med Java kod: Du kan förbättra konverteringsprocessen genom att installera GitHub Copilot Tillägg för appmodernisering innan du påbörjar konverteringen.

Automatisk testkompilering

De två VS Code-tilläggen kommunicerar med varandra för att ge sömlös integrering. När du konverterar Java kod utför appmoderniseringstillägget automatiskt en testkompilering av din konverterade kod för att identifiera eventuella syntaxfel eller kompileringsproblem tidigt i processen.

Automatisk enhetstestgenerering

Baserat på din konverterade kodbas genererar appmoderniseringstillägget automatiskt enhetstester för att verifiera att det konverterade programmet fungerar korrekt. Den här integreringen utnyttjar funktionerna i appmoderniseringstillägget för att:

Analysera dina konverterade Java klasser och metoder
Generera lämpliga testfall för kritiska kodsökvägar
Skapa testfixturer som fungerar med dina PostgreSQL-databasanslutningar

Installation av GitHub Copilot appmoderniseringstillägg rekommenderas starkt för Java migreringsprojekt, eftersom det avsevärt påskyndar valideringen och förbättrar konverteringskvaliteten genom automatiserade kompileringskontroller och testgenerering.

Steg 7: Granska kodkonverteringsrapport

När programkonverteringen är klar i agentläge genereras automatiskt och öppnas en omfattande rapport.
Rapporten innehåller detaljerade resultat och rekommenderade nästa steg för konverteringen.

För omfattande rapportvägledning: Se Oracle till Azure Database för PostgreSQL programkonverteringsrapporter (förhandsversion) för detaljerad information om hur du tolkar dina konverteringsresultat, förstår filstatusar och planerar din valideringsstrategi.

Steg 8: Jämför kodändringar med hjälp av fildifffunktionen

Högerklicka på en konverterad fil (till exempel en .java fil) och välj Jämför filpar för appmigrering.
Då öppnas en sida vid sida-vy över ursprungliga och konverterade filer.
Använd detta för att verifiera kritiska transformeringar innan du testar.

Effektiv strategi för filjämförelse: Se rapporter om konvertering av applikationer från Oracle till Azure Database for PostgreSQL (förhandsgranskning) för vägledning om hur du prioriterar vilka filer som ska granskas först och hur du fokuserar dina valideringsinsatser.

Steg 9: Verifiera konverterad programkod

Viktiga valideringssteg:

Konfigurera en icke-produktionstestmiljö med ditt konverterade PostgreSQL-schema
Testa databasanslutningen med de nya PostgreSQL-anslutningssträngarna
Köra kritiska affärsarbetsflöden för att verifiera programmets beteende
Verifiera SQL-frågeresultat mot förväntade resultat från Oracle
Adressflaggade områden som identifieras i konverteringsrapporten

Important

AI-system kan ibland göra misstag. För att förhindra funktionella regressioner, säkerhetsproblem eller problem med dataåtkomst verifierar du oberoende all konverterad programkod innan du distribuerar till produktion.

Systematisk valideringsmetod: Använd valideringsramverken i Bästa metoder för att konvertera Oracle-programkod till Azure Database for PostgreSQL (förhandsversion) för att prioritera testning baserat på oracle-integreringens komplexitet och konverteringsrapportresultat.

Steg efter konvertering

När du har slutfört programkonverteringen:

Kör enhetstester: Kör programmets testpaket mot den konverterade koden.
Integreringstestning: Testa programmet med postgreSQL-databasen.
Prestandatestning: Verifiera att frågeprestanda uppfyller kraven.
Kodgranskning: Låt teammedlemmar granska den konverterade koden för noggrannhet.
Dokumentationsuppdatering: Uppdatera all dokumentation som refererar till Oracle-specifika funktioner.

Omfattande valideringsstrategier: Se Bästa praxis för att konvertera Oracle-applikationskod till Azure Database för PostgreSQL (Förhandsgranskning) för detaljerade valideringsramverk, testningsprioriteter och sätt för teamkoordinering utifrån din konverteringskomplexitet.

Mer information om tillägget Visual Studio Code finns i PostgreSQL-tillägget för Visual Studio Code

Feedback

Var den här sidan till hjälp?

Uppdaterades senast 2026-06-08