Zelfstudie: Oracle-naar-Azure Database voor PostgreSQL-schemaconversie

In deze zelfstudie wordt u begeleid bij het converteren van Oracle-databaseschema's naar Azure Database for PostgreSQL met behulp van de Visual Studio Code PostgreSQL-extensie met Microsoft Foundry om schemaomzetting te automatiseren en te valideren.

Het omvat het maken van verbinding met uw Oracle-bron en Azure Database for PostgreSQL doel, het configureren van Microsoft Foundry, het uitvoeren van de migratiewizard en het controleren van gegenereerde PostgreSQL-artefacten. Voordat u begint, moet u ervoor zorgen dat u netwerktoegang en referenties hebt voor zowel servers als een Microsoft Foundry-implementatie.

Dit is wat u kunt verwachten tijdens de conversie:

  • Schemadetectie: Het hulpprogramma analyseert uw Oracle-schemaobjecten.
  • AI-verwerking: Microsoft Foundry verwerkt en compatibele objecten converteert.
  • Validatie: Geconverteerde objecten worden gevalideerd in de scratchdatabase.
  • Taken controleren: objecten waarvoor handmatige aandacht is vereist, worden gemarkeerd.
  • Uitvoergeneratie: geconverteerde objecten worden opgeslagen als PostgreSQL-bestanden.

Prerequisites

In deze sectie worden de vereisten beschreven voor het gebruik van de functie oracle naar Azure Database for PostgreSQL-schemaconversie in Visual Studio Code voordat u een conversie start.

Systeemvereisten

Categorie Details
Visual Studio Code-versie 1.95.2 of hoger
GitHub Copilot-abonnement Pro+, Business, Enterprise

Ondersteuning van het besturingssysteem

Besturingssysteem Ondersteuningsdetails
Windows alleen x64-architectuur
Linux x64-architectuur
macOS macOS 13+

Vereisten voor doel Azure Database for PostgreSQL

Onderdeel Versievereiste
Azure Database for PostgreSQL PostgreSQL versie 15 of hoger
Scratch-database Azure-database voor PostgreSQL flexibele server

Vereisten voor AI-modellen

U hebt een van de volgende AI-onderdelen nodig die zijn geconfigureerd:

AI-onderdeel Modelversie
Microsoft Foundry GPT-5.2-implementatie

configuratie van Microsoft Foundry-implementatie

Maak in Microsoft Foundry een implementatie die gebruikmaakt van het gpt-5.2-model. De implementatienaam is de naam die u hebt gekozen bij het maken van de implementatie; deze hoeft niet overeen te komen met de modelnaam.

Het eindpunt is uw Microsoft Resource-URL van Foundry. Microsoft Foundry-resources verschillende equivalente hostnamen beschikbaar maken; een van de volgende indelingen is geldig:

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

Vervang {your-resource} door de resourcenaam van uw Microsoft Foundry (bijvoorbeeld oracletopg). Als u een inferentieroute rechtstreeks wilt aanroepen, is het huidige previewtraject /openai/responses?api-version=2025-04-01-preview.

Zie Endpoints voor Microsoft Foundry Models voor meer informatie over eindpuntindelingen en deductieroutes.

Tip

Als u Microsoft Foundry-verkeer wilt routeren via Azure API Management voor gecentraliseerd beheer, beperking en waarneembaarheid, configureert u een AI-gateway vóór uw Foundry-resource en gebruikt u de gateway-URL als het eindpunt. Zie AI Gateway configureren in uw Foundry-resources voor meer informatie.

Vereiste databasebevoegdheden

Voordat u de schemaconversie uitvoert, moet u ervoor zorgen dat de accounts die u gebruikt de minimale vereiste bevoegdheden hebben voor zowel de Oracle-brondatabase als de scratch-Azure Database for PostgreSQL flexibele server. Het Oracle-account heeft leestoegang nodig tot gegevens- en woordenlijstweergaven, zodat het hulpprogramma schema en code kan analyseren. Het Azure Database for PostgreSQL scratch-account moet schema's, tabellen en andere objecten kunnen maken voor validatie. Gebruik waar mogelijk een speciaal serviceaccount. Volg het principe van minimale bevoegdheden. Coördineer met uw DBA's om tijdelijke verhoogde rechten te verlenen en connectiviteit en toegang te valideren voordat u de conversie start.

Oracle-bronrechten

De volgende minimale bevoegdheden zijn vereist voor de Oracle-brondatabase:

Voorrecht Purpose
CONNECT Basisdatabaseverbinding
SELECT_CATALOG_ROLE Toegang tot gegevenswoordenlijstweergaven
EEN WOORDENLIJST SELECTEREN Systeemmetagegevens en woordenlijstobjecten lezen
SELECTEREN SYS.ARGUMENT$ Toegang tot informatie over procedure- en functieargumenten

Databasebevoegdheden scratchen

De volgende machtigingen zijn vereist op de Azure Database for PostgreSQL Flexible Server (scratch database):

Voorrecht Purpose
SCHEMA MAKEN Validatieschema's maken
CREËER OP DATABASE Databaseobjecten maken voor validatie
VERBINDING VERLENEN OP DATABASE Verbindingsmachtigingen voor validatieprocessen

Netwerkvereisten

  • Uitgaande connectiviteit: Microsoft Foundry-eindpunten.
  • Databaseverbinding: Zowel Oracle als bron en Azure Database for PostgreSQL Flexible Server als doel.
  • HTTPS-toegang: Visual Studio Code Extensions Marketplace en GitHub Copilot-services.
  • GitHub opslagplaatstoegang: https://github.com/microsoft/pgsql-tools/.

Oracle Instant Client (voor dikke clientmodus)

Het hulpprogramma voor schemaconversie maakt standaard verbinding met Oracle met behulp van de thin client-modus, waarvoor geen extra software is vereist. Als voor uw omgeving een dikke clientmodus is vereist, installeert u Oracle Instant Client op de computer waarop Visual Studio Code wordt uitgevoerd. Het hulpprogramma leest uw sqlnet.ora- en tnsnames.ora-configuratie en schakelt automatisch over naar de thick-clientmodus wanneer een instelling dit vereist.

U kunt bepalen of de dikke clientmodus vereist is door de Oracle-netwerkconfiguratiebestanden in uw bronomgeving te controleren. Zoek naar de volgende parameters in het sqlnet.ora bestand (meestal in $ORACLE_HOME/network/admin/):

Parameter Geeft aan dat de dikke modus is vereist
SQLNET.CRYPTO_CHECKSUM_CLIENT Instellen op REQUIRED of REQUESTED voor systeemeigen netwerkversleuteling
SQLNET.ENCRYPTION_CLIENT Instellen op REQUIRED of REQUESTED voor systeemeigen netwerkversleuteling

Microsoft Foundry-authenticatie

Configureer een van de volgende verificatiemethoden voor Microsoft Foundry:

Verificatiemethode Requirements
API-sleutel Microsoft Foundry-eindpunt-URL en API-sleutel.
Microsoft Entra ID Aangemeld bij de Azure-accountextensie, rol Foundry User (voorheen Azure AI User) toegewezen aan de Microsoft Foundry-resource.

Migratieproces

In deze sectie wordt de volledige migratiewerkstroom beschreven. U installeert de PostgreSQL-extensie, maakt en test verbindingen met uw Oracle-bron en Azure Database for PostgreSQL doel, opent en initialiseert een migratieproject, configureert Microsoft Foundry voor schemavertaling, voert u de migratiewizard uit om schema's te detecteren en te converteren, geconverteerde objecten in een scratchdatabase te valideren en eventuele gemarkeerde items te controleren of op te lossen voordat u de wizard Migratie toepast gegenereerde PostgreSQL-artefacten naar uw doel.

Stap 1: De PostgreSQL Visual Studio Code-extensie installeren

  1. Open Visual Studio Code.

  2. Ga naar de weergave Extensies (Ctrl+Shift+X).

  3. Zoek naar PostgreSQL en installeer de extensie PostgreSQL die is gepubliceerd door Microsoft.

    1. Marketplace downloaden

    Scherm van het installeren van de PostgreSQL-extensie in Visual Studio Code.

Stap 2: Een Azure Database for PostgreSQL-verbinding maken

  1. Maak in het PostgreSQL-extensiepaneel een verbinding met uw Azure Database for PostgreSQL Flexibele server-instantie.

  2. Voer de verbindingsgegevens in (host, database, gebruikersnaam, wachtwoord).

  3. Test de verbinding en sla deze op.

    Schermopname van het toevoegen van nieuwe Azure Database for PostgreSQL connection.

Stap 3: Een nieuwe werkruimte openen

  1. Maak een nieuwe map op uw lokale computer voor het migratieproject.

  2. Open de map als een nieuwe werkruimte in Visual Studio Code.

    Scherm van het toevoegen van een nieuwe werkruimte in Visual Studio Code.

Stap 4: Een migratieproject initialiseren

  1. Open de PostgreSQL-extensie.

  2. Ga naar het deelvenster Migraties (preview).

  3. Selecteer Migratieproject maken.

    Schermopname van het maken van een nieuw migratieproject.

Stap 5: Projectinstellingen configureren

  1. Voer in de wizard Migratie de naam van uw project in.

  2. Selecteer Volgende om door te gaan.

    Schermopname van projectnaam.

Stap 6: De Oracle-verbinding configureren

  1. Voer uw Oracle-verbindingsgegevens in:

    • Hostnaam of servernaam.
    • Poortnummer.
    • Database- of servicenaam.
    • Gebruikersnaam en wachtwoord.

    Het hulpprogramma selecteert de dunne of dikke clientmodus automatisch vanuit uw sqlnet.ora en tnsnames.ora instellingen. De gebruikersinterface maakt geen handmatige selector beschikbaar. Thin mode wordt standaard gebruikt. Als uw sqlnet.ora thick mode vereist, zorg er dan voor dat Oracle Instant Client is geïnstalleerd en dat de locatie ervan is opgenomen in de omgevingsvariabele PATH voordat u doorgaat. Zie Oracle Instant Client voor meer informatie.

  2. Kies Schema's laden. Het hulpprogramma test de Oracle-verbinding en vermeldt, indien geslaagd, alle door de gebruiker gedefinieerde schema's die beschikbaar zijn in Oracle.

  3. Selecteer een of meer schema's die u wilt converteren naar PostgreSQL.

  4. Selecteer Volgende om door te gaan.

    Schermopname van het configureren van een Oracle-server.

Stap 7: een Azure Database for PostgreSQL scratch-database configureren

  1. Selecteer de Azure Database for PostgreSQL-verbinding die u hebt gedefinieerd in de PostgreSQL-extensie.

  2. Selecteer de doeldatabase in de vervolgkeuzelijst.

  3. Selecteer Volgende om door te gaan.

    Schermopname van het configureren van een scratchdatabase.

Stap 8: het Microsoft Foundry-taalmodel configureren

  1. Voer de details van uw Microsoft Foundry in:

    • Eindpunt-URL.
    • Implementatienaam (de naam die u hebt toegewezen aan de implementatie in Microsoft Foundry; het onderliggende model moet gpt-5.2).

  2. Selecteer de verificatiemethode:

    • API-sleutel: Voer de API-sleutel in voor uw Microsoft Foundry-implementatie.
    • Microsoft Entra-id: meld u aan met de Azure-accountextensie. Het hulpprogramma verkrijgt automatisch het verificatietoken. Zorg ervoor dat de aangemelde identiteit de rol Foundry User (voorheen Azure AI User) heeft op de Microsoft Foundry-resource. Zie rolgebaseerde toegangscontrole voor Microsoft Foundry voor meer informatie.

  3. Selecteer Verbinding testen om de configuratie te controleren.

  4. Nadat de verbinding is voltooid, selecteert u Migratie maken Project.

    Schermopname van de configuratie van het taalmodel.

Stap 9: De schemaconversie uitvoeren

  1. Het systeem gaat naar de hoofdwizard voor migratie.

  2. Selecteer Migreren om het schemaconversieproces te starten.

  3. Bewaak de voortgang van de conversie in de Visual Studio Code-interface.

    Schermopname van de voortgang van de migratiestap.

Stap 10: Het schemaconversierapport bekijken

  1. Nadat de schemaconversie is voltooid, genereert het hulpprogramma een schemaconversierapport.
  2. Controleer de objecten die zijn geconverteerd en de objecten die zijn overgeslagen.
  3. Het rapport geeft het succespercentage van de conversie weer.

Stap 11: Conversietaken controleren en verfijnen

  1. Nadat de schemaconversie is voltooid, maakt het hulpprogramma controletaken voor objecten die aandacht nodig hebben.
  2. Gebruik GitHub Copilot-agent-modus om de taken op te lossen of converteer de schema's handmatig naar PostgreSQL.
  3. Vergelijk de vorige en de zojuist geconverteerde schemaconversie-instructies.
  4. Zie voor meer informatie over taakprioriteiten, gegenereerde SQL-bestanden en uitvoermappen Taken en uitvoermappen bekijken voor schemaconversie van Oracle naar Azure Database for PostgreSQL.

Stap 12: Geconverteerde objecten valideren vóór de implementatie

  1. Valideer onafhankelijk alle geconverteerde objecten in een niet-productieomgeving.
  2. Controleer of afhankelijkheden, beperkingen en representatieve workloads werken zoals verwacht.
  3. Bekijk de oplossingen voor alle controletaken en test opnieuw na wijzigingen.

Important

Verantwoordelijkheid voor klantvalidatie: dezelfde AI-engine die wordt gebruikt voor schemaconversie kan ook helpen bij validatie en beoordeling. AI-systemen kunnen af en toe hun eigen fouten bevestigen. Als u gegevensverlies, functionele regressies of beveiligingsproblemen wilt voorkomen, valideert u onafhankelijk alle geconverteerde objecten en oplossingen voor revisietaken voordat u implementeert in productie. Als onderdeel van uw besturingselementen kunt u het filteren van Microsoft Foundry-inhoud inschakelen om schadelijke of ongewenste uitvoer te verminderen. Zie Content-filtering voor Microsoft Foundry Models voor hulp.

Ga naar de PostgreSQL-extensie voor Visual Studio Code voor meer informatie over de Visual Studio Code-extensie.

Verwante inhoud

  • Last updated on