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.

Important

De migratiewerkstroom van Oracle naar PostgreSQL is alleen beschikbaar in Visual Studio Code.

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 PostgreSQL-instantie om te gebruiken als tijdelijke validatiedatabase (bijvoorbeeld een Azure Database for PostgreSQL Flexible Server).
  • 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 (preview) en alle migratieopdrachten. Deze instelling is standaard ingeschakeld.

Als de weergave Migraties (preview) niet wordt weergegeven in de zijbalk, controleert u de instelling:

  1. Open VS Code-instellingen (Ctrl+, op Windows/Linux, Cmd+, op macOS).
  2. Zoek naar pgsql.enableMigrations.
  3. Controleer of de waarde is 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 (preview) in de zijbalk.

  2. Selecteer de knop + op de werkbalk Weergave, of klik met de rechtermuisknop op een werkruimtemap in Explorer en selecteer Migratieproject maken.

    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
    • Naam van de schema('s) die moeten worden geconverteerd
    • Eindpunt-URL en -sleutel voor een Microsoft Foundry-resource
    • Verbindingsnaam voor een bestaand PostgreSQL-exemplaar

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

  4. Selecteer Volgende: Oracle Connection.

Schermopname van de pagina nieuwe migratie project met Project veld Naam.

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.

Note

Gebruik een toegewezen scratchdatabase voor validatie. Tijdens het conversieproces kan de extensie geconverteerde DDL uitvoeren op deze database.

  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 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 en vindt u in de documentatie van Azure Database for PostgreSQL Flexible Server instructies voor het toestaan en installeren ervan.
  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 Azure AD-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.

Tip

Microsoft Foundry raadt 500.000 TPM (tokens per minuut) aan voor optimale migratieprestaties.

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'.

Note

Alles oplossen en Alles opnieuw instellen zijn uitgeschakeld wanneer een groep meer dan 800 taken bevat.

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.

Tip

Selecteer Logboeken weergeven in het dashboard om logboekbestanden voor extractie en conversie te controleren voor probleemoplossing.

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 de GitHub Copilot-app moderniseringsextensie is geïnstalleerd, 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 coderingsnotities (optioneel) — Pad naar de coderingsnotities van de schemamigratie.
    • Postgres DB-naam (optioneel): naam van de PostgreSQL-database voor conversiecontext.
    • Postgres DB-verbinding (optioneel): verbindingsnaam voor de PostgreSQL-database.

  • Oracle naar Postgres Migration Report (pgsql_migration_show_report) weergeven : 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.

Note

DDL-bestanden moeten de structuur folder/oracle|postgres/SCHEMA_NAME/DDL-TYPE/filename.sql voor de vergelijkingsopdracht volgen om het overeenkomende bestandspaar te vinden.

Migratieprojecten beheren

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

Handeling Beschrijving
Open migratieproject Open een bestaand migratieproject in het dashboard.
Onthullen in Explorer De projectmap weergeven in de Verkenner-weergave.
Verwijderen Een migratieproject verwijderen. U wordt gevraagd om te bevestigen voordat u deze verwijdert.
Vernieuwen Laad de lijst met migratieprojecten opnieuw in de huidige werkruimte.

Verwante inhoud

  • Last updated on