Oracle zu PostgreSQL-Migration

Die PostgreSQL-Erweiterung für Visual Studio Code bietet einen End-to-End-Workflow für die Migration von Oracle-Datenbanken zu PostgreSQL. Ein geführter Assistent führt Sie durch die Verbindung mit Ihrer Oracle-Quelle, auswählen von Schemas, Konfigurieren eines Microsoft Foundry-Modells für die AI-unterstützte DDL-Konvertierung und Auswählen einer PostgreSQL-Scratch-Datenbank zur Überprüfung. Nachdem das Projekt erstellt wurde, verfolgt ein Dashboard Extraktion, Konvertierung, Export und Überprüfung in einer einzigen Ansicht.

Important

Der Migrationsworkflow von Oracle zu PostgreSQL ist nur in Visual Studio Code verfügbar.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie folgendes haben:

  • Visual Studio Code installiert.
  • Die PostgreSQL-Erweiterung installiert.
  • Zugriff auf eine Oracle-Quelldatenbank mit Leseberechtigungen für die Schemaextraktion.
  • Eine PostgreSQL-Instanz, die als Scratch Validation-Datenbank verwendet werden soll (z. B. ein Azure Database for PostgreSQL flexibler Server).
  • Eine Microsoft Foundry-Ressource mit einem bereitgestellten gpt-5.2 Modell. Sie benötigen die Endpunkt-URL und entweder einen API-Schlüssel oder ein Microsoft Entra ID Konto mit Zugriff.

Überprüfen, ob das Migrationsfeature aktiviert ist

Die pgsql.enableMigrations Einstellung steuert die Migrationsansicht (Vorschau) und alle Migrationsbefehle. Diese Einstellung ist standardmäßig aktiviert.

Wenn die Migrationsansicht (Vorschau) nicht in der Randleiste angezeigt wird, überprüfen Sie die Einstellung:

  1. Öffnen Sie VS-Codeeinstellungen (STRG+, unter Windows/Linux, Cmd+, unter macOS).
  2. Suchen Sie nach pgsql.enableMigrations.
  3. Bestätigen Sie, dass der Wert ist true.

Erstellen eines Migrationsprojekts

Ein Migrationsprojekt ist ein vierstufiger Assistent, der Ihre Quell-, Ziel- und KI-Konfiguration abfragt, bevor der Projektarbeitsbereich erstellt wird.

Schritt 1: Project Setup

  1. Öffnen Sie die Migrationsansicht (Vorschau) in der Randleiste.

  2. Wählen Sie die Schaltfläche + in der Symbolleiste der Ansicht aus, oder klicken Sie im Explorer mit der rechten Maustaste auf einen Arbeitsbereichsordner und wählen Sie Migrationsprojekt erstellen aus.

    Die Seite „Neues Oracle-zu-Azure Database for PostgreSQL-Migrationsprojekt“ wird geöffnet, auf der aufgeführt ist, was Sie benötigen:

    • Verbindungsdetails für die Quelldatenbank
    • Name der zu konvertierenden Schemas
    • Endpunkt-URL und Schlüssel für eine Microsoft Foundry-Ressource
    • Verbindungsname für eine vorhandene PostgreSQL-Instanz

  3. Geben Sie einen Namen in das Feld "Project Name" ein.

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

Screenshot der Seite für ein neues Migrationsprojekt mit dem Feld „Projektname“.

Schritt 2: Herstellen einer Verbindung mit Oracle

Die Seite „Mit Oracle verbinden“ erfasst Ihre Anmeldeinformationen für die Oracle-Quelldatenbank und ermöglicht Ihnen, Schemas zu laden.

  1. Füllen Sie die Oracle-Verbindungsfelder aus:

    Feld Beschreibung
    Oracle Hostname Hostname oder IP-Adresse des Oracle-Datenbankservers.
    Oracle Port Listener-Port (Standardwert: 1521).
    Oracle SID oder Dienstname Oracle SID- oder Dienstname für die Datenbankinstanz.
    Oracle-Benutzername Datenbankbenutzer mit Lesezugriff auf Schemaobjekte.
    Oracle-Kennwort Kennwort für den Oracle-Benutzer.

  2. Wählen Sie "Schemas laden " aus, um eine Verbindung herzustellen und die Liste der verfügbaren Schemas abzurufen.

  3. Wählen Sie in der Dropdownliste " Schemas " ein oder mehrere Schemas aus, die migriert werden sollen.

  4. Select Next: PostgreSQL Connection.

Schritt 3: Auswählen einer Azure Database for PostgreSQL Scratch-Datenbank

Auf der Seite „Azure Database for PostgreSQL: temporäre Datenbank auswählen“ wählen Sie die PostgreSQL-Instanz aus, die das KI-Modell zur Überprüfung der konvertierten DDL-Dateien verwendet.

Note

Verwenden Sie für die Validierung eine eigene Testdatenbank. Die Erweiterung kann während des Konvertierungsprozesses konvertierte DDL für diese Datenbank ausführen.

  1. Wählen Sie in der Dropdownliste "PostgreSQL Connection " ein vorhandenes Verbindungsprofil aus. Wenn die benötigte Verbindung nicht aufgeführt ist, wählen Sie "Profile aktualisieren " aus, um verfügbare Profile neu zu laden, oder erstellen Sie zuerst in der Verbindungs- und Identitätsansicht eine neue Verbindung.
  2. Wählen Sie in der Dropdownliste der PostgreSQL-Datenbank die Zieldatenbank aus. Wählen Sie "Datenbanken laden " aus, wenn die Liste leer ist.
  3. Nachdem Sie eine Datenbank ausgewählt haben, überprüft die Erweiterung automatisch, ob die empfohlenen PostgreSQL-Erweiterungen installiert sind. Sie können auch " Erweiterungen überprüfen " auswählen, um die Überprüfung manuell auszuführen. Wenn Erweiterungen fehlen, werden sie auf der Seite aufgeführt, und es werden Hinweise zur Aufnahme in die Zulassungsliste und zur Installation über die Dokumentation zu Azure Database for PostgreSQL – Flexibler Server bereitgestellt.
  4. Wählen Sie Weiter: Microsoft Foundry-Modellkonfiguration aus.

Schritt 4: Konfigurieren des Microsoft Foundry-Modells

Auf der Seite "Microsoft Foundry Model auswählen" wird die Microsoft Foundry-Bereitstellung konfiguriert, die die Schema- und Codekonvertierung unterstützt.

  1. Füllen Sie die Sprachmodellfelder aus:

    Feld Beschreibung
    Modellname gpt-5.2.
    Microsoft Foundry-Endpunkt URL des Microsoft Foundry-Ressourcenendpunkts (z. B. https://<resource>.openai.azure.com/).
    Authentifizierungsmethode Wählen Sie API-Schlüssel oder Microsoft Entra ID aus.
    Microsoft Findry-API-Schlüssel API-Schlüssel für die Microsoft Foundry-Ressource (wird angezeigt, wenn die AuthentifizierungsmethodeAPI-Schlüssel ist).
    Azure-Konto Microsoft-Konto mit Zugriff auf die Ressource (wird angezeigt, wenn die AuthentifizierungsmethodeMicrosoft Entra ID ist).
    Mandant Azure AD-Mandant für das Konto (wird angezeigt, wenn die AuthentifizierungsmethodeMicrosoft Entra ID ist).
    Bereitstellungsname Name des bereitgestellten Modells in Ihrer Microsoft Foundry-Ressource.

  2. Wählen Sie "Test Microsoft Foundry Connection" aus, um die Verbindung zu überprüfen.

  3. Wählen Sie Migrationsprojekt erstellen aus.

Tip

Microsoft Foundry empfiehlt 500.000 TPM (Token pro Minute) für eine optimale Migrationsleistung.

Ausführen der Schemamigration

Nachdem das Projekt erstellt wurde, wird das Oracle-Migrationsdashboard geöffnet. Das Dashboard zeigt Schemamigrations- und Schemaüberprüfungskarten zusammen mit einem Einstellungs-Accordion an, das Ihre Projektkonfiguration zusammenfasst.

Extrahieren und Konvertieren von Schemas

Die Schemamigrationskarte (Schritt 1) führt Extraktion, Konvertierung und Export als fortlaufende Pipeline aus.

  1. Wählen Sie auf der Schemamigrationskarte"Migrieren" aus.

    Die Schaltflächenbezeichnung wird aktualisiert, wenn die Pipeline voranschreitet:

    Status Schaltflächenbezeichnung
    Extraktion läuft Wird extrahiert ...
    Extraktion abgeschlossen, Konvertierung ausstehend Migration fortsetzen
    Konvertierung wird ausgeführt Konvertieren...
    Alle Phasen abgeschlossen Migration abgeschlossen

  2. Überwachen des Fortschritts auf der erweiterten Karte:

    • Die Extraktion zeigt die Anzahl der extrahierten Objekte (z. B. "15 von 42 extrahierten Objekten") und das aktuelle Schema und das aktuelle Objekt, das verarbeitet wird.
    • Die Konvertierung zeigt die Anzahl der konvertierten Blöcke (z. B. "3 von 8 Blöcken konvertiert") und den aktuellen Block, der verarbeitet wird.

  3. Wählen Sie nach Abschluss des Exports die Option "Migrationsbericht anzeigen " aus, um den generierten Migrationsbericht zu öffnen.

Überprüfen von Migrationsaufgaben

Die Schemaüberprüfungskarte (Schritt 2) zeigt Elemente an, die nach der Konvertierung manuelle Aufmerksamkeit erfordern. Mit der Option " Gruppierte / Aufgaben " oben im Überarbeitungsbereich können Sie auswählen, wie die Liste durchgearbeitet werden soll.

Gruppierte Ansicht

Die Ansicht Gruppiert gliedert Überprüfungsaufgaben nach Kategorie in ein- und ausklappbare Akkordeon-Gruppen. Verwenden Sie diese Ansicht, wenn Sie verwandte Probleme zusammen verarbeiten möchten.

  1. Wählen Sie auf der Karte " Schemaüberprüfung " die Option "Überprüfen" aus, um die Prüfoberfläche zu erweitern, und wählen Sie dann "Gruppiert" aus.

  2. Verwenden Sie die Registerkarten "Ausstehend" und " Gelöst ", um zwischen Vorgängen zu wechseln, die noch Aufmerksamkeit und Aufgaben benötigen, die Sie bereits genehmigt haben.

  3. Erweitern Sie eine Gruppe, um ihre Metadaten (Schemas, Objekttypen, Kritischität) und die einzelnen Aufgabenkarten darin anzuzeigen.

  4. Verwenden Sie die Aktionen auf Gruppenebene, um Aufgaben in Massen zu verarbeiten:

    Action Beschreibung
    Alle ausführen Öffnen Sie alle ausstehenden Aufgaben in der Gruppe im Copilot Agentmodus für die KI-unterstützte Überprüfung.
    Alle lösen Markieren Sie alle Aufgaben in der Gruppe als aufgelöst. Ein Bestätigungsdialogfeld zeigt den Gruppennamen und die Vorgangsanzahl an, bevor Sie fortfahren.
    Alle zurücksetzen Alle gelösten Aufgaben in der Gruppe in den Status „Ausstehend“ zurücksetzen. Verfügbar auf der Registerkarte "Aufgelöst ".
    In Vorgängen anzeigen Wechseln Sie zur flachen Aufgaben-Ansicht, gefiltert nach dieser Gruppe.

  5. Um auf eine einzelne Aufgabe innerhalb der Gruppe zu reagieren, wählen Sie "Aufgabe ausführen" aus, um sie im Copilot Agentmodus zu öffnen, oder wählen Sie "Auflösen" aus, um sie als erledigt zu markieren. Wählen Sie " Zurücksetzen " für eine aufgelöste Aufgabe aus, um sie in den ausstehenden Zustand zurückzugeben.

Note

Alle auflösen und Alles zurücksetzen sind deaktiviert, wenn eine Gruppe mehr als 800 Aufgaben enthält.

Aufgabenansicht

In der Aufgabenansicht werden alle Überprüfungsaufgaben in einer flachen Tabelle angezeigt. Verwenden Sie diese Ansicht, wenn Sie unabhängig von der Gruppe alle Aufgaben sortieren, filtern oder durchsuchen möchten.

  1. Wählen Sie "Vorgänge " im Switcher aus.
  2. Verwenden Sie die Filterdropdowns (Status, Kritischität, Objekttyp, Schema), um die Aufgabenliste einzugrenzen.
  3. Wählen Sie "Aufgabe ausführen" für ein ausstehendes Element aus, um es im Copilot Agent-Modus für KI-unterstützte Überprüfung und Korrektur zu öffnen.
  4. Nachdem Sie ein Element behoben haben, wählen Sie "Auflösen" aus, um es als erledigt zu markieren.

Tip

Wählen Sie " Protokolle anzeigen " im Dashboard aus, um Extraktions- und Konvertierungsprotokolldateien zur Problembehandlung zu prüfen.

Migrieren von Anwendungscode

Konvertieren Sie nach der Schemamigration Oracle-spezifischen Anwendungscode (SQL-Skripts, gespeicherte Prozeduren, Ladesteuerungsdateien, Shellskripts oder Java Dateien) in PostgreSQL-kompatible Entsprechungen. Die Anwendungsmigration ist eine Vorschaufunktion.

Auswählen einer Migrationsmethode

Die Erweiterung bietet zwei Pfade für die Migration von Anwendungscode:

  • Vollständige App-Modernisierung – Wenn die GitHub-App Copilot Modernisierungserweiterung installiert ist, wählen Sie "Migrieren mithilfe der App-Modernisierung" aus, um die Migration mit Codierungsnotizen aus der Schemakonvertierung fortzusetzen. 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 "Migrieren" mit der PostgreSQL-Erweiterung aus.

Konvertieren von Anwendungscode innerhalb der Erweiterung

  1. Wählen Sie auf der Anwendungsmigrationskarte"Daten migrieren" (oder "Methode auswählen ", wenn die App-Modernisierungserweiterung erkannt wird).
  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.

Verwenden von Copilot Tools für die Anwendungsmigration

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

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

    • Anwendungscodebasisordner (erforderlich) – Speicherort des zu konvertierenden Codes.
    • Pfad zum Speicherort der Codierungshinweise (optional) – Pfad zu den Codierungshinweisen aus der Schema-Migration.
    • Postgres DB Name (optional) – Name der PostgreSQL-Datenbank für Den Konvertierungskontext.
    • Postgres DB Connection (optional) – Verbindungsname für die PostgreSQL-Datenbank.

  • Oracle to Postgres Migration Report (pgsql_migration_show_report) anzeigen – Zeigt den Migrationsbericht an, der von der Schemakonvertierung generiert wurde. Erfordert den Parameter Pfad zur Berichtsdatei.

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

Vergleichen konvertierter Dateien

Überprüfen Sie nach der Konvertierung änderungen nebeneinander mithilfe der integrierten Diff-Befehle.

  1. Klicken Sie im Explorer mit der rechten Maustaste auf eine konvertierte SQL-Datei unter dem oracle Migrationsprojekt oder postgres ordner, und wählen Sie "DDL-Migrationsdateipaare vergleichen" aus.
  2. Klicken Sie bei konvertierten Anwendungscodedateien (.sql, .ctl, .sh, .loadoder .java), mit der rechten Maustaste auf die Datei, und wählen Sie " Anwendungsmigrationsdateipaare vergleichen" aus.

Die parallele Diff-Ansicht zeigt die ursprüngliche Oracle-Quelle zusammen mit der konvertierten PostgreSQL-Ausgabe an, sodass Sie alle Artefakte identifizieren können, die eine manuelle Anpassung erfordern.

Note

DDL-Dateien müssen der Struktur folder/oracle|postgres/SCHEMA_NAME/DDL-TYPE/filename.sql für den Vergleichsbefehl folgen, um das übereinstimmende Dateipaar zu finden.

Verwalten von Migrationsprojekten

Verwenden Sie die Migrationsansicht (Vorschau) in der Randleiste, um Ihre Projekte zu verwalten:

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

Verwandte Inhalte

  • Last updated on