Konvertierung von Oracle-Schemas und Anwendungen für Azure PostgreSQL

Die PostgreSQL-Erweiterung für Visual Studio Code bietet einen geführten Workflow für Oracle-Schema- und Anwendungskonvertierung. Die Schemakonvertierung unterstützt Azure Database for PostgreSQL flexible server und Azure HorizonDB sowohl für die Schemaüberprüfung als auch für die Bereitstellung. In diesem Leitfaden wird erläutert, wie die Schema- und Anwendungsworkflows zusammenpassen. Verwenden Sie das Tutorial zur Schemakonvertierung für das vollständige Konfigurations- und Konvertierungsverfahren. Planen Sie die Migration von Zeilendaten separat.

Important

Schema- und Anwendungskonvertierung sind nur in Visual Studio Code verfügbar.

Zusammenpassen von Schema- und Anwendungskonvertierung

Verwenden Sie für eine kombinierte Schema- und Anwendungskonvertierung die beiden Workflows nacheinander. Die Schemakonvertierung erzeugt die PostgreSQL Data Definition Language (DDL) für Ihre Datenbankobjekte, und die Anwendungskonvertierung aktualisiert den Code, der diese aufruft. Die Anwendungskonvertierung kann auch unabhängig ausgeführt werden.

Schemakonvertierung

Die Schemakonvertierung liest das Oracle-Datenwörterbuch für die ausgewählten Schemas und verwendet Ihre Microsoft Foundry-Bereitstellung zum Generieren von PostgreSQL DDL. Das Tool versucht die Kompilierung in der Schemaüberprüfungsdatenbank und verwendet verfügbare statische Überprüfungen, um Probleme zu identifizieren. Diese Prüfungen belegen weder ein entsprechendes Laufzeitverhalten noch Produktionsbereitschaft. Eine Ausführung erzeugt:

  • PostgreSQL-Dateien .sql auf Objektebene in postgres_ddl, organisiert nach Oracle-Schema und Objekttyp.
  • Ein HTML-Konvertierungsbericht mit Erkennungs-, Extraktions- und Konvertierungsergebnissen, Konvertierungsraten und Notizen auf Objektebene.
  • Objektzuordnungen und Notizen, die Sie in Conversion Objekt-Explorer prüfen können, einschließlich Objekten, die manuelle Änderungen benötigen.
  • Setupanweisungen und Skripts, die die Objektdateien in postgres_ddl für einen separaten Bereitstellungsvorgang verwenden.
  • Hinweise zur Codierung, die die Oracle-Muster beschreiben, die im Schema gefunden wurden, und wie sie PostgreSQL zugeordnet werden.

Anwendungskonvertierung

Die Anwendungskonvertierung zielt auf den Oracle-spezifischen Code ab, der die Datenbank umgibt: SQL-Skripts, gespeicherte Prozeduraufrufe, Ladesteuerungsdateien, Shellskripts und Java Dateien. Wenn verfügbar, dienen Codierungshinweise aus der Schemakonvertierung als Leitfaden für Änderungen an Objektnamen, Typen und Aufrufkonventionen. Überprüfen und testen Sie diese Änderungen; Generierte Notizen garantieren nicht das richtige Anwendungsverhalten.

Sie können den datenbankbezogenen Anwendungscode innerhalb dieser Erweiterung konvertieren oder die Aufgabe an die GitHub Copilot-Erweiterung zur Anwendungsmodernisierung übergeben, um eine vollständige Modernisierung durchzuführen. Beim Konvertieren eines Ladeskripts oder einer anderen Anwendungsdatei wird keine Zeilendatenmigration ausgeführt.

Sequenzieren Sie die beiden Durchläufe

Führen Sie in einem kombinierten Konvertierungsworkflow zuerst die Schemakonvertierung aus, damit die anschließende Anwendungskonvertierung ihre Codehinweise und konvertierten Objektnamen verwenden kann. Überprüfen Sie das Schema, und beheben Sie die erforderlichen Änderungen, bevor Sie Anwendungscode konvertieren. Wenn Sie später eine PostgreSQL-Definition bearbeiten, überprüfen Sie die Anwendungsaufrufer erneut. Das erneute Ausführen einer abgeschlossenen Schemakonvertierung wird nicht unterstützt.

Voraussetzungen

Befolgen Sie für die Schemakonvertierung die Voraussetzungen des Tutorials:

  • Visual Studio Code, die PostgreSQL-Erweiterung, unterstützte Betriebssysteme und Copilot Anmeldung.
  • Oracle-Version, Metadatenberechtigungen, Konnektivität und Clientkonfiguration.
  • Schemaüberprüfungsdatenbank, PostgreSQL-Version, Berechtigungen und Erweiterungen.
  • Foundry-Modell, Ressourcenauthentifizierung und Kapazitätsplanung.

Stellen Sie für die Anwendungskonvertierung auch den Quellanwendungsordner zur Verfügung und bewahren Sie dessen ursprünglichen Inhalt auf, bevor Sie generierte Änderungen akzeptieren.

Schemakonvertierung aktivieren

Die pgsql.enableMigrations Einstellung steuert die Migrations-Ansicht und die zugehörigen Schema- und Anwendungskonvertierungsbefehle. Diese Einstellung ist standardmäßig aktiviert. Die Benutzeroberfläche behält Bezeichnungen wie Migrations und Migration Project erstellen für diese Konvertierungsworkflows bei.

Wenn die Migrationsansicht in der Randleiste angezeigt wird, öffnen Sie Visual Studio Code-Einstellungen (Ctrl+, auf Windows/Linux, Cmd+, auf macOS) und überprüfen Sie, ob pgsql.enableMigrations auf true festgelegt ist.

Erstellen eines Schemakonvertierungsprojekts

Der Project-Assistent sammelt Ihre Quelle, Ihren Erkennungsbereich, die Datenbankverbindung für die Schemavalidierung und die Modellkonfiguration. Das Tutorial ist die zentrale Schritt-für-Schritt-Anleitung; verwenden Sie den folgenden Einstiegspunkt und die folgenden Links, um sich darin zu orientieren.

Schritt 1: Project Setup

  1. Öffnen Sie die Migrationsansicht in der Randleiste.

  2. Starten Sie ein neues Projekt auf eine der folgenden Weisen:

    • Wenn der Arbeitsbereich noch kein Schemakonvertierung Project enthält, wählen Sie in der Ansicht + Create Migration Project aus.
    • Wählen Sie die + Schaltfläche in der Symbolleiste der Ansicht aus.
    • Klicken Sie im Explorer mit der rechten Maustaste auf einen Arbeitsbereichsordner, und wählen Sie Migrationsprojekt öffnen aus.
  3. Geben Sie einen Namen in das Feld "Project Name" ein.

  4. Wählen Sie "Weiter" aus: Oracle-Verbindung.

Screenshot der Seite „Neue Migrationsprojektseite“ mit dem Feld „Project Name“.

Die Liste der Voraussetzungen in diesem Screenshot gilt für die API-Schlüsselauthentifizierung. Sie können auch Microsoft Entra ID Authentifizierung verwenden.

Assistenten abschließen

Folgen Sie dem entsprechenden Tutorialschritt für jede Seite:

Assistentenstufe Anweisungen
Oracle-Verbindung und Schemaauswahl Stellen Sie eine Verbindung mit Oracle her.
Discovery, Quellberechtigungen und Abhängigkeiten Überprüfen Sie die Ermittlungsergebnisse.
Schemaüberprüfungsdatenbank und Erweiterungsprüfungen Konfigurieren Sie die Schemaüberprüfungsdatenbank.
Foundry-Ressource, Modell und Authentifizierung Konfigurieren Sie das Modell.

Warning

Bei der Konvertierung werden Schemas, die den ausgewählten Oracle-Schemas entsprechen, mithilfe von DROP SCHEMA ... CASCADE gelöscht und dann neu erstellt. Diese Aktion löscht vorhandene Objekte und Daten in diesen Schemas und kann abhängige Objekte in anderen Schemas entfernen. Verwenden Sie eine leere Datenbank zur Schemavalidierung oder eine eigens vorgesehene, unbenutzte Datenbank zur Schemavalidierung, die keine Objekte oder Daten enthält, die Sie beibehalten müssen.

Führen Sie die Schemakonvertierung aus

Nachdem Sie das Project erstellt haben, führen Sie die Schemakonvertierung aus, und überprüfen Sie die Ergebnisse im Project.

Extrahieren und Konvertieren von Schemas

  1. Wählen Sie "Migrieren" aus, um die Extraktion und Konvertierung zu starten.
  2. Überwachen Sie den Extraktions- und Konvertierungsfortschritt.
  3. Wenn das Projekt die Meldung Schemakonvertierung ist abgeschlossen anzeigt, wählen Sie "Konvertierungszusammenfassung überprüfen" aus.

Der HTML-Bericht wird automatisch geöffnet, wenn die Konvertierung abgeschlossen ist. Öffnen Sie ihn erneut, indem Sie den Konvertierungsbericht in der Konvertierungsbericht auswählen. Überprüfen Sie die Erkennungs-, Extraktions- und Konvertierungssummen separat; sie beschreiben verschiedene Phasen.

Konvertierte Objekte überprüfen

Verwenden Sie Conversion Objekt-Explorer, um verfügbare Definitionen zu vergleichen und Notizen für konvertierte und nicht konvertierte Objekte zu lesen. Fragen und Korrigieren bieten Copilot-Unterstützung; Resolve aktualisiert den erfassten Status eines überprüften Objekts, und Refresh aktualisiert die Berichte. Überprüfen Sie die Kompilierungsergebnisse und die Bereitstellungseinschluss separat.

Für Korrekturen abhängiger Objekte, Paketmember, manuelle Kompilierung und ein ausgearbeitetes Beispiel folgen Sie dem Konvertierungs-Objekt-Explorer.

Vorbereiten der Bereitstellung

Wählen Sie in der Konvertierung: Zusammenfassung die Setup-Anweisung aus, um die generierten Bereitstellungsanweisungen zu öffnen und das Setupverzeichnis anzuzeigen. Überprüfen Sie die Paket- und toolgenerierten Objektdateien, postgres_ddlführen Sie überprüfungsgeschützte Überprüfungen aus, und führen Sie dann das generierte Bereitstellungsskript für die Zieldatenbank aus, die Sie für Azure Database for PostgreSQL flexiblen Server oder Azure HorizonDB auswählen. Setup liest für die Bereitstellung die zuletzt gespeicherten Inhalte dieser Dateien ein, einschließlich manueller Bearbeitungen und Fix-Korrekturen. Dateien, die manuell zu postgres_ddl hinzugefügt wurden, werden von Setup ignoriert. Durch das Generieren von Setupdateien wird das Schema nicht bereitgestellt.

Überprüfen Sie Bereitstellungsberichte und validieren Sie das Verhalten von Daten und Anwendungen unabhängig vor der Produktionsverwendung. Voraussetzungen, Datenbankmodi und Befehle finden Sie unter Bereitstellen konvertierter Schemas mit der Setupoberfläche.

Konvertieren Sie Anwendungscode

Konvertieren Sie Oracle-spezifischen Anwendungscode (SQL-Skripts, gespeicherte Prozeduren, Steuerdateien für Ladeprogramme, Shellskripts oder Java-Dateien) in PostgreSQL-kompatible Äquivalente. Verwenden Sie für einen kombinierten Konvertierungsworkflow die überprüfte Schemaausgabe als Kontext. Die Anwendungskonvertierung ist ein Vorschaufeature.

Wählen Sie eine Konvertierungsmethode aus.

Die Erweiterung bietet zwei Pfade für die Anwendungscodekonvertierung:

  • Vollständige App-Modernisierung: Wenn Sie die GitHub App Copilot modernization extension installieren, wählen Sie „Migrieren mithilfe der App-Modernisierung“ aus, um mit Codierungsnotizen aus der Schemakonvertierung fortzufahren. Wählen Sie "Codierungsnotizen anzeigen " aus, um die generierten Anleitungen zu überprüfen, bevor Sie fortfahren.
  • Option „Nur Datenbank“: Um nur datenbankbezogenen Anwendungscode in dieser Erweiterung zu konvertieren, wählen Sie Mit PostgreSQL-Erweiterung migrieren aus.

Konvertieren von Anwendungscode innerhalb der Erweiterung

  1. Starten Sie auf der Anwendungsmigrationskarte den Anwendungskonvertierungsworkflow. Wenn eine Methodenauswahl angezeigt wird, wählen Sie Migrate using PostgreSQL extension aus.
  2. Wählen Sie auf der Seite "Anwendung konvertieren" die Option "Oracle-Anwendung zum Konvertieren " aus, und wählen Sie den Ordner aus, der Oracle-Anwendungscode enthält.
  3. Wählen Sie eine PostgreSQL-Verbindung und Eine PostgreSQL-Datenbank für den Konvertierungskontext aus.
  4. Wählen Sie "Datenbanken laden " aus, wenn die Datenbankliste leer ist.
  5. Wählen Sie "Anwendung konvertieren" aus, um die Konvertierung zu starten.

Copilot-Tools für die Anwendungskonvertierung verwenden

Die Erweiterung registriert zwei Copilot Sprachmodelltools für Konvertierungsunterstützung:

  • Oracle Client Code Application Converter (pgsql_migration_oracle_app): Konvertiert Oracle-Clientanwendungscode in PostgreSQL-Entsprechungen mithilfe von Eingabeaufforderungsvorlagen und Codierungsanleitungen aus der Schemakonvertierung. Akzeptiert die folgenden Parameter:

    • Anwendungscodebasisordner (erforderlich): Speicherort des zu konvertierenden Codes.
    • Pfad zum Speicherort der Codierungshinweise (optional): Pfad zu den Codierungshinweisen aus der Schemakonvertierung.
    • Postgres DB Name (optional): Name der PostgreSQL-Datenbank für den Konvertierungskontext.
    • Postgres-DB-Verbindung (optional): Verbindungsname für die PostgreSQL-Datenbank.
  • Oracle to Postgres Migration Report anzeigen (pgsql_migration_show_report): Zeigt den Schemakonvertierungsbericht an. Erfordert den Parameter Pfad zur Berichtsdatei.

Weitere Informationen zur Verwendung von Copilot-Tools finden Sie unter Copilot Integration.

Vergleichen konvertierter Dateien

Verwenden Sie zum Anzeigen der aktuellen Schemakonvertierungsausgabe den Conversion Objekt-Explorer, um in Quell-zu-Ziel-Zuordnungen zu navigieren, einschließlich Objekten mit mehreren Zieldefinitionen.

Um konvertierte Anwendungsdateien (, .java, .load, .sh oder .ctl) zu vergleichen, klicken Sie im Explorer mit der rechten Maustaste auf die Datei, und wählen Sie .sql aus. Überprüfen Sie den ursprünglichen und konvertierten Code, und testen Sie die Anwendung mit dem korrigierten PostgreSQL-Schema.

Für Projekte mit dem Legacy-Layout „Paired-Folder“ erwartet Compare DDL Migration File Pairs übereinstimmende Pfade unter folder\oracle\SCHEMA_NAME\DDL-TYPE und folder\postgres\SCHEMA_NAME\DDL-TYPE. Dieses Layout ist nicht der Navigationspfad für den aktuellen postgres_ddl Paketpfad.

Konvertierungsprojekte verwalten

Verwenden Sie die Ansicht "Migrationen " in der Randleiste, um Ihre Projekte zu verwalten:

Action Beschreibung
Migration Project öffnen Öffnen Sie ein vorhandenes Konvertierungsprojekt im Dashboard.
Im Explorer anzeigen Anzeigen des Projektordners in der Explorer-Ansicht.
Löschen Entfernen Sie ein Conversion Project. Sie werden aufgefordert, vor dem Löschen zu bestätigen.
Aktualisieren Laden Sie die Liste der Konvertierungsprojekte im aktuellen Arbeitsbereich neu.