Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Verwenden Sie die Modernize CLI, um Oracle-abhängigen Anwendungscode zu bewerten und einen Plan zu erstellen, um ihn in PostgreSQL zu konvertieren. Der Workflow unterstützt Java- und .NET-Anwendungen, wobei Anwendungsquelle und optionale exportierte Datenbankdefinitionen anstelle einer Verbindung mit einer Livezieldatenbank verwendet werden.
Important
Oracle-zu-PostgreSQL-Anwendungsmigration in der Modernize CLI befindet sich in der öffentlichen Vorschau. Dieser Workflow ändert Anwendungscode; es migriert keine Datenbankserver oder Kundendaten, stellt keine Cloudinfrastruktur bereit oder stellt die Produktionsreife sicher. Verwenden Sie die lokale Ausführung für den Workflow in diesem Artikel.
Unterstützte Szenarios
Die Bewertung identifiziert aktive Oracle-Abhängigkeiten in Anwendungsprovidern, Konfigurationen, SQL-, ORM-Zuordnungen, Sequenzen und Routineaufrufen. Sprachspezifische Konvertierungskompetenzen:
| Application | Beispiele für den Konvertierungsbereich |
|---|---|
| Java | Oracle JDBC, JPA/Hibernate Mappings, SQL, Sequences, Schnittstellenverträge, Tests und Treiberverpackungen. |
| .NET | Oracle.DataAccess und Oracle.ManagedDataAccess, ADO.NET, Dapper, EF/EF Core-Zuordnungen, SQL, Verträge für Routinen, Npgsql, Tests und Veröffentlichungsausgaben. |
Der Workflow gilt nicht für Nur-PostgreSQL-Anwendungen, Nicht-Oracle-Quellmigrationen oder Datenbankserverbewertungen. Der Workflow zielt auf Oracle-Abhängigkeiten ab, die von Anwendungscode oder Konfiguration verwendet werden. Oracle-Verweise, die nur in der Dokumentation oder in einer nicht verwendeten Oracle-Bibliothek gefunden werden, reichen nicht aus, um ein Migrationsziel zu identifizieren.
Dieser quellbasierte Workflow unterstützt Java- und .NET-Anwendungen und kann optionale PostgreSQL-DDL-Exporte verwenden, um die Konvertierung zu unterstützen. Es ist keine Livedatenbankverbindung oder Anwendungsausfallzeiten erforderlich, und es werden weder automatisch verwaltete Azure-Identitäten hinzugefügt noch die Authentifizierungsrichtlinie Ihrer Anwendung geändert. Die separate Oracle-zu-PostgreSQL-Java Migrationserfahrung bietet eine Java Migrationsaufgabe, die Datenbankclients für die verwaltete Identitätsauthentifizierung aktualisiert und SQL konvertiert, optional mithilfe von Codierungsnotizen, die während der Datenbankschemakonvertierung generiert werden.
Prerequisites
- Die Modernisieren sie CLI und ihre GitHub Authentifizierungsvoraussetzungen.
- Ein lokales Auschecken einer Oracle-abhängigen Java oder .NET Anwendung.
-
Node.js 22 oder höher als
nodeauf IhremPATHverfügbar. Diese Anforderung richtet sich an die Migrationshilfsprogramme; die gebündelte Laufzeit der Modernize CLI ersetzt sie nicht. Es sind keine npm-Laufzeitpakete erforderlich. - Für die Konvertierung werden JDK und Buildtools der Anwendung oder deren .NET SDK und Buildtools verwendet.
- Für die Überprüfung der PostgreSQL-Laufzeit eine laufende Docker-Engine, die temporäre lokale PostgreSQL-Container ausführen kann.
- Ein eingecheckter Anwendungsbasisstand auf einem zugehörigen Git-Branch vor der Quellkonvertierung.
Die Bewertung erstellt oder testt die Anwendung nicht, führt Docker aus, stellt eine Verbindung mit einer Datenbank her oder ändert die Anwendungsquelle. Abhängigkeiten vor dem Ausführen vorbereiten; die Bewertung installiert keine Tools oder authentifiziert sich nicht interaktiv.
Bereitstellen optionaler Datenbankdefinitionen
Sie können allein anhand des Anwendungscodes bewerten und konvertieren. Um Zielschemaverträge bereitzustellen, fügen Sie diese optionale Datei im Anwendungs-Repository unter .github\modernize\oracle-postgres.json hinzu:
{
"postgres-ddl-folder": "database\\postgres",
"options": ["tests"]
}
Führen Sie diese Einstellungen mit einer vorhandenen Konfiguration zusammen, anstatt sie zu ersetzen.
| Setting | Purpose |
|---|---|
postgres-ddl-folder |
Schreibgeschützte PostgreSQL DDL-Exporte als Objektdateien oder Nur-Schema-Dumps. |
oracle-ddl-folder |
Optional, getrennte ursprüngliche Oracle-Definitionen, um das Quellverhalten beizubehalten. |
oracle-schema |
Exakter Oracle-Schemaauswahl, wenn ein Oracle DDL-Ordner bereitgestellt wird. |
options |
Konvertierungsaktionen, die explizit aktiviert werden, wie in der folgenden Tabelle beschrieben. |
| Option | Purpose |
|---|---|
tests |
Ermöglicht die grundlegende Unterstützung, die Testgenerierung und die Reparatur von Fehlerhaften Tests. |
Konvertierungsaktionen müssen explizit aktiviert sein. Nicht angegebene Aktionen bleiben deaktiviert.
Alle Einstellungen und die Konfigurationsdatei selbst sind optional. Relative Pfade werden aus dem Anwendungsstamm aufgelöst. Lassen Sie eine DDL-Einstellung für den code-only-Vorgang aus; ein explizit angegebener fehlender, leerer oder ungültiger Ordner ist ein Fehler, kein Fallback auf die Code-only-Bewertung.
Verwenden Sie dedizierte UTF-8-Exportordner nur für Schemas. Schließen Sie keine Kundendaten, Dateisystemverknüpfungen oder ausführbare SQL-Client-Includes ein. Unterstützte PostgreSQL-Dateierweiterungen sind .sql, .ddl, .psql, .pgsql, .fnc, .prc, .vw und .trg. Text- und Markdown-Notizen werden ignoriert. Die Objektidentität stammt aus DDL-Deklarationen, nicht aus Dateinamen.
DDL-Momentaufnahmen beschreiben exportierte Definitionen, nicht die aktuellen Inhalte oder Berechtigungen einer Live-Datenbank. Ein in einem Export fehlendes Objekt beweist nicht, dass es in der Live-Datenbank fehlt. Überprüfen Sie mehrdeutige Routineüberladungen und nicht unterstützte Konstrukte explizit.
Fügen Sie dieser Konfiguration keine Anmeldeinformationen oder Liveverbindungsprofile hinzu. Schreibvorgänge und Optionen für beständiges Ziel, z create-persistent-ddl . B. und test-target-writes werden nicht unterstützt. DDL-Pfade sind Repositoryeinstellungen, keine neuen modernize assess Befehlszeilenkennzeichnungen.
Bewerten der Anwendungsbereitschaft
Für die zusätzlichen Fähigkeiten zur Datenbankbewertung ist eine vollständige Analyse erforderlich. Die Standardeinstellung "Problem nur " führt sie nicht aus.
Interaktiver Modus (TUI)
Führen Sie im Anwendungsverzeichnis den Modernisierungs-Agent aus:
modernizeWählen Sie im Hauptmenü "Bewerten" aus.
Wählen Sie "Aktueller Ordner " aus, um Ihre Anwendung zu bewerten, oder wählen Sie "Manuelle Eingabe " aus, um einen lokalen Anwendungspfad einzugeben.
Wählen Sie die für Ihre Anwendung relevanten Bewertungsdomänen aus, und fahren Sie mit der Bewertungskonfiguration fort.
Wählen Sie unter "Allgemein/Analyseabdeckung" die Option "Vollständige Analyse" und dann " Weiter" aus.
Wählen Sie "Lokal bewerten" aus.
Geben Sie einen Ausgabepfad ein, oder akzeptieren Sie die Standardeinstellung, und starten Sie die Bewertung.
Die CLI verwendet Repository-Nachweise, um die Oracle-to-PostgreSQL-Anwendungsbewertung auszuwählen, wenn sie angewendet wird. Weitere Informationen zu den interaktiven Bildschirmen finden Sie unter Batchbewertung: Interaktiver Modus.
Kopfloser Modus
Erstellen Sie eine Bewertungskonfigurationsdatei, z C:\configs\database-assessment.yml. B. mit der folgenden Einstellung:
analysisCoverage: full
Führen Sie diese Einstellung mit einer vorhandenen Konfiguration zusammen, anstatt andere Bewertungseinstellungen zu ersetzen. Übergeben Sie die Datei wie im folgenden Befehl dargestellt an --assess-config, und ersetzen Sie die Quell-, Konfigurations- und Ausgabepfade durch Ihre eigenen:
modernize assess `
--source C:\src\oracle-app `
--assess-config C:\configs\database-assessment.yml `
--output-path C:\reports\oracle-app `
--format markdown `
--delegate local `
--no-tty `
--prompt 'Assess Oracle-to-PostgreSQL application-code migration readiness.'
Alternativ können Sie auf Windows eine vorhandene Datei auf Benutzerebene assessment-config.yaml aktualisieren, indem Sie analysisCoverage: full in %USERPROFILE%\.modernize\assessment-config.yaml festlegen. Wenn Sie diese Datei verwenden, lassen Sie den Befehl aus --assess-config . Ein expliziter --assess-config Pfad hat Vorrang vor der Datei auf Benutzerebene.
Note
--prompt Optional wird Ihr Ziel oder Umfang für zusätzliche Datenbankbewertungskompetenzen beschrieben. Die integrierte KI-Analyse von Modernize CLI ändert sich nicht. Verwenden Sie die Repositorykonfiguration für DDL-Pfade und Konvertierungsoptionen; die Eingabeaufforderung konfiguriert diese Einstellungen nicht.
Sie können --prompt weglassen. Mit aktivierter vollständiger Analyse verwendet die CLI Repository-Nachweise, um gegebenenfalls die Oracle-to-PostgreSQL-Anwendungsbewertung auszuwählen. Die Bewertung bewertet die Migrationsbereitschaft; sie konvertiert keinen Anwendungscode. Die Konvertierung wird während der Planausführung separat ausgeführt.
Überprüfen Sie den Bewertungsbericht
Öffnen Sie den generierten Anwendungsbericht, und folgen Sie Oracle zu PostgreSQL App Readiness. Der externe Bericht wird im Verzeichnis des aktuellen Repositoryberichts externals\oracle-to-postgresql-app-assessment als eigenständiges index.md Oder index.htmlveröffentlicht.
Die Bewertung führt eine begrenzte, schreibgeschützte statische Überprüfung durch. Ein abgeschlossener Bericht bedeutet, dass die Berichterstellung abgeschlossen ist, nicht die Anwendungskonvertierung oder Laufzeitüberprüfung bestanden hat.
- Wenn die Bewertung keine aktive Nutzung von Oracle-Anwendungen findet, überspringt der Workflow die Bewertung, anstatt einen Migrationsbericht zu erstellen.
- Wenn die Bewertung unvollständig ist, überprüfen Sie die gemeldeten Bereichseinschränkungen vor der Planung der Konvertierung.
- Wenn Sie ungültige DDL angeben, korrigieren Sie sie, und führen Sie es erneut aus, anstatt ein Nur-Code-Ergebnis anzunehmen.
Die Bewertung erstellt keine Konvertierungsaufgaben automatisch. Erstellen und überprüfen Sie als Nächstes einen Modernisierungsplan.
Konvertierungsplan erstellen
Beginnen Sie mit einem wegwerfbaren, eingecheckten Probe- oder Testzweig. Verwenden Sie eine Anforderung, die isolierte lokale Überprüfung vom unzulässigen Zugriff auf Kundendatenbanken unterscheidet:
$request = @'
Migrate this Oracle-dependent Java application to PostgreSQL using the offline
application adapter and the optional repository DDL and test configuration.
Allow disposable task-owned local PostgreSQL Docker containers for validation
of real application JDBC and ORM paths with synthetic data and cleanup.
Do not access customer or production databases, deploy cloud infrastructure,
change authentication policy, or perform unrelated framework upgrades.
'@
modernize plan create $request `
--source C:\src\oracle-app `
--language java `
--plan-name oracle-postgres `
--assess-file-path C:\reports\oracle-app\reports\report-<id>\index.md `
--delegate local `
--no-tty
Ersetzen Sie den --assess-file-path-Wert durch den tatsächlichen Pfad des Anwendungsbewertungsberichts, der von Ihrem Ausführungslauf ausgegeben wird, einschließlich aller Repository- und versionierten Berichtsverzeichnisse. Kopieren Sie den Platzhalter <id> nicht buchstäblich.
Weitere Planungsoptionen finden Sie unter Modernize CLI command reference: plan create.
Ändern Sie für eine .NET Anwendung die Anforderung so, dass die .NET Anwendung und ihre ADO.NET- oder ORM-Pfade beschrieben werden, und verwenden Sie --language dotnet.
Überprüfen Sie vor der Ausführung den generierten Plan und die Aufgabenliste:
- Vergewissern Sie sich, dass die Konvertierungsaufgabe für Java
migration-oracle-to-postgresql-app-javaverwendet. - Vergewissern Sie sich für .NET, dass
migration-oracle-to-postgresql-app-dotnetverwendet wird. - Halten Sie die Konvertierung innerhalb der beabsichtigten Anwendungsgrenze und behalten Sie nicht verwandte Anbieter sowie extern sichtbares Verhalten bei.
- Erlaube die aufgabeneigene lokale PostgreSQL-Docker-Validierung. Verwechseln Sie keine simulierte Einschränkung oder verwechseln Sie lokale Testcontainer nicht mit der Cloudbereitstellung.
- Überprüfen Sie die grundlegenden Basis-, Build-, Test-, Packaging- und Bereinigungsanforderungen.
Der bestehende Java migration-oracle-to-postgresql Skill ist ein anderer Workflow. Ersetzen Sie ihn nicht durch den Offlineanwendungsadapter.
Ausführen und Überprüfen
Führen Sie nach der Überprüfung des Plans Folgendes aus:
modernize plan execute `
--source C:\src\oracle-app `
--language java `
--plan-name oracle-postgres `
--delegate local `
--no-tty
Verwenden Sie --language dotnet für den .NET plan. Die Modernize CLI verwaltet die Aufgabenreihenfolge, den Fortschritt, die Verzweigungen und Commits.
Bei der Konvertierung wird Anwendungskontext verwendet, um Provider, Konfiguration, SQL, Zuordnungen, Routineverträge und Paketierung innerhalb des überprüften Bereichs zu aktualisieren. Es werden keine nicht verwandten Architektur-, Framework- oder Authentifizierungsänderungen vorgenommen.
Die Laufzeitüberprüfung verwendet reale Anwendungsdatenbankzugriffspfade gegen aufgabeneigene Einweg-PostgreSQL-Container mit synthetischen Daten, Assertionen und Bereinigungen. Kompilierung und Mocks allein belegen keine PostgreSQL-Kompatibilität.
Wenn Docker nicht verfügbar ist, bleibt die abhängige Überprüfung unvollständig. Der Workflow installiert Docker nicht und startet Docker Desktop standardmäßig nicht. Für das Starten eines installierten Docker Desktops ist die explizite start-docker-desktop Option in der Repositorykonfiguration erforderlich.
Konvertierungsergebnisse interpretieren
Überprüfen Sie Aufgabennachweise im Arbeitsordner des Plans unter oracle-postgres\<task-id>, einschließlich conversion-report.md und conversion-state.json. Überprüfen Sie geänderte Dateien, Befunde und deren Einstufungen, systemeigene Testergebnisse, Paketierung, Docker-Einrichtungsbereinigung und verbleibende Aktionen.
| Ergebnis | Dies bedeutet |
|---|---|
RUNTIME_VALIDATION_NEEDED |
Das stärkste Ergebnis der Offlinekonvertierung. Die Validierung von Kundenzielen und Prüfungen der Produktionsbereitschaft sind weiterhin erforderlich, auch wenn isolierte Docker-Tests erfolgreich sind. |
PARTIAL |
Erforderliches Verhalten ist zurückgestellt, oder die erforderliche Überprüfung ist fehlgeschlagen oder konnte nicht ausgeführt werden. Behandeln Sie dieses Ergebnis nicht als abgeschlossene Migration. |
Keines der Ergebnisse bedeutet Produktivumgebung READY. Überprüfen Sie bereitstellungsspezifisches Schema, Berechtigungen, Authentifizierung, repräsentative Workloads und das Betriebsverhalten in Ihrer eigenen kontrollierten Umgebung vor dem Produktionsrollout. Das Migrieren von Datenbankdaten und die Bereitstellung eines Zieldiensts sind separate Aktivitäten.