Oracle till PostgreSQL-migrering

PostgreSQL-tillägget för Visual Studio Code tillhandahåller ett arbetsflöde från slutpunkt till slutpunkt för migrering av Oracle-databaser till PostgreSQL. En guidad guide vägleder dig genom att ansluta till Oracle-källan, välja scheman, konfigurera en Microsoft Foundry-modell för AI-assisterad DDL-konvertering och välja en PostgreSQL-scratch-databas för validering. När projektet har skapats spårar en instrumentpanel extrahering, konvertering, export och granskning i en enda vy.

Important

Arbetsflödet oracle till PostgreSQL-migrering är endast tillgängligt i Visual Studio Code.

Förutsättningar

Kontrollera att du har följande innan du börjar:

  • Visual Studio Code installerat.
  • PostgreSQL-tillägget har installerats.
  • Åtkomst till en Oracle-källdatabas med läsbehörighet för schemaextrahering.
  • En PostgreSQL-instans som ska användas som en scratch-valideringsdatabas (till exempel en Azure Database for PostgreSQL flexibel server).
  • En Microsoft Foundry-resurs med en distribuerad gpt-5.2 modell. Du behöver slutpunkts-URL:en och antingen en API-nyckel eller ett Microsoft Entra ID konto med åtkomst.

Kontrollera att migreringsfunktionen är aktiverad

Inställningen pgsql.enableMigrations styr vyn Migreringar (förhandsversion) och alla migreringskommandon. Den här inställningen är aktiverad som standard.

Om vyn Migreringar (förhandsversion) inte visas i sidofältet kontrollerar du inställningen:

  1. Öppna VS Code-inställningar (Ctrl+, på Windows/Linux, Cmd+, på macOS).
  2. Sök efter pgsql.enableMigrations.
  3. Bekräfta att värdet är true.

Skapa ett migreringsprojekt

Ett migreringsprojekt är en guide i fyra steg som samlar in din käll-, mål- och AI-konfiguration innan du skapar projektarbetsytan.

Steg 1: Projektkonfigurering

  1. Öppna vyn Migreringar (förhandsversion) i sidofältet.

  2. Välj knappen + i vyverktygsfältet, eller högerklicka på en arbetsytemapp i Utforskaren och välj Skapa migreringsprojekt.

    Sidan Nytt migreringsprojekt från Oracle till Azure Database for PostgreSQL öppnas med en lista över det du behöver:

    • Anslutningsinformation för källdatabasen
    • Namnet på de scheman som ska konverteras
    • Slutpunkts-URL och nyckel för en Microsoft Foundry-resurs
    • Anslutningsnamn för en befintlig PostgreSQL-instans

  3. Ange ett namn i fältet Project Namn.

  4. Välj Nästa: Oracle-anslutning.

Skärmbild av den nya sidan för migreringsprojekt med fältet Projektnamn.

Steg 2: Anslut till Oracle

Sidan Anslut till Oracle samlar in dina autentiseringsuppgifter för Oracle-källdatabasen och låter dig läsa in scheman.

  1. Slutför Oracle-anslutningsfälten:

    Fält Beskrivning
    Oracle-värdnamn Värdnamn eller IP-adress för Oracle-databasservern.
    Oracle-port Lyssnarport (standard: 1521).
    Oracle SID eller tjänstnamn Oracle SID eller tjänstnamn för databasinstansen.
    Oracle-användarnamn Databasanvändare med läsbehörighet till schemaobjekt.
    Oracle-lösenord Lösenord för Oracle-användaren.

  2. Välj Läs in scheman för att ansluta och hämta listan över tillgängliga scheman.

  3. I listrutan Scheman väljer du ett eller flera scheman som ska migreras.

  4. Välj Nästa: PostgreSQL-anslutning.

Steg 3: Välj en Azure Database for PostgreSQL scratch-databas

Sidan Välj en Azure Database for PostgreSQL scratch-databas väljer den PostgreSQL-instans som AI-modellen använder för att verifiera konverterade DDL-filer.

Note

Använd en dedikerad scratch-databas för validering. Tillägget kan köra konverterad DDL mot den här databasen under konverteringsprocessen.

  1. I listrutan PostgreSQL-anslutning väljer du en befintlig anslutningsprofil. Om anslutningen du behöver inte visas väljer du Uppdatera profiler för att läsa in tillgängliga profiler igen eller skapar en ny anslutning i vyn Anslutningar och identitet först.
  2. I listrutan PostgreSQL Database väljer du måldatabasen. Välj Läs in databaser om listan är tom.
  3. När du har valt en databas verifierar tillägget automatiskt att rekommenderade PostgreSQL-tillägg installeras. Du kan också välja Verifiera tillägg för att köra kontrollen manuellt. Om några tillägg saknas listar sidan dem och ger vägledning om hur du lägger till dem i tillåtslistan och installerar dem i dokumentationen för Azure Database for PostgreSQL – flexibel server.
  4. Välj Nästa: Microsoft Foundry-modellkonfiguration.

Steg 4: Konfigurera Microsoft Foundry-modellen

Sidan Välj en Microsoft Foundry Model konfigurerar distributionen Microsoft Foundry som driver schema- och kodkonvertering.

  1. Slutför språkmodellfälten:

    Fält Beskrivning
    Modellnamn gpt-5.2.
    Microsoft Foundry-slutpunkt Microsoft Resursslutpunkts-URL för Foundry (till exempel https://<resource>.openai.azure.com/).
    Autentiseringsmetod Välj API-nyckel eller Microsoft Entra-ID.
    API-nyckel för Microsoft Foundry API-nyckel för resursen Microsoft Foundry (visas när autentiseringsmetoden är API-nyckel).
    Azure konto Microsoft-konto med åtkomst till resursen (visas när autentiseringsmetodenär Microsoft Entra ID).
    Hyresgäst Azure AD-klient för kontot (visas när autentiseringsmetodenär Microsoft Entra ID).
    Distributionsnamn Namnet på den distribuerade modellen i resursen Microsoft Foundry.

  2. Välj Testa Microsoft Foundry-anslutning för att verifiera anslutningen.

  3. Välj Skapa migreringsprojekt.

Tip

Microsoft Foundry rekommenderar 500 000 TPM (token per minut) för optimala migreringsprestanda.

Kör schemamigrering

När projektet har skapats öppnas Oracle Migration-instrumentpanelen . Instrumentpanelen visar korten schemamigrering och schemagranskning, tillsammans med ett inställningsdragspel som sammanfattar din projektkonfiguration.

Extrahera och konvertera scheman

Kortet Schemamigrering (steg 1) kör extrahering, konvertering och export som en kontinuerlig pipeline.

  1. På kortet Schemamigrering väljer du Migrera.

    Knapptexten uppdateras allteftersom arbetsflödet fortskrider:

    Status Knapptext
    Extrahering pågår Extraherar ...
    Extrahering har slutförts, konvertering väntar Återuppta migrering
    Konvertering pågår Konverterar ...
    Alla faser har slutförts Migreringen har slutförts

  2. Följ förloppet i det expanderade kortet:

    • Extrahering visar antalet extraherade objekt (till exempel "15 av 42 objekt extraherade") och det aktuella schemat och objektet som bearbetas.
    • Konvertering visar antalet konverterade segment (till exempel "3 av 8 segment konverterade") och det aktuella segment som bearbetas.

  3. När exporten är klar väljer du Visa migreringsrapport för att öppna den genererade migreringsrapporten.

Granska migreringsuppgifter

Kortet Schemagranskning (steg 2) visar objekt som kräver manuell uppmärksamhet efter konverteringen. Med reglaget Grupperade / uppgifter längst upp i granskningsområdet kan du välja hur du vill arbeta dig igenom listan.

Grupperad vy

Grupperad-vyn organiserar granskningsuppgifter i utfällbara dragspelsgrupper per kategori. Använd den här vyn när du vill bearbeta relaterade problem tillsammans.

  1. På kortet Schemagranskning väljer du Granska för att expandera granskningsytan och väljer sedan Grupperad.

  2. Använd flikarna Väntar och Löst för att växla mellan aktiviteter som fortfarande behöver uppmärksamhet och uppgifter som du redan har godkänt.

  3. Expandera en grupp för att se dess metadata (scheman, objekttyper, kritiskhet) och de enskilda aktivitetskorten i den.

  4. Använd åtgärderna på gruppnivå för att bearbeta uppgifter i grupp:

    Åtgärd Beskrivning
    Kör alla Öppna alla väntande uppgifter i gruppen i Copilot Agentläge för AI-assisterad granskning.
    Lösa alla Markera alla aktiviteter i gruppen som lösta. En bekräftelsedialogruta visar gruppnamnet och antalet aktiviteter innan du fortsätter.
    Återställ alla Återställ alla lösta uppgifter i gruppen till statusen Väntande. Tillgänglig på fliken Löst .
    Visa i Uppgifter Växla till den platta vyn Uppgifter som filtrerats till den här gruppen.

  5. Om du vill agera på en enskild aktivitet i gruppen väljer du Kör uppgift för att öppna den i Copilot agentläge eller väljer Lös för att markera den som slutförd. Välj Återställ för en löst uppgift för att returnera den till väntande tillstånd.

Note

Lös alla och Återställ alla inaktiveras när en grupp innehåller fler än 800 uppgifter.

Uppgiftsvy

Uppgifter-vyn visar alla granskningsuppgifter i en enkel tabell. Använd den här vyn när du vill sortera, filtrera eller söka i alla aktiviteter oavsett grupp.

  1. Välj Uppgifter i växlaren.
  2. Använd listrutorna filter (Status, Kritiskhet, Objekttyp, Schema) för att begränsa uppgiftslistan.
  3. Välj Kör aktivitet på ett väntande objekt för att öppna det i Copilot agentläge för AI-assisterad granskning och korrigering.
  4. När du har åtgärdat ett objekt väljer du Lös för att markera det som slutfört.

Tip

Välj Visa loggar på instrumentpanelen för att granska extraherings- och konverteringsloggfiler för felsökning.

Migrera programkod

Efter schemamigrering konverterar du Oracle-specifik programkod (SQL-skript, lagrade procedurer, inläsningskontrollfiler, gränssnittsskript eller Java filer) till PostgreSQL-kompatibla motsvarigheter. Programmigrering är en funktion i förhandsversion.

Välj en migreringsmetod

Tillägget erbjuder två sökvägar för migrering av programkod:

  • Fullständig appmodernisering – Om GitHub-Copilot-appen moderniseringstillägg har installerats väljer du Migrera med appmodernisering för att fortsätta migreringen med kodningsanteckningar från schemakonverteringen. Välj Visa kodningsanteckningar för att granska den genererade vägledningen innan du fortsätter.
  • Alternativet endast databas — Om du bara ska konvertera databasrelaterad applikationskod i det här tillägget väljer du Migrera med PostgreSQL-tillägget.

Konvertera programkod i tillägget

  1. På kortet Programmigrering väljer du Migrera data (eller Välj metod om appmoderniseringstillägget identifieras).
  2. På sidan Konvertera program väljer du Välj Oracle-program att konvertera och väljer mappen som innehåller Oracle-programkod.
  3. Välj en PostgreSQL-anslutning och PostgreSQL-databas för konverteringskontext.
  4. Välj Läs in databaser om databaslistan är tom.
  5. Välj Konvertera program för att starta konverteringen.

Använda Copilot verktyg för programmigrering

Tillägget registrerar två Copilot språkmodellverktyg för migreringshjälp:

  • Oracle Client Code Application Converter (pgsql_migration_oracle_app) – Konverterar Oracle-klientprogramkod till PostgreSQL-motsvarigheter med hjälp av promptmallar och kodningsvägledning från schemamigreringsanalysen. Accepterar följande parametrar:

    • Programkodbasmapp (krävs) – Plats för koden som ska konverteras.
    • Platssökväg för kodningsanteckningar (valfritt) – Sökväg till kodning av anteckningar från schemamigreringen.
    • Postgres DB-namn (valfritt) – Namn på PostgreSQL-databasen för konverteringskontext.
    • Postgres DB-anslutning (valfritt) – Anslutningsnamn för PostgreSQL-databasen.

  • Visa Oracle till Postgres Migration Report (pgsql_migration_show_report) – Visar migreringsrapporten som genereras av schemakonverteringen. Kräver parametern Sökväg till rapportfil.

Mer information om hur du använder Copilot verktyg finns i Copilot integrering.

Jämföra konverterade filer

Efter konverteringen granskar du ändringarna sida vid sida med hjälp av de inbyggda diff-kommandona.

  1. I Utforskaren oracle högerklickar du på en konverterad SQL-fil under mappen eller postgres i migreringsprojektet och väljer Jämför DDL-migreringsfilpar.
  2. För konverterade programkodfiler (.sql, , .ctl.sh, .loadeller .java), högerklickar du på filen och väljer Jämför filpar för programmigrering.

Jämförelsevyn sida vid sida visar den ursprungliga Oracle-källan tillsammans med konverterade PostgreSQL-utdata, så att du kan identifiera eventuella artefakter som kräver manuell justering.

Note

DDL-filer måste följa strukturen folder/oracle|postgres/SCHEMA_NAME/DDL-TYPE/filename.sql för jämförelsekommandot för att hitta det matchande filparet.

Hantera migreringsprojekt

Använd vyn Migreringar (förhandsversion) i sidofältet för att hantera dina projekt:

Åtgärd Beskrivning
Öppet migreringsprojekt Öppna ett befintligt migreringsprojekt på instrumentpanelen.
Visa i Utforskaren Visa projektmappen i Utforskarvyn.
Delete Ta bort ett migreringsprojekt. Du uppmanas att bekräfta innan du tar bort den.
Uppdatera Ladda in listan över migreringsprojekt på den aktuella arbetsytan igen.

Relaterat innehåll

  • Last updated on