Tutorial: Anwendungskonvertierung von Oracle zu Azure Database for PostgreSQL – Flexibler Server (Vorschau)

Dieses Tutorial führt Sie durch die Umwandlung des Oracle-Clientanwendungscodes in eine Azure-Datenbank für PostgreSQL, indem Sie die Visual Studio Code PostgreSQL-Erweiterung im GitHub Copilot-Agent-Modus verwenden, um die Codetransformation zu automatisieren und zu validieren.

Es umfasst das Einrichten Ihrer Umgebung, das Importieren Ihrer Anwendungscodebasis, das Ausführen des Konvertierungsprozesses und das Überprüfen des generierten PostgreSQL-kompatiblen Codes. Bevor Sie beginnen, stellen Sie sicher, dass Sie ein Schemakonvertierungsprojekt abgeschlossen haben, um optimale Ergebnisse zu erzielen.

Hier erfahren Sie, was Sie während der Konvertierung erwarten können:

Umgebungseinrichtung: Konfigurieren Sie den GitHub Copilot-Agentenmodus mit dem entsprechenden KI-Modell
Codebaseimport: Organisieren des Anwendungscodes in der Migrationsprojektstruktur
AI-Verarbeitung: GitHub Copilot verarbeitet und konvertiert Anwendungscode mithilfe des Datenbankkontexts.
TODO-Aufgabenausführung: Automatisierte Aufgabenlistengenerierung und systematische Konvertierung
Berichterstellung: Umfassender Konvertierungsbericht mit Ergebnissen und Empfehlungen
Dateivergleich: Integrierte Diff-Tools zum Überprüfen des ursprünglichen und konvertierten Codes

Voraussetzungen

In diesem Abschnitt werden die Voraussetzungen beschrieben, die erfüllt sein müssen, um die Funktion zur Umwandlung von Oracle in die Azure Database for PostgreSQL in Visual Studio Code zu nutzen, bevor Sie eine Konvertierung starten.

Systemanforderungen

Anforderung	Spezifikation
Visual Studio Code Version	1.95.2 oder höher
GitHub Copilot-Abonnement	Pro+, Business, Enterprise

Betriebssystemunterstützung

Plattform	Aufbau
Windows	x64 und ARM64
Linux	x64 und ARM64
macOS	x64 (Intel) und ARM64 (Apple Silicon)

KI-Modellanforderungen

Sie benötigen eines der folgenden KI-Modelle, die im GitHub Copilot Agentmodus konfiguriert sind:

Modell	Version
Claude	Sonnet 4.6 oder Opus 4.6 oder höher

Legen Sie vor beginn der Anwendungskonvertierung Ihr GitHub Copilot Agent Mode Model auf Claude Sonnet 4.6 oder Claude Opus 4.6 oder höher fest, um optimale Codetransformationsergebnisse zu erzielen.

PostgreSQL-Version Unterstützung

Zieldatenbank	Version
Azure-Datenbank für PostgreSQL Flexible Server	PostgreSQL Version 15 oder höher
Azure HorizonDB	PostgreSQL Version 17 oder höher

Empfehlung für die Schemakonvertierung

Obwohl es nicht erforderlich ist, eine Datenbankschemakonvertierung vorher durchzuführen, wird dringend empfohlen, zuerst eine Schemamigration abzuschließen. Wenn Sie Ihr Oracle-Schema bereits in PostgreSQL konvertiert haben, bietet der Anwendungskonvertierungsprozess genauere Kontext- und qualitätsreichere Codetransformationsergebnisse durch:

Codierungshinweise: Metadatenartefakte, die während der Schemakonvertierung generiert wurden (siehe Was sind Codierungsnotizen? unten)
Datenbankkontext: Direkter Zugriff auf konvertierte Schemaobjekte
Datentypzuordnungen: Genaues Verständnis von Typtransformationen

Andere Voraussetzungen

Datenbankkonnektivität mit Ihrer Azure Database for PostgreSQL Instanz
Zugriff auf Visual Studio Code Erweiterungs-Marketplace und GitHub Copilot-Dienste

Was sind Codierungsnotizen?

Codierungsnotizen sind Metadatenartefakte, die während der Schemakonvertierungsphase automatisch generiert werden. Sie erfassen wichtige Transformationsdetails und Einblicke aus Ihrer Oracle-zu-PostgreSQL-Schemakonvertierung, die der Prozess später verwendet, um die Konvertierung von Anwendungscode zu verbessern.

Codierungsnotizen können Informationen enthalten, z. B.:

Datentypzuordnungen und Strukturänderungen
Konvertierungsdetails für Sequenzen, Identitäten und zusammengesetzte Typen
Anpassungen an Datums-/Uhrzeit- oder Intervallimplementierungen
Verweise auf Tabellen mit Einschränkungen der referenziellen Integrität
Zusammenfassungen komplexer Oracle-Pakete, einschließlich Prozedur- und Funktionssignaturen
Zusätzliche KI-generierte Hinweise zur Verbesserung der Codeübersetzungsgenauigkeit

Während der Anwendungskonvertierung verwendet das KI-Modell diese Hinweise als kontextbezogene Signale, um präziseren und semantisch ausgerichteten PostgreSQL-kompatiblen Code zu erzeugen.

Prozess der Anwendungskonvertierung

In diesem Abschnitt wird der vollständige Workflow für die Anwendungskonvertierung erläutert: Einrichten Ihrer Umgebung, Importieren der Codebasis, Ausführen der Konvertierung, Überprüfen des generierten Berichts und Vergleichen von Dateiänderungen.

Schritt 1: Einrichten Ihrer Umgebung

Öffnen Sie Visual Studio Code mit installierter PostgreSQL-Erweiterung.
Öffnen Sie die GitHub Copilot Chatschnittstelle.
Wählen Sie Claude Sonnet 4.6 oder Claude Opus 4.6 für das Modell aus.

Die Verwendung von Claude Sonnet 4.6 oder Claude Opus 4.6 ist für optimale Anwendungskonvertierungsergebnisse erforderlich. Niedrigere Modelle können weniger genaue Konvertierungen erzeugen.

Schritt 2: Öffnen Des Migrationsprojekts

Öffnen Sie den Arbeitsbereich, der Ihr Schemakonvertierungsprojekt enthält.
Navigieren Sie zur Ordnerstruktur des Migrationsprojekts:
```
.github/postgres-migration/project_name/
```
Überprüfen Sie, ob die Projektstruktur die erforderlichen Ordner und Dateien aus der Schemakonvertierung enthält.

Schritt 3: Kopieren der Codebasis in das Migrationsprojekt

Suchen Sie den application_code Ordner in Ihrem Projekt:

.github/postgres-migration/project_name/application_code/

Kopieren Sie den Codebasisordner, den Sie in den application_code Ordner in Ihrem Projektordner migrieren möchten.
Organisieren Sie Dateien logisch, um eine systematische Konvertierung zu erleichtern.

Bewahren Sie den ursprünglichen Anwendungscode an einem separaten Speicherort als Sicherung auf. Kopieren Sie nur die Dateien, die Sie in die Migrationsprojektstruktur konvertieren möchten.

Schritt 4: Starten der Clientcodemigration

Wählen Sie im Bereich Migration der PostgreSQL-Erweiterung die Option "Anwendung migrieren" aus, um den Anwendungskonvertierungs-Assistenten zu starten.
Wählen Sie im geladenen Formular den Ordner aus, den Sie in das Stammverzeichnis Ihres Arbeitsbereichs kopiert haben.
Wählen Sie die Datenbank mit dem Kontext für Ihre Anwendung aus:
- Die PostgreSQL-Datenbank, in der Sie Ihre konvertierte DDL bereitgestellt haben, oder
- Die PostgreSQL-Datenbank, in der Ihr Anwendungsschema bereits vorhanden ist
Wählen Sie "Anwendung konvertieren" aus.

Diese Aktion initiiert die folgenden Prozesse:

Ruft ein benutzerdefiniertes zusammengesetztes Eingabeaufforderungs- und Agentenmodus-Tool auf.
Generiert eine TODO-Liste von Aufgaben, an denen der Agentenmodus arbeitet
Stellt eine Verbindung mit ihrer Datenbank her und liest sie für den erweiterten Kontext.
Konvertiert systematisch Anwendungscode-Dateien

Schritt 5: Überwachen des Konvertierungsfortschritts

Sehen Sie sich die GitHub Copilot-Agent-Modus-Schnittstelle an, während sie Dateien verarbeitet.
Der Agent arbeitet die generierte TODO-Liste systematisch ab.
Überprüfen Sie alle Eingabeaufforderungen oder Fragen des Agents, die möglicherweise Eingaben erfordern.
Zulassen, dass der Konvertierungsprozess vollständig abgeschlossen wird, bevor Die Ergebnisse überprüft werden.

Schritt 6: Erweiterte Java Konvertierung mit GitHub Copilot App-Modernisierungserweiterung (optional)

Wenn Sie mit Java Code arbeiten: Sie können ihren Konvertierungsprozess verbessern, indem Sie die GitHub Copilot App-Modernisierungserweiterung installieren, bevor Sie die Konvertierung starten.

Automatische Testkompilierung

Die beiden VS Code-Erweiterungen kommunizieren miteinander, um eine nahtlose Integration zu ermöglichen. Beim Konvertieren von Java Code führt die App-Modernisierungserweiterung automatisch eine Testkompilierung Des konvertierten Codes durch, um Syntaxfehler oder Kompilierungsprobleme frühzeitig im Prozess zu identifizieren.

Automatische Komponententestgenerierung

Basierend auf Ihrer konvertierten Codebasis generiert die App-Modernisierungserweiterung automatisch Komponententests, um zu überprüfen, ob sich Ihre konvertierte Anwendung ordnungsgemäß verhält. Diese Integration nutzt die Funktionen der App-Modernisierungserweiterung für:

Analysieren Der konvertierten Java Klassen und Methoden
Generieren geeigneter Testfälle für kritische Codepfade
Erstellen von Testinstallationen, die mit Ihren PostgreSQL-Datenbankverbindungen funktionieren

Die Installation der GitHub Copilot App-Modernisierungserweiterung wird für Java Migrationsprojekte dringend empfohlen, da sie die Validierung erheblich beschleunigt und die Konvertierungsqualität durch automatisierte Kompilierungsprüfungen und Testgenerierung verbessert.

Schritt 7: Überprüfen des Codekonvertierungsberichts

Wenn die Anwendungskonvertierung im Agentmodus abgeschlossen ist, wird automatisch ein umfassender Bericht generiert und geöffnet.
Der Bericht enthält detaillierte Ergebnisse und empfohlene nächste Schritte für Ihre Konvertierung.

Umfassende Anleitung für Berichte: Siehe die Oracle-zu-Azure-Datenbank für PostgreSQL Anwendungsumwandlung generierte Berichte (Vorschau) für detaillierte Informationen zum Interpretieren Ihrer Umwandlungsergebnisse, Verständnis der Dateistatus und Planung Ihrer Validierungsstrategie.

Schritt 8: Vergleichen von Codeänderungen mithilfe der Datei-Diff-Funktion

Klicken Sie mit der rechten Maustaste auf eine konvertierte Datei (z. B. eine .java Datei), und wählen Sie "App-Migrationsdateipaare vergleichen" aus.
Dadurch wird eine nebeneinander angeordnete Ansicht der ursprünglichen und konvertierten Dateien geöffnet.
Verwenden Sie diese, um kritische Transformationen vor dem Testen zu überprüfen.

Effektive Dateivergleichsstrategie: Sehen Sie sich die Oracle zu Azure Database for PostgreSQL Anwendungskonvertierungsberichte (Vorschau) an, um Anleitungen zur Priorisierung, welche Dateien zuerst überprüft werden sollten, und wie Sie Ihre Validierungsbemühungen fokussieren können, zu erhalten.

Schritt 9: Überprüfen des konvertierten Anwendungscodes

Grundlegende Überprüfungsschritte:

Einrichten einer Nichtproduktionstestumgebung mit Ihrem konvertierten PostgreSQL-Schema
Testen der Datenbankkonnektivität mit den neuen PostgreSQL-Verbindungszeichenfolgen
Ausführen wichtiger Geschäftsworkflows zur Überprüfung des Anwendungsverhaltens
Überprüfen von SQL-Abfrageergebnissen anhand erwarteter Ergebnisse von Oracle
Adressieren markierter Bereiche im Konvertierungsbericht

Important

KI-Systeme können gelegentlich Fehler machen. Um funktionsbezogene Regressionen, Sicherheitsprobleme oder Datenzugriffsprobleme zu verhindern, überprüfen Sie unabhängig voneinander alle konvertierten Anwendungscode, bevor sie in der Produktion bereitgestellt werden.

Systematische Validierungsansatz: Verwenden Sie die Validierungsframeworks in den Best-Methoden zum Konvertieren von Oracle-Anwendungscode in Azure Database for PostgreSQL (Vorschau), um Tests basierend auf Ihrer Oracle-Integrationskomplexität und Konvertierungsberichtsergebnisse zu priorisieren.

Schritte nach der Konvertierung

Nach Abschluss der Anwendungskonvertierung:

Ausführen von Komponententests: Führen Sie die Testsuite Ihrer Anwendung anhand des konvertierten Codes aus.
Integrationstests: Testen Sie die Anwendung mit Ihrer PostgreSQL-Datenbank.
Leistungstests: Überprüfen, ob die Abfrageleistung anforderungen erfüllt.
Codeüberprüfung: Lassen Sie Teammitglieder den konvertierten Code auf Genauigkeit überprüfen.
Dokumentationsupdate: Aktualisieren Sie alle Dokumentationen, die auf Oracle-spezifische Features verweisen.

Umfassende Validierungsstrategien: Siehe Best Practices für die Umwandlung von Oracle-Anwendungscode in die Azure-Datenbank für PostgreSQL (Vorschau) für detaillierte Validierungsrahmen, Testprioritäten und Teamkoordinierungsansätze basierend auf der Komplexität Ihrer Umwandlung.

Weitere Informationen zur Visual Studio Code Erweiterung finden Sie in der PostgreSQL-Erweiterung für Visual Studio Code

Feedback

War diese Seite hilfreich?

Zuletzt aktualisiert um 2026-06-08