Tutorial: Schema-Konversion von Oracle zu Azure Database for PostgreSQL Flexible Server

Dieses Lernprogramm führt Sie durch das Konvertieren von Oracle-Datenbankschemas in Azure Database for PostgreSQL mithilfe der Visual Studio Code PostgreSQL-Erweiterung mit Microsoft Foundry zum Generieren und Überprüfen von PostgreSQL-Definitionen.

Es umfasst das Herstellen einer Verbindung mit Ihrer Oracle-Quelle und dem Azure Database for PostgreSQL-Ziel, das Konfigurieren von Microsoft Foundry, das Ausführen des Migrations-Assistenten und das Überprüfen der generierten PostgreSQL-Artefakte. Bevor Sie beginnen, stellen Sie sicher, dass Sie über Netzwerkzugriff und Anmeldeinformationen für beide Server und eine Microsoft Foundry-Bereitstellung verfügen.

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

• Schemaermittlung: Das Tool analysiert Ihre Oracle-Schemaobjekte.
• AI-Verarbeitung: Microsoft Foundry verarbeitet und konvertiert kompatible Objekte.
• Scratch-Database-Prüfungen: Das Tool versucht zu kompilieren und führt verfügbare statische Prüfungen aus. Funktions-, Daten- und Anwendungsüberprüfung bleiben getrennt.
• Objektüberprüfung: Verwenden Sie Conversion Objekt-Explorer, um Ergebnisse zu untersuchen und generierte PostgreSQL-Definitionen zu verfeinern.
• Ausgabegenerierung: Erfolgreich konvertierte Objekte werden als PostgreSQL-Dateien gespeichert.

Prerequisites

In diesem Abschnitt werden die Voraussetzungen für die Verwendung des Oracle to Azure Database for PostgreSQL-Schemakonvertierungsfeatures in Visual Studio Code beschrieben, bevor Sie eine Konvertierung starten.

Systemanforderungen

Betriebssystemunterstützung

Zielanforderungen für Azure Database for PostgreSQL

KI-Modellanforderungen

Sie benötigen eine der folgenden KI-Komponenten, die konfiguriert werden muss:

Konfiguration der Microsoft Foundry-Bereitstellung

Erstellen Sie in Microsoft Foundry eine Bereitstellung, die das modell gpt-5.2 verwendet. Der Bereitstellungsname ist der Name, den Sie beim Erstellen der Bereitstellung ausgewählt haben. es muss nicht mit dem Modellnamen übereinstimmen.

Der Endpunkt ist Ihre Microsoft Foundry-Ressourcen-URL. Microsoft Foundry-Ressourcen stellen mehrere gleichwertige Hostnamen bereit; jedes der folgenden Formate ist gültig:

• https://{your-resource}.services.ai.azure.com
• https://{your-resource}.openai.azure.com
• https://{your-resource}.cognitiveservices.azure.com

Ersetzen Sie {your-resource} durch den Namen der Microsoft Foundry-Ressource (z. B. oracletopg). Wenn Sie eine Rückschlussroute direkt aufrufen müssen, lautet /openai/responses?api-version=2025-04-01-previewder aktuelle Vorschaupfad .

Weitere Informationen zu Endpunktformaten und Rückschlussrouten finden Sie unter Endpoints für Microsoft Foundry Models.

Erforderliche Datenbankberechtigungen

Bevor Sie die Schemakonvertierung ausführen, überprüfen Sie den Zugriff auf Quellmetadaten und die Berechtigungen für die Scratch-Datenbank bei Ihren Datenbankadministratoren. Das Oracle-Konto benötigt Zugriff auf Schemametadaten und Wörterbuchansichten, nicht auf Anwendungszeilendaten. Das PostgreSQL-Konto muss in der Lage sein, entsprechende Schemas zu löschen und neu zu erstellen und Objekte zur Überprüfung zu erstellen. Verwenden Sie nach Möglichkeit ein dediziertes Konto, und befolgen Sie das Prinzip der geringsten Rechte.

Oracle-Quellberechtigungen

Für die Oracle-Quelldatenbank sind die folgenden Mindestberechtigungen erforderlich:

Scratch-Datenbankberechtigungen

Ordnen Sie die folgenden Zugriffe der ausgewählten temporären Datenbank zu. Auf Datenbankebene CREATE erteilt nicht die Berechtigung zum Löschen eines Schemas, das einer anderen Rolle gehört.

Netzwerkanforderungen

• Outbound connectivity: Microsoft Foundry-Endpunkte.
• Datenbankverbindung: Sowohl die Quelldatenbank Oracle als auch die Zieldatenbank Azure Database for PostgreSQL Flexible Server.
• HTTPS-Zugriff: Visual Studio Code Extensions Marketplace und GitHub Copilot Dienste.
• GitHub Repositoryzugriff: https://github.com/microsoft/pgsql-tools/.

Oracle Instant Client (für den Thick-Client-Modus)

Das Schemakonvertierungstool stellt standardmäßig eine Verbindung mit Oracle mithilfe des Thin Client-Modus bereit, was keine zusätzliche Software erfordert. Wenn Ihre Umgebung einen dicken Clientmodus erfordert, installieren Sie Oracle Instant Client auf dem Computer, auf dem Visual Studio Code ausgeführt wird. Das Tool liest Ihre sqlnet.ora- und tnsnames.ora-Konfiguration und wechselt automatisch in den Thick-Modus, wenn eine Einstellung dies erfordert.

Sie können ermitteln, ob der dicke Clientmodus erforderlich ist, indem Sie die Oracle-Netzwerkkonfigurationsdateien in Ihrer Quellumgebung überprüfen. Suchen Sie nach den folgenden Parametern in der sqlnet.ora Datei (normalerweise in $ORACLE_HOME/network/admin/ zu finden):

Microsoft Foundry-Authentifizierung

Konfigurieren Sie eine der folgenden Authentifizierungsmethoden für Microsoft Foundry:

Migrationsprozess

Dieser Abschnitt erläutert den Konvertierungsablauf. Sie installieren die Erweiterung, initialisieren ein Projekt, stellen eine Verbindung mit Oracle her, überprüfen Discovery und konfigurieren die Scratch-Datenbank und Microsoft Foundry. Die Konvertierung versucht die Kompilierung und verfügbare statische Prüfungen in der temporären Datenbank. Anschließend überprüfen und verfeinern Sie die Ausgabe, stellen sie in einer separaten Nichtproduktionsdatenbank bereit und überprüfen sie unabhängig vor der Produktionsverwendung.

Schritt 1: Installieren der PostgreSQL Visual Studio Code-Erweiterung

1. Öffnen Sie Visual Studio Code.

2. Wechseln Sie zur Ansicht "Erweiterungen" (Ctrl+Shift+X).

3. Suchen Sie nach PostgreSQL und installieren Sie die PostgreSQLErweiterung, die von Microsoft veröffentlicht wurde.

   1. Marketplace-Download

   

Schritt 2: Erstellen Sie eine Verbindung mit Azure Database for PostgreSQL

1. Erstellen Sie im Erweiterungsbereich von PostgreSQL eine Verbindung zu Ihrer Azure Database for PostgreSQL Flexible Server-Instanz.

2. Geben Sie die Verbindungsdetails ein (Host, Datenbank, Benutzername, Kennwort).

3. Testen und speichern Sie die Verbindung.

   

Schritt 3: Öffnen eines neuen Arbeitsbereichs

1. Erstellen Sie einen neuen Ordner auf Ihrem lokalen Computer für das Migrationsprojekt.

2. Öffnen Sie den Ordner als neuen Arbeitsbereich in Visual Studio Code.

   

Schritt 4: Initialisieren eines Migrationsprojekts

1. Öffnen Sie die PostgreSQL-Erweiterung.

2. Wechseln Sie zum Bereich Migrationen.

3. Wählen Sie Migrationsprojekt erstellen aus.

   

Schritt 5: Konfigurieren von Projekteinstellungen

1. Geben Sie im Migrations-Assistenten Ihren Projektnamen ein.

2. Klicken Sie auf Weiter, um fortzufahren.

   

Schritt 6: Konfigurieren der Oracle-Verbindung

1. Geben Sie Ihre Oracle-Verbindungsdetails ein:

   • Host- oder Servername.
   • Portnummer
   • Datenbank- oder Dienstname.
   • Benutzername und Kennwort.

   Das Tool wählt den Thin- bzw. Thick-Client-Modus automatisch anhand Ihrer sqlnet.ora- und tnsnames.ora-Einstellungen aus; die Benutzeroberfläche bietet keinen manuellen Auswahlschalter. Der dünne Modus wird standardmäßig verwendet. Wenn Ihr sqlnet.ora den Thick-Modus erfordert, stellen Sie sicher, dass Oracle Instant Client installiert ist und dass sein Speicherort in der Umgebungsvariablen PATH enthalten ist, bevor Sie fortfahren. Weitere Informationen finden Sie unter Oracle Instant Client.

2. Wählen Sie Lastschemas aus. Das Tool testet die Oracle-Verbindung und listet bei erfolgreicher Ausführung alle benutzerdefinierten Schemas auf, die in Oracle verfügbar sind.

3. Wählen Sie ein oder mehrere Schemas aus, die in PostgreSQL konvertiert werden sollen.

4. Wählen Sie Weiter: Ermittlung aus.

   

Schritt 7: Discovery-Ergebnisse überprüfen

Die Erkennung zeigt das Quellinventar und den geplanten Extraktionsumfang. In dieser Phase wird keine DDL extrahiert. Eine Erläuterung der Anzahlen in der Zusammenfassung und des Umfangs finden Sie in der Schemakonvertierungsübersicht unter „Discovery“.

1. Warten Sie, bis die Erkennung abgeschlossen ist.

2. Überprüfen Sie unter Quellberechtigungen jede Prüfung, ihren Zweck und ihr Ergebnis. Überprüfen Sie die nicht erfolgreichen Überprüfungen mit Ihrem Oracle-Datenbankadministrator. Nachdem Sie die Berechtigungsprobleme behoben haben, wählen Sie Ermittlung aktualisieren aus und überprüfen Sie die aktualisierten Ergebnisse. Die erforderlichen Berechtigungen finden Sie unter Source Oracle privileges.

3. Überprüfen Sie die Zusammenfassungszahlen für Erkannte, Zu extrahierende, Ausgeschlossene und Ungültige Objekte.

4. Erweitern Sie unterstützte Objekttypen , um die Anzahl der zu extrahierenden, ausgeschlossenen und ungültigen Objekte nach Typ zu überprüfen. Ein unterstützter Typ kann weiterhin ausgeschlossene Objekte aufweisen; diese Zählwerte sind keine Konvertierungsergebnisse.

5. Klappen Sie Nicht unterstützte Objekttypen auf, um nicht unterstützte Kategorien zu prüfen, die in der Quelle gefunden wurden. Details zum Support und PostgreSQL-Alternativen finden Sie unter Einschränkungen bei der Schemakonvertierung.

6. Überprüfen Sie unter Abhängige Schemas referenzierte Schemas, die Sie nicht ausgewählt haben. Wählen Sie Diagramm anzeigen aus, um die Referenzen anzuzeigen. Die Zahlen an den Verbindungen stellen Abhängigkeitsreferenzen dar, nicht die Anzahl der zu extrahierenden oder zu konvertierenden Objekte.

7. Lesen Sie den separaten Hinweis zu referenzierten Oracle-Systemschemas, die nicht migriert werden. Behandeln Sie diese Verweise nicht als zusätzlich zur Konvertierung ausgewählte Anwendungsschemas.

8. Wenn Sie die Schemaauswahl ändern müssen, wählen Sie "Zurück " aus, um zu "Mit Oracle verbinden" zurückzukehren, Schemas zu aktualisieren und "Weiter: Discovery " erneut auszuwählen. Überprüfen Sie den aktualisierten Umfang, bevor Sie fortfahren.

9. Wählen Sie Ich habe die Objekte, Ausschlüsse und abhängigen Schemas überprüft.

10. Wählen Sie Weiter: PostgreSQL-Verbindung aus.

    

Schritt 8: Konfigurieren einer Azure Database for PostgreSQL-Testdatenbank

Verwenden Sie eine leere oder dedizierte, nicht verwendete Scratch-Datenbank ohne Objekte oder Daten, die Sie beibehalten müssen. Anleitungen zur Vorbereitung finden Sie unter Vorbereiten der Arbeitsdatenbank.

1. Wählen Sie die verbindung Azure Database for PostgreSQL aus, die Sie in der PostgreSQL-Erweiterung definiert haben.

2. Wählen Sie die Zieldatenbank aus der Dropdownliste aus.

3. Wählen Sie Erweiterungen überprüfen aus. Wenn die Warnung "Empfohlene Erweiterungen sind nicht installiert" angezeigt wird, überprüfen Sie die fehlenden Erweiterungen. Befolgen Sie die Anweisungen zur Vorbereitung der Scratch-Datenbank, um die erforderlichen Erweiterungen zur Allowlist des Servers hinzuzufügen und in der ausgewählten Datenbank zu installieren, und wählen Sie dann erneut Erweiterungen überprüfen aus. Sie können trotz der Warnung fortfahren, aber Objekte, die von fehlenden Erweiterungen abhängen, müssen möglicherweise manuell angepasst werden.

   

4. Aktivieren Sie das Kontrollkästchen, in dem bestätigt wird, dass Scratch-Schemas, die den ausgewählten Oracle-Schemas entsprechen, gelöscht und während der Konvertierung neu erstellt werden, wobei ihre vorhandenen Objekte und Daten gelöscht werden.

5. Wählen Sie Weiter: Microsoft Foundry-Modellkonfiguration aus.

Schritt 9: Konfigurieren Sie das Microsoft Foundry-Sprachmodell

Weisen Sie in Microsoft Foundry ein Kontingent für eine Bereitstellung von mehr als 1.000.000 Token pro Minute (TPM) zu. Das folgende Bereitstellungsbeispiel ist für 2,3 Millionen TPM konfiguriert; das angezeigte verfügbare Kontingent ist spezifisch für diese Umgebung.

Kehren Sie zum Migrations-Assistenten in Visual Studio Code zurück, um die Modellverbindung zu konfigurieren:

1. Geben Sie Ihre Microsoft Foundry-Details ein:
   • Endpunkt-URL.
   • Bereitstellungsname (der Name, den Sie der Bereitstellung in Microsoft Foundry zugewiesen haben; das zugrunde liegende Modell muss gpt-5.2 sein).
2. Wählen Sie die Authentifizierungsmethode aus:
   • API-Schlüssel: Geben Sie den API-Schlüssel für Ihre Microsoft Foundry-Bereitstellung ein.
   • Microsoft Entra-ID: Melden Sie sich mit der Azure-Kontoerweiterung an. Das Tool erwirbt das Authentifizierungstoken automatisch. Stellen Sie sicher, dass die angemeldete Identität über die Rolle Foundry User (früher Azure AI User) für die Microsoft Foundry-Ressource verfügt. Weitere Informationen finden Sie unter Rollenbasierte Zugriffssteuerung für Microsoft Foundry.
3. Wählen Sie Microsoft Foundry-Verbindung testen aus, um die Konfiguration zu überprüfen.
4. Nachdem die Verbindung erfolgreich war, wählen Sie Migration Project aus.

Schritt 10: Führen Sie die Schemakonvertierung aus

1. Das System navigiert zum Hauptmigrations-Assistenten.

2. Wählen Sie "Migrieren" aus, um den Schemakonvertierungsprozess zu starten.

3. Überwachen Des Konvertierungsfortschritts in der Visual Studio Code Schnittstelle.

4. Wenn die Konvertierung abgeschlossen ist, zeigt das Projekt Schemakonvertierung abgeschlossen und die Aktion Konvertierungszusammenfassung überprüfen an.

   

Schritt 11: Überprüfen des Schemakonvertierungsberichts

1. Nach Abschluss der Schemakonvertierung wird der HTML-Konvertierungsbericht automatisch geöffnet.
2. Überprüfen Sie die Erkennungs-, Extraktions- und Konvertierungsergebnisse sowie die Anmerkungen auf Objektebene.
3. Anleitungen zur Interpretation des Berichts finden Sie unter Anzeigen des HTML-Berichts für die Oracle-Schemakonvertierung.

Schritt 12: Überprüfen und Verfeinern konvertierter Objekte

1. Wählen Sie im abgeschlossenen Migrationsprojekt Zusammenfassung der Konvertierung überprüfen aus.

   

2. Wählen Sie auf der Zusammenfassungsseite Konvertierung den Konvertierungsobjekt-Explorer aus.

   

3. Wählen Sie ein Objekt aus, um seine Oracle- und PostgreSQL-Definitionen zu vergleichen und seine Konvertierungsnotizen zu lesen.

   

4. Verwenden Sie Ask, um die Konvertierung und ihre Abhängigkeiten zu erläutern, oder Fix, um eine Copilot-Eingabeaufforderung zu öffnen und Änderungen an der PostgreSQL-Datei vorzunehmen.

5. Überprüfen Sie die Bearbeitungen, und vergewissern Sie sich, dass die Deployment-SQL die Korrekturen enthält, die Sie implementieren möchten. Gehen Sie nicht davon aus, dass das Bearbeiten einer Datei pro Objekt die generierte deploy.sqlDatei aktualisiert.

Informationen zum Filtern, Vergleichen und manuellen Kompilierungsschritt finden Sie unter Überprüfen konvertierter Objekte im Conversion Objekt-Explorer.

Schritt 13: Vorbereiten der Bereitstellung mit der Setup Experience

Der Konvertierungsworkflow generiert automatisch Setupdateien nach Abschluss. Beim Öffnen der Setupanweisungen wird keine Bereitstellung gestartet.

1. Wählen Sie aus dem abgeschlossenen Migrationsprojekt Konvertierungsübersicht überprüfen aus.
2. Wählen Sie auf der Seite „Zusammenfassung der Konvertierung“Einrichtungsanweisung aus. Diese Aktion ist verfügbar, wenn die Setupdateien bereit sind.
3. Überprüfen Sie die generierte setup_instructions.md Datei, die im Editor geöffnet wird. Visual Studio Code zeigt auch den Setupordner im Explorer an.
4. Folgen Sie Konvertierte Schemas mit der Setup-Erfahrung bereitstellen, um eine separate Nicht-Produktiv-Zieldatenbank vorzubereiten, Bereitschaftsprüfungen auszuführen, die konvertierten Schemas bereitzustellen und die Bereitstellungsergebnisse zu überprüfen.

Schritt 14: Überprüfen Sie das bereitgestellte Schema vor dem Produktiveinsatz

Verwenden Sie die im vorherigen Schritt bereitgestellte Nichtproduktionsdatenbank für die Funktions-, Daten- und Anwendungsüberprüfung, nicht die Konvertierungs-/Scratch-Datenbank.

Wenn Sie ein Objekt nach der Bereitstellung ändern, wenden Sie die Korrektur manuell an:

1. Verbinden Sie den SQL-Editor mit dem Nichtproduktion PostgreSQL-Server und der Datenbank, in der das konvertierte Schema bereitgestellt wird. Bestätigen Sie die aktive Datenbank des Editors.
2. Überprüfen Sie Schemaverweise, und wählen Sie die vollständige Anweisung oder Anweisungen aus, die Sie ausführen möchten.
3. Wählen Sie die Schaltfläche „Ausführen“ aus, um nur die ausgewählten Anweisungen auszuführen. Überprüfen Sie die Ausführungsausgabe, und beheben Sie Fehler, bevor Sie fortfahren.
4. Vergewissern Sie sich, dass die Objektdateien und die Bereitstellungs-SQL die getesteten Korrekturen vor der Produktionsbereitstellung enthalten. Das Aktualisieren einer Datei, das Aktualisieren eines bereitgestellten Objekts und die Aktualisierung deploy.sql sind separate Aktionen.

Überprüfen Sie das bereitgestellte Schema unabhängig mit repräsentativen Testdaten und Anwendungsworkloads. Überprüfen Sie Abhängigkeiten, Einschränkungen, Geschäftslogik und Resultsets anhand der Oracle-Quelle, und testen Sie nach Korrekturen erneut. Überprüfen Sie alle Objekte, die nicht konvertiert oder bereitgestellt wurden, anstatt nur erfolgreiche Konvertierungen zu testen.

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

Verwandte Inhalte

• Was ist die Schemakonvertierung von Oracle zu Azure Database for PostgreSQL – Flexible Server?
• Konvertierte Objekte im Konvertierungs-Objekt-Explorer überprüfen
• Bereitstellen konvertierter Schemas mit der Setup Experience
• Einschränkungen bei der Schemakonvertierung von Oracle zu Azure Database for PostgreSQL – Flexible Server