Självstudie: schemakonvertering från Oracle till Azure Database for PostgreSQL – flexibel server

Den här självstudien vägleder dig genom att konvertera Oracle-databasscheman till Azure Database for PostgreSQL med hjälp av Visual Studio Code PostgreSQL-tillägget med Microsoft Foundry för att generera och granska PostgreSQL-definitioner.

Den omfattar att ansluta till Oracle-källan och målet Azure Database for PostgreSQL, att konfigurera Microsoft Foundry, att köra migreringsguiden och att granska de genererade PostgreSQL-artefakterna. Innan du börjar kontrollerar du att du har nätverksåtkomst och autentiseringsuppgifter för både servrar och en Microsoft Foundry-distribution.

Det här kan du förvänta dig under konverteringen:

• Schemaidentifiering: Verktyget analyserar dina Oracle-schemaobjekt.
• AI-bearbetning: Microsoft Foundry bearbetar och konverterar kompatibla objekt.
• Scratch-database-kontroller: Verktyget försöker kompilering och tillgängliga statiska kontroller. Funktions-, data- och programvalidering förblir separata.
• Objektgranskning: Använd Conversion Object Explorer för att inspektera resultat och förfina genererade PostgreSQL-definitioner.
• Utdatagenerering: Objekt som konverterats sparas som PostgreSQL-filer.

Förutsättningar

I det här avsnittet beskrivs kraven för att använda schemakonverteringsfunktionen Oracle till Azure Database for PostgreSQL i Visual Studio Code innan du påbörjar en konvertering.

Systemkrav

Stöd för operativsystem

Målkrav för Azure Database for PostgreSQL

Krav för AI-modell

Du behöver någon av följande AI-komponenter konfigurerade:

distributionskonfiguration för Microsoft Foundry

I Microsoft Foundry skapar du en distribution som använder modellen gpt-5.2. Distributionsnamnet är det du valde när du skapade distributionen. Den behöver inte matcha modellnamnet.

Slutpunkten är din resurs-URL för Microsoft Foundry. Microsoft Foundry-resurser exponerar flera motsvarande värdnamn. Något av följande format är giltigt:

• https://{your-resource}.services.ai.azure.com
• https://{your-resource}.openai.azure.com
• https://{your-resource}.cognitiveservices.azure.com

Ersätt {your-resource} med resursnamnet Microsoft Foundry (till exempel oracletopg). Om du behöver anropa en slutsatsdragningsväg direkt är /openai/responses?api-version=2025-04-01-previewden aktuella förhandsgranskningssökvägen .

Mer information om slutpunktsformat och slutsatsdragningsvägar finns i Endpoints för Microsoft Foundry Models.

Nödvändiga databasbehörigheter

Innan du kör schemakonvertering kontrollera åtkomsten till källmetadata och behörigheter för scratch-database med databasadministratörerna. Oracle-kontot behöver åtkomst till schemametadata och databasordboksvyer, inte applikationens raddata. PostgreSQL-kontot måste kunna ta bort och återskapa matchande scheman och skapa objekt för validering. Använd ett dedikerat konto där det är möjligt och följ principen om minsta behörighet.

Käll-Oracle-privilegier

Följande minimibehörigheter krävs för oracle-källdatabasen:

Behörigheter för scratch-databas

Ordna följande åtkomst på den valda scratch-databasen. Databasnivå CREATE ger inte behörighet att ta bort ett schema som ägs av en annan roll.

Nätverkskrav

• Utgående anslutning: Microsoft Foundry-slutpunkter.
• Databasanslutning: Både källdatabasen Oracle och måldatabasen Azure Database for PostgreSQL Flexible Server.
• HTTPS-åtkomst: Visual Studio Code Extensions Marketplace och GitHub Copilot-tjänster.
• GitHub lagringsplatsåtkomst: https://github.com/microsoft/pgsql-tools/.

Oracle Instant Client (för tjockt klientläge)

Verktyget för schemakonvertering ansluter till Oracle med tunt klientläge som standard, vilket inte kräver någon extra programvara. Om din miljö kräver tjockt klientläge installerar du Oracle Instant Client på den dator som kör Visual Studio Code. Verktyget läser din sqlnet.ora och tnsnames.ora konfigurationen och växlar automatiskt till tjockt läge när en inställning kräver det.

Du kan avgöra om tjockt klientläge krävs genom att kontrollera Oracle-nätverkskonfigurationsfilerna i källmiljön. Leta efter följande parametrar i sqlnet.ora filen (finns vanligtvis i $ORACLE_HOME/network/admin/):

Microsoft Foundry-autentisering

Konfigurera någon av följande autentiseringsmetoder för Microsoft Foundry:

Migreringsprocessen

Det här avsnittet går igenom konverteringsarbetsflödet. Du installerar tillägget, initierar ett projekt, ansluter till Oracle, granskar Discovery och konfigurerar scratch-databasen och Microsoft Foundry. Konverteringsförsök, kompilering och tillgängliga statiska kontroller i scratch-databasen. Sedan granskar och förfinar du utdata, distribuerar den till en separat icke-produktionsdatabas och verifierar den oberoende innan den tas i produktion.

Steg 1: Installera Tillägget PostgreSQL Visual Studio Code

1. Öppna Visual Studio Code.

2. Gå till vyn Tillägg (Ctrl+Shift+X).

3. Sök efter PostgreSQL och installera tillägget PostgreSQL publicerat av Microsoft.

   1. Marketplace-nedladdning

   

Steg 2: Skapa en Azure Database for PostgreSQL anslutning

1. I postgreSQL-tilläggspanelen skapar du en anslutning till din Azure Database for PostgreSQL flexibel server instans.

2. Ange anslutningsinformationen (värd, databas, användarnamn, lösenord).

3. Testa och spara anslutningen.

   

Steg 3: Öppna en ny arbetsyta

1. Skapa en ny mapp på den lokala datorn för migreringsprojektet.

2. Öppna mappen som en ny arbetsyta i Visual Studio Code.

   

Steg 4: Initiera ett migreringsprojekt

1. Öppna PostgreSQL-tillägget.

2. Gå till panelen Migreringar.

3. Välj Skapa migreringsprojekt.

   

Steg 5: Konfigurera projektinställningar

1. I migreringsguiden anger du projektnamnet.

2. Klicka på Nästa när du vill fortsätta.

   

Steg 6: Konfigurera Oracle-anslutningen

1. Ange information om Oracle-anslutningen:

   • Värd- eller servernamn.
   • Portnummer.
   • Databas- eller tjänstnamn.
   • Användarnamn och lösenord.

   Verktyget väljer tunt eller tjockt klientläge automatiskt från dina sqlnet.ora inställningar tnsnames.ora . Användargränssnittet exponerar inte en manuell väljare. Tunt läge används som standard. Om din sqlnet.ora kräver thick mode, se till att Oracle Instant Client är installerat och att dess sökväg finns i miljövariabeln PATH innan du fortsätter. Mer information finns i Oracle Instant Client.

2. Välj Läs in scheman. Verktyget testar Oracle-anslutningen och visar, om det lyckas, alla användardefinierade scheman som är tillgängliga i Oracle.

3. Välj ett eller flera scheman för att konvertera till PostgreSQL.

4. Välj Nästa: Discovery.

   

Steg 7: Granska Discovery-resultat

Upptäckt visar källinventeringen och det planerade extraktionsomfånget. Ingen DDL extraheras i det här skedet. En förklaring av sammanfattningsantalet och omfånget finns i Discovery i översikten över schemakonvertering.

1. Vänta tills Discovery är klar.

2. Under Källbehörigheter granskar du varje kontroll, dess syfte och dess resultat. Granska misslyckade kontroller med din Oracle-databasadministratör. När du har löst behörighetsproblem väljer du Uppdatera Discovery och granskar de uppdaterade resultaten. De behörigheter som krävs finns i Oracle-källbehörigheter.

3. Granska sammanfattningsantalet Identifierade, Som ska extraheras, Exkluderade och Ogiltiga objekt.

4. Expandera Objekttyper som stöds för att granska antalet objekt som ska extraheras, Exkluderade och Ogiltiga objekt efter typ. En typ som stöds kan fortfarande ha undantagna objekt. dessa antal är inte konverteringsresultat.

5. Expandera Objekttyper som inte stöds för att granska kategorier som inte stöds i källan. För supportinformation och PostgreSQL-alternativ, se Begränsningar för schemakonvertering.

6. Under Beroende scheman granskar du refererade scheman som du inte valde. Välj Visa diagram för att visa referenserna. Siffrorna på kopplingarna representerar beroendereferenser, inte antalet objekt som ska extraheras eller konverteras.

7. Granska det separata meddelandet om refererade Oracle-systemscheman som inte migreras. Behandla inte dessa referenser som ytterligare applikationsscheman som valts för konvertering.

8. Om du behöver ändra schemavalet väljer du Föregående för att återgå till Anslut till Oracle, uppdatera Scheman och välj Nästa: Identifiering igen. Granska den uppdaterade omfattningen innan du fortsätter.

9. Välj Jag har granskat objekten, undantag och beroende scheman.

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

    

Steg 8: Konfigurera en Azure Database for PostgreSQL scratch-databas

Använd en tom eller dedikerad, oanvänd scratch-databas utan objekt eller data som du behöver bevara. Vägledning om förberedelser finns i Förbered scratch-databasen.

1. Välj den Azure Database for PostgreSQL anslutning som du definierade i PostgreSQL-tillägget.

2. Välj måldatabasen i listrutan.

3. Välj Verifiera tillägg. Om varningen Rekommenderade tillägg inte är installerad visas granskar du de tillägg som saknas. Följ vägledningen för förberedelse av scratch-database för att lägga till de tillägg som behövs i listan över tillåtna för servern och installera dem i den valda databasen och välj sedan Verifiera tillägg igen. Du kan fortsätta med varningen, men objekt som är beroende av saknade tillägg kan kräva manuella ändringar.

   

4. Markera kryssrutan som bekräftar att scratch-scheman som matchar de valda Oracle-schemana tas bort och återskapas under konverteringen och tar bort befintliga objekt och data.

5. Välj Nästa: Microsoft Foundry-modellkonfiguration.

Steg 9: Konfigurera språkmodellen Microsoft Foundry

I Microsoft Foundry allokerar du en distributionskvot för en distribution som är större än 1 000 000 token per minut (TPM). Följande distributionsexempel har konfigurerats för 2,3 miljoner TPM; den tillgängliga kvoten som visas är specifik för den miljön.

Gå tillbaka till migreringsguiden i Visual Studio Code för att konfigurera modellanslutningen:

1. Ange din Microsoft Foundry-information:
   • Slutpunkts-URL.
   • Distributionsnamn (det namn som du tilldelade distributionen i Microsoft Foundry; den underliggande modellen måste vara gpt-5.2).
2. Välj autentiseringsmetod:
   • API-nyckel: Ange API-nyckeln för din Microsoft Foundry-distribution.
   • Microsoft Entra-ID: Logga in med Azure-kontotillägget. Verktyget hämtar autentiseringstoken automatiskt. Kontrollera att den inloggade identiteten har rollen Foundry User (tidigare Azure AI User) på resursen Microsoft Foundry. Mer information finns i Rollbaserad åtkomstkontroll för Microsoft Foundry.
3. Välj Testa Microsoft Foundry-anslutning för att verifiera konfigurationen.
4. När anslutningen har upprättats väljer du Skapa migreringsprojekt.

Steg 10: Kör schemakonverteringen

1. Systemet navigerar till huvudguiden för migrering.

2. Välj Migrera för att starta schemakonverteringsprocessen.

3. Övervaka konverteringsstatusen i Visual Studio Code-gränssnittet.

4. När konverteringen är klar visar projektet att schemakonverteringen är klar och åtgärden Granska konverteringssammanfattning .

   

Steg 11: Granska schemakonverteringsrapporten

1. När schemakonverteringen är klar öppnas HTML-konverteringsrapporten automatiskt.
2. Granska upptäckts-, extraherings- och konverteringsresultaten och anteckningar på objektnivå.
3. Vägledning om hur du tolkar rapporten finns i Visa HTML-rapporten för Oracle-schemakonvertering.

Steg 12: Granska och förfina konverterade objekt

1. I det slutförda migreringsprojektet väljer du Granska konverteringssammanfattning.

   

2. På sidan Konverteringssammanfattning väljer du Utforskaren för konverteringsobjekt.

   

3. Välj ett objekt för att jämföra dess Oracle- och PostgreSQL-definitioner och läsa dess konverteringsanteckningar.

   

4. Använd Fråga för att förklara konverteringen och dess beroenden, eller Åtgärda för att öppna en Copilot-prompt och göra ändringar i PostgreSQL-filen.

5. Granska redigeringarna och bekräfta att driftsättnings-SQL innehåller de korrigeringar som du tänker distribuera. Anta inte att redigering av en fil per objekt uppdaterar den genererade deploy.sql.

Information om filtrering, jämförelse och manuell kompilering finns i Granska konverterade objekt i Konvertering Object Explorer.

Steg 13: Förbereda driftsättningen med Setup Experience

Konverteringsarbetsflödet genererar automatiskt installationsfiler när det är klart. När du öppnar installationsanvisningarna startas ingen driftsättning.

1. I det slutförda migreringsprojektet väljer du Granska konverteringssammanfattning.
2. På sidan Konverteringssammanfattning väljer du Installationsinstruktioner. Den här åtgärden blir tillgänglig när installationsfilerna är klara.
3. Granska den genererade setup_instructions.md filen som öppnas i redigeraren. Visual Studio Code visar även installationsmappen i Explorer.
4. Följ Distribuera konverterade scheman med installationsmiljön för att förbereda en separat icke-produktionsdestinationsdatabas, köra beredskapskontroller, distribuera de konverterade schemana och granska distributionsresultaten.

Steg 14: Verifiera det distribuerade schemat före produktionsanvändning

Använd den icke-produktionsdatabas som distribuerades i föregående steg för funktions-, data- och programverifiering, inte konverteringsdatabasen.

Om du ändrar ett objekt efter distributionen måste du tillämpa korrigeringen manuellt:

1. Anslut SQL-redigeraren till postgreSQL-servern som inte är produktion och databasen där det konverterade schemat distribueras. Bekräfta redigerarens aktiva databas.
2. Granska schemareferenser och välj den fullständiga instruktion eller de instruktioner som du tänker köra.
3. Välj Spela upp-knappen för att endast köra de valda instruktionerna. Granska körningsutdata och lös fel innan du fortsätter.
4. Bekräfta att objektfilerna och distributions-SQL:et innehåller de testade korrigeringarna före produktionsdistributionen. Att uppdatera en fil, uppdatera ett distribuerat objekt och uppdatera deploy.sql är separata åtgärder.

Verifiera det driftsatta schemat oberoende med representativa testdata och applikationsarbetsbelastningar. Kontrollera beroenden, begränsningar, affärslogik och resultatuppsättningar mot Oracle-källan och testa igen efter korrigeringar. Granska alla objekt som inte har konverterats eller distribuerats, i stället för att bara testa lyckade konverteringar.

Mer information om tillägget Visual Studio Code finns i PostgreSQL-tillägget för Visual Studio Code och Cursor.

Relaterat innehåll

• Vad är schemakonvertering från Oracle till Azure Database for PostgreSQL – flexibel server?
• Granska konverterade objekt i Conversion Object Explorer
• Distribuera konverterade scheman med Setup Experience
• Begränsningar för schemakonvertering från Oracle till Azure Database for PostgreSQL flexibel server