Migratie van Oracle naar PostgreSQL

De PostgreSQL-extensie voor Visual Studio Code biedt een end-to-end werkstroom voor het migreren van Oracle-databases naar PostgreSQL. Een begeleide wizard begeleidt u bij het maken van verbinding met uw Oracle-bron, het selecteren van schema's, het configureren van een Microsoft Foundry-model voor ai-ondersteunde DDL-conversie en het kiezen van een PostgreSQL-scratchdatabase voor validatie. Nadat het project is gemaakt, houdt een dashboard extractie, conversie, export en beoordeling bij in één weergave.

Hoe schema- en toepassingsconversie bij elkaar passen

De extensie converteert een Oracle-workload in twee stappen. Schemaconversie wordt eerst uitgevoerd en produceert de PostgreSQL-gegevensdefinitietaal (DDL) voor uw databaseobjecten. Toepassingsconversie wordt daarna uitgevoerd en werkt de code bij die deze objecten aanroept.

Schemaconversie

Schemaconversie leest de Oracle-gegevenswoordenlijst voor de schema's die u selecteert, groepeert de geëxtraheerde objecten in segmenten op basis van afhankelijkheden en converteert elk segment met behulp van uw Microsoft Foundry-implementatie. Geconverteerde objecten worden gecompileerd op basis van de scratchdatabase voordat ze worden weggeschreven, dus de DDL die u ontvangt, wordt geverifieerd in plaats van een schatting. Een uitvoering produceert:

• PostgreSQL-bestanden .sql op objectniveau, geordend op Oracle-schema en objecttype.
• Een conversierapport waarin wordt vastgelegd welke objecten zijn geconverteerd, die zijn overgeslagen en het algehele slagingspercentage.
• Taken controleren voor objecten die menselijke beoordeling nodig hebben, zoals terugval-DDL of gedrag dat verschilt tussen Oracle en PostgreSQL.
• Notities coderen die de Oracle-patronen beschrijven die in het schema zijn gevonden en hoe ze worden toegewezen aan PostgreSQL.

Applicatieconversie

Toepassingsconversie is gericht op de Oracle-specifieke code die de database omsluit: SQL-scripts, opgeslagen procedure-aanroepen, laadprogrammabestanden, shellscripts en Java-bestanden. Hierbij worden de codenotities van schemaconversie als invoer gebruikt, zodat de geconverteerde toepassingscode is afgestemd op de objectnamen, typen en aanroepende conventies die door de schemaconversie daadwerkelijk zijn geproduceerd.

U kunt databasegerelateerde toepassingscode in deze extensie converteren of het werk doorgeven aan de GitHub Copilot-app moderniseringsextensie voor een volledige moderniseringspas.

De twee slagen sequentieeren

Voer eerst schemaconversie uit. Toepassingsconversie is afhankelijk van de coderingsnotities en geconverteerde objectnamen die door schemaconversie worden gegenereerd, dus het converteren van toepassingscode voordat het schema zich vereffent, produceert code die is gericht op objecten die mogelijk nog steeds worden gewijzigd. Als u de schemaconversie opnieuw uitvoert nadat u het schemabereik hebt gewijzigd of een bronobject hebt hersteld, controleert u de toepassingscode opnieuw op basis van de bijgewerkte coderingsnotities.

Prerequisites

Voordat u begint, moet u ervoor zorgen dat u het volgende heeft:

• Visual Studio Code geïnstalleerd.
• De PostgreSQL-extensie is geïnstalleerd.
• Toegang tot een Oracle-brondatabase met leesmachtigingen voor schema-extractie.
• Een Azure Database for PostgreSQL flexibele server die moet worden gebruikt als een scratchvalidatiedatabase. Schemaconversie biedt geen ondersteuning voor Azure HorizonDB als de scratchdatabase.
• Een Microsoft Foundry-resource met een geïmplementeerd gpt-5.2 model. U hebt de eindpunt-URL en een API-sleutel of een Microsoft Entra ID-account met toegang nodig.

Controleren of de migratiefunctie is ingeschakeld

De pgsql.enableMigrations instelling bepaalt de weergave Migraties en alle migratieopdrachten. Deze instelling is standaard ingeschakeld.

Als de weergave Migraties niet wordt weergegeven in de zijbalk, opent u Visual Studio Code instellingen (Ctrl+, op Windows/Linux, Cmd+, macOS) en controleert u of pgsql.enableMigrations dit is ingesteld op true.

Een migratieproject maken

Een migratieproject is een wizard met vier stappen die uw bron-, doel- en AI-configuratie verzamelt voordat u de projectwerkruimte maakt.

Stap 1: Project instellen

1. Open de weergave Migraties in de zijbalk.

2. Start een nieuw project op een van de volgende manieren:

   • Als de werkruimte nog geen migratie-project bevat, selecteert u + Migratie maken Project in de weergave.
   • Selecteer de + knop in de werkbalk Weergave.
   • Klik met de rechtermuisknop op een werkruimtemap in Explorer en selecteer Migratie openen Project.

   De pagina Nieuw migratieproject van Oracle naar Azure Database for PostgreSQL wordt geopend, met daarin een overzicht van wat u nodig hebt:

   • Verbindingsgegevens voor de brondatabase
   • Namen van de schema's die moeten worden geconverteerd
   • Eindpunt-URL en -sleutel voor een Microsoft Foundry-resource
   • Verbindingsnaam voor een bestaand Azure Database for PostgreSQL-exemplaar

3. Voer een naam in het veld Project Naam in.

4. Selecteer Volgende: Oracle Connection.

Stap 2: Verbinding maken met Oracle

Op de pagina Verbinding maken met Oracle worden uw Referenties voor de Oracle-brondatabase verzameld en kunt u schema's laden.

1. Voltooi de Oracle-verbindingsvelden:

   Veld	Beschrijving
   Oracle-hostnaam	Hostnaam of IP-adres van de Oracle-databaseserver.
   Oracle poort	Luisterpoort (standaard: 1521).
   Oracle SID of servicenaam	Oracle SID of servicenaam voor het database-exemplaar.
   Oracle-gebruikersnaam	Databasegebruiker met leestoegang tot schemaobjecten.
   Oracle-wachtwoord	Wachtwoord voor de Oracle-gebruiker.

2. Selecteer Schema's laden om verbinding te maken en de lijst met beschikbare schema's op te halen.

3. Selecteer een of meer schema's die u wilt migreren in de vervolgkeuzelijst Schema's .

4. Selecteer Volgende: PostgreSQL-verbinding.

Stap 3: Een Azure Database for PostgreSQL scratchdatabase kiezen

Op de pagina Een tijdelijke Azure Database for PostgreSQL-database kiezen selecteert u de PostgreSQL-instantie die het AI-model gebruikt om geconverteerde DDL-bestanden te valideren.

1. Selecteer een bestaand verbindingsprofiel in de vervolgkeuzelijst PostgreSQL Connection . Als de verbinding die u nodig hebt niet wordt weergegeven, selecteert u Profielen vernieuwen om beschikbare profielen opnieuw te laden of maakt u eerst een nieuwe verbinding in de weergave Verbindingen en identiteit .
2. Selecteer de doeldatabase in de vervolgkeuzelijst PostgreSQL Database . Selecteer Databases laden als de lijst leeg is.
3. Nadat u een database hebt geselecteerd, controleert de extensie automatisch of de aanbevolen PostgreSQL-extensies zijn geïnstalleerd. U kunt ook Extensies verifiëren selecteren om de controle handmatig uit te voeren. Als er extensies ontbreken, worden deze op de pagina vermeld met richtlijnen voor acceptatielijst en installatie.
4. Selecteer Volgende: Microsoft Foundry-modelconfiguratie.

Stap 4: het Microsoft Foundry-model configureren

De pagina Een Microsoft Foundry-model kiezen configureert de Microsoft Foundry-implementatie waarmee schema- en codeconversie wordt uitgevoerd.

1. Vul de velden van het taalmodel in:

   Veld	Beschrijving
   Modelnaam	gpt-5.2.
   Microsoft Foundry-eindpunt	eindpunt-URL van de Microsoft Foundry-resource (bijvoorbeeld https://<resource>.openai.azure.com/).
   Verificatiemethode	Kies API-sleutel of Microsoft Entra-id.
   Microsoft Foundry-API-sleutel	API-sleutel voor de Microsoft Foundry-resource (weergegeven wanneer de verificatiemethodeAPI-sleutel is).
   Azure-account	Microsoft-account met toegang tot de resource (weergegeven wanneer de verificatiemethodeMicrosoft Entra-id is).
   Huurder	Microsoft Entra tenant voor het account (weergegeven wanneer de verificatiemethodeis Microsoft Entra-id).
   Implementatienaam	Naam van het geïmplementeerde model in uw Microsoft Foundry-resource.

2. Selecteer Test Microsoft Foundry Connection om de verbinding te controleren.

3. Selecteer Migratieproject maken.

Schemamigratie uitvoeren

Nadat het project is gemaakt, wordt het Oracle Migration-dashboard geopend. In het dashboard worden kaarten voor schemamigratie en schemabeoordeling weergegeven, samen met een accordeon Instellingen waarin de projectconfiguratie wordt samengevat.

Schema’s extraheren en converteren

De schemamigratiekaart (stap 1) voert extractie, conversie en export uit als een continue pijplijn.

1. Selecteer Migreren op de kaart Schemamigratie.

   Het knoplabel wordt bijgewerkt wanneer de pijplijn vordert:

   Status	Knoptekst
   Extractie wordt uitgevoerd	Uitpakken...
   Extractie voltooid, conversie in afwachting	Migratie hervatten
   Conversie wordt uitgevoerd	Converteren...
   Alle fasen zijn voltooid	Migratie voltooid

2. De voortgang in de uitgevouwen kaart bewaken:

   • Extractie toont het aantal geëxtraheerde objecten (bijvoorbeeld '15 van 42 objecten geëxtraheerd') en het huidige schema en object dat wordt verwerkt.
   • Conversie toont het aantal geconverteerde segmenten (bijvoorbeeld '3 van 8 segmenten geconverteerd') en het huidige segment dat wordt verwerkt.

3. Nadat het exporteren is voltooid, selecteert u Migratierapport weergeven om het gegenereerde migratierapport te openen.

Migratietaken controleren

Op de kaart Schemabeoordeling (stap 2) worden items weergegeven waarvoor handmatige aandacht nodig is na de conversie. Met een switcher voor gegroepeerde / taken boven aan het revisiegebied kunt u kiezen hoe u door de lijst kunt werken.

Gegroepeerde weergave

De gegroepeerde weergave organiseert controletaken in samenvouwbare accordeongroepen per categorie. Gebruik deze weergave als u gerelateerde problemen samen wilt verwerken.

1. Selecteer op de kaart SchemabeoordelingControleren om het beoordelingsvenster uit te vouwen en selecteer vervolgens Gegroepeerd.

2. Gebruik de tabbladen In behandeling en Opgelost om te schakelen tussen taken die nog steeds aandacht nodig hebben en taken die u al hebt goedgekeurd.

3. Vouw een groep uit om de metagegevens (schema's, objecttypen, kritiek) en de afzonderlijke taakkaarten erin te zien.

4. Gebruik de acties op groepsniveau om taken bulksgewijs te verwerken:

   Handeling	Beschrijving
   Alles uitvoeren	Open elke taak die in behandeling is in de groep in Copilot Agentmodus voor door AI ondersteunde beoordeling.
   Alles oplossen	Markeer alle taken in de groep als opgelost. In een bevestigingsvenster ziet u de groepsnaam en het aantal taken voordat u doorgaat.
   Alles opnieuw instellen	Zet alle opgeloste taken in de groep terug naar de status In behandeling. Beschikbaar op het tabblad Opgelost .
   Bekijken in Taken	Schakel over naar de platte takenweergave die is gefilterd op deze groep.

5. Als u wilt reageren op één taak in de groep, selecteert u Taak uitvoeren om deze te openen in Copilot agentmodus of selecteert u Oplossen om deze voltooid te markeren. Selecteer Opnieuw openen bij een voltooide taak om deze terug te zetten naar de status 'In behandeling'.

Takenoverzicht

De weergave Taken toont alle beoordelingstaken in een eenvoudige tabel. Gebruik deze weergave als u alle taken wilt sorteren, filteren of doorzoeken, ongeacht de groep.

1. Selecteer Taken in de schakeloptie.
2. Gebruik de filtervervolgkeuzelijsten (Status, Kritiek, Objecttype, Schema) om de takenlijst te verfijnen.
3. Selecteer Taak uitvoeren voor een item in behandeling om het te openen in Copilot agentmodus voor door AI ondersteunde beoordeling en correctie.
4. Nadat u een item hebt opgelost, selecteert u Oplossen om het voltooid te markeren.

Toepassingscode migreren

Na de schemamigratie converteert u Oracle-specifieke toepassingscode (SQL-scripts, opgeslagen procedures, laadprogrammabeheerbestanden, shellscripts of Java-bestanden) naar postgreSQL-compatibele equivalenten. Toepassingsmigratie is een preview-functie.

Een migratiemethode kiezen

De extensie biedt twee paden voor migratie van toepassingscode:

• Volledige modernisering van apps: als u de Uitbreiding voor modernisering van GitHub Copilot-app installeert, selecteert u Migreren met behulp van app-modernisering om de migratie voort te zetten met coderingsnotities van de schemaconversie. Selecteer Codenotities weergeven om de gegenereerde richtlijnen te bekijken voordat u doorgaat.
• Optie alleen database: als u alleen databasegerelateerde toepassingscode binnen deze extensie wilt converteren, selecteert u Migreren met de PostgreSQL-extensie.

Toepassingscode binnen de extensie converteren

1. Selecteer op de kaart Toepassingsmigratiede optie Gegevens migreren (of Selecteer methode als de extensie voor app-modernisering wordt gedetecteerd).
2. Op de pagina Applicatie converteren selecteert u Te converteren Oracle-applicatie selecteren en kiest u de map die Oracle-applicatiecode bevat.
3. Selecteer een PostgreSQL-verbinding en PostgreSQL-database voor conversiecontext.
4. Selecteer Databases laden als de databaselijst leeg is.
5. Selecteer Applicatie converteren om de conversie te starten.

Copilot-hulpprogramma's gebruiken voor applicatiemigratie

De extensie registreert twee Copilot taalmodelhulpprogramma's voor migratieondersteuning:

• Oracle Client Code Application Converter (pgsql_migration_oracle_app): Converteert oracle-clienttoepassingscode naar PostgreSQL-equivalenten met behulp van promptsjablonen en coderingsrichtlijnen van de schemamigratieanalyse. Accepteert de volgende parameters:

  • Toepassingscodebasismap (vereist): locatie van de code die moet worden geconverteerd.
  • Locatiepad voor notities coderen (optioneel): pad naar het coderen van notities uit de schemamigratie.
  • Postgres DB Name (optioneel): Naam van de PostgreSQL-database voor conversiecontext.
  • Postgres DB-verbinding (optioneel): Verbindingsnaam voor de PostgreSQL-database.

• Oracle naar Postgres-migratierapport weergeven (pgsql_migration_show_report): Geeft het migratierapport weer dat is gegenereerd door de schemaconversie. Vereist een parameter Pad naar rapportbestand.

Zie Copilot-integratie voor meer informatie over het gebruik van Copilot hulpprogramma's.

Geconverteerde bestanden vergelijken

Controleer na de conversie de wijzigingen naast elkaar met behulp van de ingebouwde diff-opdrachten.

1. Klik in Explorer met de rechtermuisknop op een geconverteerd SQL-bestand onder de oracle of postgres map in het migratieproject en selecteer DDL-migratiebestandparen vergelijken.
2. Voor geconverteerde toepassingscodebestanden (.sql, .ctl, .sh, .loadof .java) klikt u met de rechtermuisknop op het bestand en selecteert u Toepassingsmigratiebestandparen vergelijken.

In de diff-weergave naast de geconverteerde PostgreSQL-uitvoer ziet u de oorspronkelijke Oracle-bron, zodat u alle artefacten kunt identificeren waarvoor handmatige aanpassing is vereist.

Migratieprojecten beheren

Gebruik de weergave Migraties in de zijbalk om uw projecten te beheren:

Verwante inhoud

• Wat is Oracle om een flexibele serverschemaconversie te Azure Database for PostgreSQL?
• Zelfstudie: Oracle naar Azure Database for PostgreSQL flexibele serverschemaconversie
• Best practices voor oracle naar Azure Database for PostgreSQL flexibele serverschemaconversie
• Taken en uitvoermappen voor Oracle controleren om schemaconversie van flexibele servers te Azure Database for PostgreSQL
• Beperkingen voor schemaconversie van Oracle naar Azure Database for PostgreSQL flexibele server
• integratie van Copilot
• Verbindingen en identiteit
• Naslagwerk voor instellingen
• Naslagwerk voor Copilot-hulpmiddelen