Zelfstudie: Oracle naar Azure Database for PostgreSQL conversie van flexibele servertoepassingen (preview)

In deze zelfstudie wordt u begeleid bij het converteren van Oracle-clienttoepassingscode naar Azure Database for PostgreSQL met behulp van de Visual Studio Code PostgreSQL-extensie met GitHub Copilot Agent-modus om codetransformatie te automatiseren en te valideren.

Het omvat het instellen van uw omgeving, het importeren van uw toepassingscodebasis, het uitvoeren van het conversieproces en het controleren van de gegenereerde PostgreSQL-compatibele code. Voordat u begint, moet u ervoor zorgen dat u een schemaconversieproject hebt voltooid voor optimale resultaten.

Dit is wat u kunt verwachten tijdens de conversie:

Omgeving instellen: GitHub Copilot Agentmodus configureren met het juiste AI-model
Codebase importeren: Organiseer uw toepassingscode in de structuur van het migratieproject
AI-verwerking: GitHub Copilot verwerkt en toepassingscode converteert met behulp van databasecontext
TODO taakuitvoering: geautomatiseerde generatie van takenlijsten en systematische conversie
Rapportgeneratie: Uitgebreid conversierapport met resultaten en aanbevelingen
Bestandsvergelijking: ingebouwde diff-hulpprogramma's voor het controleren van de oorspronkelijke versus geconverteerde code

Prerequisites

In deze sectie worden de vereisten beschreven voor het gebruik van de functie voor applicatieconversie, waarmee Oracle-databases naar Azure Database for PostgreSQL kunnen worden omgezet in Visual Studio Code, voordat u een conversie start.

Systeemvereisten

Voorwaarde	Specificatie
Visual Studio Code versie	1.95.2 of hoger
GitHub Copilot-abonnement	Pro+, Business, Enterprise

Ondersteuning van het besturingssysteem

Platform	Architectuur
Windows	x64 en ARM64
Linux	x64 en ARM64
macOS	x64 (Intel) en ARM64 (Apple Silicon)

Vereisten voor AI-modellen

U hebt een van de volgende AI-modellen nodig die zijn geconfigureerd in GitHub Copilot agentmodus:

Model	Versie
Claude	Sonnet 4.6 of Opus 4.6 of hoger

Voordat u de toepassingsconversie start, stelt u uw GitHub Copilot agentmodusmodel in op Claude Sonnet 4.6 of Claude Opus 4.6 of hoger voor optimale codetransformatieresultaten.

Ondersteuning voor PostgreSQL-versies

Doeldatabase	Versie
Azure Database voor PostgreSQL Flexibele Server	PostgreSQL versie 15 of hoger
Azure HorizonDB	PostgreSQL versie 17 of hoger

Aanbeveling voor schemaconversie

Hoewel het niet nodig is om vooraf een databaseschemaconversie uit te voeren, wordt het voltooien van een schemamigratie eerst sterk aanbevolen. Als u uw Oracle-schema al hebt geconverteerd naar PostgreSQL, biedt het conversieproces van de toepassing nauwkeurigere context en resultaten van codetransformatie van hogere kwaliteit via:

Coderingsnotities: metagegevensartefacten die tijdens de schemaconversie worden gegenereerd (zie wat zijn coderingsnotities? hieronder)
Databasecontext: Directe toegang tot geconverteerde schemaobjecten
Gegevenstype-mapping: Nauwkeurig begrip van type-transformaties

Andere voorwaarden

Databaseconnectiviteit met uw Azure Database for PostgreSQL-exemplaar
Toegang tot Visual Studio Code-uitbreidingsmarktplaats en GitHub Copilot-services

Wat zijn codeernotities?

Codenotities zijn metagegevensartefacten die automatisch worden gegenereerd tijdens de schemaconversiefase. Ze leggen belangrijke transformatiedetails en inzichten vast van uw Oracle-naar-PostgreSQL-schemaconversie die het proces later gebruikt om de conversie van toepassingscode te verbeteren.

Het coderen van notities kan informatie bevatten, zoals:

Gegevenstype mappings en structurele wijzigingen
Conversiedetails voor reeksen, identiteiten en samengestelde typen
Aanpassingen aan datum-/tijd- of interval-implementaties
Verwijzingen naar tabellen met beperkingen voor referentiële integriteit
Samenvattingen van complexe Oracle-pakketten, waaronder procedure- en functiehandtekeningen
Aanvullende door AI gegenereerde hints om de nauwkeurigheid van codevertalingen te verbeteren

Tijdens de conversie van toepassingen gebruikt het AI-model deze notities als contextuele signalen om nauwkeuriger en semantisch uitgelijnde PostgreSQL-compatibele code te produceren.

Proces voor toepassingsconversie

In deze sectie wordt de volledige werkstroom voor toepassingsconversie beschreven: stel uw omgeving in, importeer uw codebasis, voer de conversie uit, controleer het gegenereerde rapport en vergelijk bestandswijzigingen.

Stap 1: Uw omgeving instellen

Open Visual Studio Code met de PostgreSQL-extensie geïnstalleerd.
Open de GitHub Copilot chatinterface.
Selecteer Claude Sonnet 4.6 of Claude Opus 4.6 voor het model.

Het gebruik van Claude Sonnet 4.6 of Claude Opus 4.6 is vereist voor optimale toepassingsconversieresultaten. Lagere modellen kunnen minder nauwkeurige conversies produceren.

Stap 2: Uw migratieproject openen

Open de werkruimte met uw schemaconversieproject.
Navigeer naar de mapstructuur van het migratieproject:
```
.github/postgres-migration/project_name/
```
Controleer of de projectstructuur de benodigde mappen en bestanden van schemaconversie bevat.

Stap 3: Uw codebasis kopiëren naar het migratieproject

Zoek de application_code map in uw project:

.github/postgres-migration/project_name/application_code/

Kopieer de codebasismap die u wilt migreren naar de application_code map in uw projectmap.
Organiseer bestanden logisch om systematische conversie te vergemakkelijken.

Bewaar de oorspronkelijke toepassingscode op een afzonderlijke locatie als back-up. Kopieer alleen de bestanden die u wilt converteren naar de structuur van het migratieproject.

Stap 4: Migratie van clientcode starten

Selecteer In het deelvenster Migratie van postgreSQL-extensie de optie Toepassing migreren om de wizard toepassingsconversie te starten.
Selecteer in het formulier dat wordt geladen de map die u hebt gekopieerd naar de hoofdmap van uw werkruimte.
Kies de database met de context voor uw toepassing:
- De PostgreSQL-database waar u de geconverteerde DDL hebt geïmplementeerd, of
- De PostgreSQL-database waarin uw toepassingsschema al bestaat
Selecteer Applicatie converteren.

Met deze actie worden de volgende processen gestart:

Roept een aangepaste samengestelde prompt en agent-modus hulpmiddel aan
Hiermee wordt een takenlijst gegenereerd met taken waaraan de agentmodus gaat werken
Maakt verbinding met uw database en leest deze voor verbeterde context
Codebestanden van toepassingen systematisch converteren

Stap 5: Voortgang van conversie controleren

Bekijk de GitHub Copilot Agent Mode-interface tijdens het verwerken van bestanden.
De agent werkt systematisch via de gegenereerde TODO-lijst.
Bekijk eventuele prompts of vragen van de agent waarvoor mogelijk invoer is vereist.
Sta toe dat het conversieproces volledig kan worden voltooid voordat u de resultaten controleert.

Stap 6: Verbeterde conversie van Java met GitHub Copilot-extensie voor app-modernisering (optioneel)

Als je werkt met Java-code: Je kunt je conversieproces verbeteren door de GitHub Copilot App Modernization Extension te installeren voordat je met je conversie begint.

Automatische testcompilatie

De twee VS Code-extensies communiceren met elkaar om naadloze integratie te bieden. Bij het converteren van Java code voert de app-moderniseringsextensie automatisch een testcompilatie van uw geconverteerde code uit om eventuele syntaxisfouten of compilatieproblemen vroeg in het proces te identificeren.

Automatische eenheidstestgeneratie

Op basis van uw geconverteerde codebasis genereert de app-moderniseringsextensie automatisch eenheidstests om te controleren of uw geconverteerde toepassing correct werkt. Deze integratie maakt gebruik van de mogelijkheden van de App Modernization Extension voor het volgende:

Uw geconverteerde Java klassen en methoden analyseren
Geschikte testcases genereren voor kritieke codepaden
Testarmaturen maken die werken met uw PostgreSQL-databaseverbindingen

Het installeren van de GitHub Copilot App Modernization Extension wordt ten zeerste aanbevolen voor Java migratieprojecten, omdat de validatie aanzienlijk wordt versneld en de conversiekwaliteit wordt verbeterd door geautomatiseerde compilatiecontroles en het genereren van tests.

Stap 7: Rapport voor codeconversie controleren

Wanneer de conversie van de toepassing is voltooid in de agentmodus, wordt automatisch een uitgebreid rapport gegenereerd en geopend.
Het rapport bevat gedetailleerde resultaten en aanbevolen volgende stappen voor uw conversie.

Voor uitgebreide richtlijnen voor rapporten: Zie de Oracle naar Azure Database voor PostgreSQL gegenereerde rapporten voor toepassingsconversie (preview) voor het bekijken van gedetailleerde informatie over het interpreteren van uw conversieresultaten, het begrijpen van bestandstatussen en het plannen van uw validatiestrategie.

Stap 8: Codewijzigingen vergelijken met de functie Bestandsverschil

Klik met de rechtermuisknop op een geconverteerd bestand (bijvoorbeeld een .java bestand) en selecteer App-migratiebestandparen vergelijken.
Hiermee opent u een weergave naast elkaar van oorspronkelijke en geconverteerde bestanden.
Gebruik deze methode om kritieke transformaties te valideren voordat u gaat testen.

Effectieve strategie voor bestandsvergelijking: Zie de gegenereerde rapporten voor toepassingsconversie van Oracle naar Azure Database for PostgreSQL (preview) voor hulp bij het prioriteren van welke bestanden u als eerste moet bekijken en hoe u uw validatie-inspanningen kunt concentreren.

Stap 9: Code van geconverteerde toepassing valideren

Essentiële validatiestappen:

Een testomgeving voor niet-productie instellen met uw geconverteerde PostgreSQL-schema
Databaseconnectiviteit testen met de nieuwe PostgreSQL-verbindingsreeksen
Kritieke bedrijfswerkstromen uitvoeren om het gedrag van toepassingen te verifiëren
SQL-queryresultaten valideren op de verwachte resultaten van Oracle
Gemarkeerde gebieden adres in het conversierapport

Important

AI-systemen kunnen af en toe fouten maken. Als u functionele regressies, beveiligingsproblemen of problemen met gegevenstoegang wilt voorkomen, valideert u onafhankelijk alle geconverteerde toepassingscode voordat u implementeert in productie.

Systematische validatiebenadering: Gebruik de validatieframeworks in de Best practices voor het omzetten van Oracle-toepassingscode naar Azure Database voor PostgreSQL (preview) om tests te prioriteren op basis van de complexiteit van je Oracle-integratie en de resultaten van het conversierapport.

Stappen na de conversie

Nadat de toepassingsconversie is voltooid:

Eenheidstests uitvoeren: voer de testsuite van uw toepassing uit op basis van de geconverteerde code.
Integratietests: Test de toepassing met uw PostgreSQL-database.
Prestatietests: controleer of de queryprestaties voldoen aan de vereisten.
Codebeoordeling: laat teamleden de geconverteerde code controleren op nauwkeurigheid.
Documentatie-update: Werk alle documentatie bij die verwijst naar Oracle-specifieke functies.

Uitgebreide validatiestrategieën: Zie Best-practices voor het converteren van Oracle-toepassingscode naar Azure Database for PostgreSQL (Preview) voor gedetailleerde validatieframeworks, testprioriteiten en methoden voor teamcoördinatie op basis van uw conversiecomplexiteit.

Ga voor meer informatie over de Visual Studio Code-extensie naar de PostgreSQL-extensie voor Visual Studio Code

Feedback

Is deze pagina nuttig?

Laatst bijgewerkt om 2026-06-08