Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Använd Modernisera CLI för att utvärdera Oracle-beroende programkod och skapa en plan för att konvertera den till PostgreSQL. Arbetsflödet stöder Java och .NET program med hjälp av programkällan och valfria exporterade databasdefinitioner i stället för en anslutning till en realtidsmåldatabas.
Important
Oracle-to-PostgreSQL-programmigrering i Modernize CLI är i offentlig förhandsversion. Det här arbetsflödet ändrar programkoden. Den migrerar inte databasservrar eller kunddata, distribuerar molninfrastruktur eller upprättar produktionsberedskap. Använd lokal körning för arbetsflödet i den här artikeln.
Stödda scenarier
Utvärderingen identifierar aktiva Oracle-beroenden i applikationsleverantörer, konfiguration, SQL, ORM-mappningar, sekvenser och rutinanrop. Adress för språkspecifika konverteringsfärdigheter:
| Ansökan | Exempel på konverteringsomfång |
|---|---|
| Java | Oracle JDBC, JPA/Hibernate-mappningar, SQL, sekvenser, rutinkontrakt, tester och drivrutinspaketering. |
| .NET | Oracle.DataAccess och Oracle.ManagedDataAccess, ADO.NET, Dapper, EF/EF Core-mappningar, SQL, rutinkontrakt, Npgsql, tester och publicering av utdata. |
Arbetsflödet gäller inte för program som endast använder PostgreSQL, icke-Oracle-källmigreringar eller databasserverutvärdering. Arbetsflödet är inriktat på Oracle-beroenden som används av programkod eller konfiguration. Oracle-referenser som bara finns i dokumentationen, eller i ett oanvänt Oracle-bibliotek, räcker inte för att identifiera ett migreringsmål.
Det här källbaserade arbetsflödet stöder Java och .NET program och kan använda valfria PostgreSQL DDL-exporter för att informera konverteringen. Det kräver inte någon live-databasanslutning eller programavbrott och lägger inte automatiskt till Azure hanterad identitet eller ändrar programmets autentiseringsprincip. Den separata migreringsmiljön Oracle-till-PostgreSQL Java ger en Java migreringsuppgift som uppdaterar databasklienter för hanterad identitetsautentisering och konverterar SQL, eventuellt med hjälp av kodningsanteckningar som genereras under konvertering av databasschema.
Prerequisites
- Modernisera CLI och dess GitHub autentiseringskrav.
- En lokal utcheckning av ett Oracle-beroende Java eller .NET program.
-
Node.js 22 eller senare som finns som
nodepå dinPATH. Det här kravet gäller för migreringshjälparna. Modernize CLI:s bundlade körtid ersätter det inte. Inga npm-körningspaket krävs. - För konvertering, programmets JDK och byggverktyg, eller dess .NET SDK och byggverktyg.
- För PostgreSQL-körningsverifiering, en körande Docker-motor som kör disponibla lokala PostgreSQL-containrar.
- En incheckad programbaslinje på en bifogad Git-gren före källkonvertering.
Utvärderingen bygger eller testar inte programmet, kör Docker, ansluter till en databas eller ändrar programkällan. Förbered beroenden innan du kör; utvärderingen installerar inte verktyg eller autentiserar interaktivt.
Ange valfria databasdefinitioner
Du kan bedöma och konvertera enbart från programkod. Om du vill ange målschemakontrakt lägger du till den här valfria filen i programlagringsplatsen på .github\modernize\oracle-postgres.json:
{
"postgres-ddl-folder": "database\\postgres",
"options": ["tests"]
}
Sammanfoga de här inställningarna med en befintlig konfiguration i stället för att ersätta den.
| Setting | Purpose |
|---|---|
postgres-ddl-folder |
PostgreSQL DDL-exporter som är endast läsbara, som filer per objekt eller endast schemadumpar. |
oracle-ddl-folder |
Valfritt, separata ursprungliga Oracle-definitioner för att bevara källbeteendet. |
oracle-schema |
Exakt Oracle-schemaväljare när en Oracle DDL-mapp tillhandahålls. |
options |
Konverteringsåtgärder för att uttryckligen aktivera, enligt beskrivningen i följande tabell. |
| Option | Purpose |
|---|---|
tests |
Aktiverar baslinjestöd, testgenerering och reparation av brutna tester. |
Konverteringsåtgärder måste uttryckligen aktiveras. Utelämnade åtgärder förblir inaktiverade.
Alla inställningar och själva konfigurationsfilen är valfria. Relativa sökvägar löses från programroten. Utelämna en DDL-inställning för drift i endast kodläge; en uttryckligen angiven saknad, tom eller ogiltig mapp är ett fel, inte en återgång till bedömning i endast kodläge.
Använd dedikerade, endast schemabaserade UTF-8-exportmappar. Inkludera inte kunddata, filsystemlänkar eller körbara inkluderingar för SQL-klienter. PostgreSQL-filtillägg som stöds är .sql, .ddl, .psql, .pgsql, .fnc, , .prc, .vwoch .trg. Anteckningar i text och Markdown ignoreras. Objektidentitet kommer från DDL-deklarationer, inte filnamn.
DDL-ögonblicksbilder beskriver exporterade kontrakt, inte det aktuella innehållet eller behörigheterna i en aktiv databas. Ett objekt som saknas i en export är inte bevisligen frånvarande i den aktiva databasen. Granska tvetydiga överlagrade rutiner och konstruktioner som inte stöds explicit.
Lägg inte till autentiseringsuppgifter eller liveanslutningsprofiler i den här konfigurationen. Permanenta skrivningar till mål och alternativ som create-persistent-ddl och test-target-writes stöds inte. DDL-sökvägar är lagringsplatsens inställningar, inte nya modernize assess kommandoradsflaggor.
Utvärdera programberedskap
Fullständig analys krävs för den ytterligare kunskapen för databasutvärdering. Standardinställningen Problem endast kör inte analysen.
Interaktivt läge (TUI)
Kör moderniseringsagenten från applikationskatalogen:
modernizeVälj Utvärdera på huvudmenyn.
Välj Aktuell mapp för att utvärdera ditt program eller Manuell inmatning för att ange en lokal programsökväg.
Välj de utvärderingsdomäner som är relevanta för ditt program och fortsätt till utvärderingskonfigurationen.
Under Allmän/Analystäckning väljer du Fullständig analys och sedan Fortsätt.
Välj Utvärdera lokalt.
Ange en utdatasökväg eller acceptera standardinställningen och starta utvärderingen.
CLI använder databasinformation för att välja Oracle-till-PostgreSQL-programutvärderingen när den tillämpas. Mer information om de interaktiva skärmarna finns i Batch assessment: Interactive mode.
headless-läge
Skapa en utvärderingskonfigurationsfil, till exempel C:\configs\database-assessment.yml, med följande inställning:
analysisCoverage: full
Sammanfoga den här inställningen med en befintlig konfiguration i stället för att ersätta andra utvärderingsinställningar. Skicka filen till --assess-config enligt följande kommando och ersätt käll-, konfigurations- och utdatasökvägarna med dina egna:
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.'
På Windows kan du också uppdatera en befintlig fil på användarnivå assessment-config.yaml på %USERPROFILE%\.modernize\assessment-config.yaml genom att ange analysisCoverage: full. Om du använder den filen, utelämna --assess-config från kommandot. En explicit --assess-config sökväg har företräde framför filen på användarnivå.
Note
Det valfria --prompt beskriver ditt mål eller omfång för ytterligare färdigheter för databasutvärdering. Det ändrar inte Modernize CLI:s inbyggda AI-analys. Använd lagringsplatsens konfiguration för DDL-sökvägar och konverteringsalternativ. Prompten konfigurerar inte dessa inställningar.
Du kan utelämna --prompt. När fullständig analys är aktiverad använder CLI databasinformation för att välja applikationsbedömning från Oracle till PostgreSQL när det är tillämpligt. Utvärderingen utvärderar migreringsberedskap. Den konverterar inte programkod. Konverteringen körs separat under plankörningen.
Granska utvärderingsrapporten
Öppna den genererade programrapporten och följ Oracle to PostgreSQL App Readiness. Den externa rapporten publiceras under den aktuella databasrapportens externals\oracle-to-postgresql-app-assessment katalog som fristående index.md eller index.html.
Utvärderingen utför begränsad, skrivskyddad statisk inspektion. En slutförd rapport innebär att rapportgenereringen har slutförts, inte att applikationskonvertering eller körningsverifiering har lyckats.
- Om utvärderingen inte hittar aktiv användning av Oracle-applikationer hoppar arbetsflödet över utvärderingen i stället för att skapa en migreringsrapport.
- Om utvärderingen är ofullständig granskar du de rapporterade omfångsbegränsningarna innan du planerar konverteringen.
- Om du anger ogiltig DDL korrigerar du det och kör det igen i stället för att anta ett resultat med endast kod.
Utvärderingen skapar inte konverteringsuppgifter automatiskt. Skapa och granska en moderniseringsplan härnäst.
Skapa en konverteringsplan
Börja med ett disponibelt, incheckat prov eller en testgren. Använd en begäran som skiljer isolerad lokal validering från förbjuden åtkomst till kunddatabaser:
$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
--assess-file-path Ersätt värdet med den faktiska programutvärderingsrapportsökvägen som skrivs ut av utvärderingskörningen, inklusive alla lagringsplatser och versionsbaserade rapportkataloger. Kopiera inte platshållaren <id> bokstavligen.
Fler planeringsalternativ finns i Modernize CLI command reference: plan create.
För ett .NET program ändrar du begäran för att beskriva .NET-programmet och dess ADO.NET- eller ORM-sökvägar och använder --language dotnet.
Granska den genererade planen och uppgiftslistan före körning:
- För Java kontrollerar du att konverteringsaktiviteten använder
migration-oracle-to-postgresql-app-java. - För .NET kontrollerar du att den använder
migration-oracle-to-postgresql-app-dotnet. - Behåll konverteringen inom den avsedda applikationsgränsen och bevara orelaterade leverantörer och publikt beteende.
- Tillåt uppgiftsägd lokal PostgreSQL Docker-validering. Inför inte en begränsning till endast mockar och blanda inte ihop lokala testcontainrar med molndistribution.
- Granska baslinje-, bygg-, test-, paketerings- och rensningskrav.
Den befintliga Java migration-oracle-to-postgresql färdigheten är ett annat arbetsflöde. Ersätt den inte med offlineprogramadaptern.
Kör och verifiera
När du har granskat planen kör du:
modernize plan execute `
--source C:\src\oracle-app `
--language java `
--plan-name oracle-postgres `
--delegate local `
--no-tty
Använd --language dotnet för .NET-planen. Modernize CLI hanterar uppgiftsordning, förlopp, grenar och incheckningar.
Konverteringen använder applikationsbevis för att uppdatera leverantörer, konfiguration, SQL, mappningar, rutinkontrakt och paketering inom det granskade omfånget. Den gör inte orelaterade ändringar i arkitektur, ramverk eller autentisering.
Körningsvalidering använder verkliga kodvägar för programdatabasåtkomst mot disponibla uppgiftsägda PostgreSQL-containrar med syntetiska data, kontroller och rensning. Enbart kompilering och mocks bevisar inte PostgreSQL-kompatibilitet.
Om Docker inte är tillgängligt förblir beroende validering ofullständig. Arbetsflödet installerar inte Docker eller startar Docker Desktop som standard. Att starta ett installerat Docker Desktop kräver det explicita start-docker-desktop-alternativet i lagringsplatsens konfiguration.
Tolka konverteringsresultat
Granska underlag för uppgiften i arbetsmappen för planen på oracle-postgres\<task-id>, inklusive conversion-report.md och conversion-state.json. Kontrollera ändrade filer, bedömningar av fynd, interna testresultat, paketering, rensning av Docker-fixturer och återstående åtgärder.
| Outcome | Meaning |
|---|---|
RUNTIME_VALIDATION_NEEDED |
Det starkaste offlinekonverteringsresultatet. Verifiering av kundmål och produktionsberedskap krävs fortfarande, även när isolerade Docker-tester klaras. |
PARTIAL |
Det begärda beteendet skjuts upp eller nödvändig validering misslyckades eller kunde inte köras. Behandla inte det här resultatet som en slutförd migrering. |
Inget av utfallen innebär att det är redo för produktion READY. Verifiera driftsättningsspecifikt schema, behörigheter, autentisering, representativa arbetsbelastningar och driftbeteende i din egen kontrollerade miljö innan produktionsutrullning. Att migrera databasdata och etablera en måltjänst är separata aktiviteter.