Wat is schemaconversie van Oracle naar Azure Database for PostgreSQL – flexibele server?

De functie voor schemaconversie van Oracle naar Azure Database for PostgreSQL in de Visual Studio Code PostgreSQL-extensie helpt u bij het converteren van uw bestaande Oracle-databaseschemaobjecten naar een met PostgreSQL compatibel schema. Deze functionaliteit is ontworpen voor relationele schema's en produceert een geconverteerd schema voor Azure Database for PostgreSQL flexibele server.

Het hulpprogramma biedt een gebruikersinterface op basis van een project voor het automatiseren van schemaconversie. Controleer het conversierapport en gebruik Conversie Objectverkenner om objectdefinities en conversienotities te controleren. GitHub Copilot kan helpen de uitvoer uit te leggen en objecten aan te passen die handmatig moeten worden gewijzigd.

Architectuur

Het schemaconversieproces omvat meerdere onderdelen die samenwerken:

• Brondatabase van Oracle: uw bestaande Oracle-database die het schema bevat dat moet worden geconverteerd.
• Visual Studio Code PostgreSQL-extensie: de primaire interface voor het beheren van het conversieproces.
• Azure Database for PostgreSQL flexibele server: host de scratchschema's die worden gebruikt voor validatie en testen.
• Microsoft Foundry: biedt de taalmodellen die ai-gestuurde schematransformatie mogelijk maken.
• Agents voor schemaconversie: AI-gestuurde agents die het geautomatiseerde conversieproces afhandelen.

Hoe werkt het?

Het schemaconversieproces maakt gebruik van een intelligente, multistage benadering die geautomatiseerde transformatie combineert met menselijk toezicht:

• Verbinding en detectie: het hulpprogramma maakt verbinding met uw Oracle-database en inventariseert objecten in de geselecteerde schema's. Bekijk het geplande extractiebereik, uitsluitingen, machtigingen en afhankelijkheden voordat u doorgaat.
• AI-aangedreven transformatie: Schemaconversieagenten gebruiken taalmodellen die worden gehost in Microsoft Foundry om Oracle-specifieke constructies te transformeren in postgreSQL-compatibele equivalenten. De AI houdt rekening met best practices voor context, relaties en platform.
• Scratch-databasevalidatie: het hulpprogramma probeert gegenereerde definities te compileren in de geselecteerde scratchdatabase en maakt gebruik van beschikbare statische controles om conversieproblemen te identificeren. Deze controles tonen geen equivalent gedrag van de toepassing aan.
• Objectcontrole: het HTML-rapport en de Verkenner voor conversieobjecten geven conversieresultaten, beschikbare definities en conversienotities weer. Controleer zowel geconverteerde als niet-geconverteerde objecten.
• Begeleide correctie: gebruik Vraag om de conversie van een object te begrijpen of Oplossen voor door Copilot ondersteunde bewerkingen. Compileer bewerkte definities handmatig in de database waarin het geconverteerde schema is geïmplementeerd.
• Implementatievoorbereiding: Het hulpprogramma genereert PostgreSQL-.sqlbestanden en installatie-instructies. Controleer de uitvoer en voer de installatiescripts afzonderlijk uit; het genereren van deze bestanden rolt ze niet uit naar uw doelomgeving.

De extensie installeren

De functie voor schemaconversie van Oracle naar PostgreSQL is ingebouwd in de PostgreSQL-extensie voor Visual Studio Code. U hoeft geen afzonderlijke extensie te installeren.

Installatiestappen

1. Open Extensions Marketplace: Selecteer in Visual Studio Code het pictogram Extensies in de activiteitenbalk aan de linkerkant of gebruik de sneltoets Ctrl+Shift+X (Windows/Linux) of Cmd+Shift+X (macOS).
2. Zoek naar de extensie: Voer PostgreSQL in het zoekvak extensies marketplace (of de extensie-id ms-ossdata.vscode-pgsql) in om de extensie te vinden.
3. Install the extension: Zoek in de zoekresultaten PostgreSQL gepubliceerd door Microsoft en selecteer Install. Er zijn verschillende PostgreSQL-extensies beschikbaar in Marketplace, dus controleer of de uitgever Microsoft is voordat u installeert.
4. Access-schemaconversie: Nadat de extensie is geïnstalleerd, wordt er een olifantpictogram weergegeven op de Visual Studio Code Activiteitenbalk. Selecteer het pictogram om de PostgreSQL-extensie te openen en toegang te krijgen tot de functie Schemaconversie.

Werkstroom voor schemaconversie

De workflow begint met verkenning, gevolgd door extractie en conversie. Het hulpprogramma valideert de gegenereerde PostgreSQL-definities in een tijdelijke database en u bekijkt de resultaten in Conversion Objectverkenner voordat u implementatiebestanden voorbereidt.

Ontdekking

Detecteren volgt op de Oracle-verbindings- en schemaselectie, vóór de configuratie van de PostgreSQL-scratchdatabase. Het controleert bronmachtigingen en inventariseert schemaobjecten zonder DDL te extraheren. De aantallen beschrijven de broninventaris en geplande extractie, niet conversieresultaten.

Controleer de ondersteunde en uitgesloten objecttypen, evenals schemaafhankelijkheden, voordat u de reikwijdte bevestigt. Afhankelijke schema's somt schema's op waarnaar wordt verwezen en die u niet hebt geselecteerd. Een schema dat in deze lijst wordt weergegeven, is geen bevestiging dat het in het conversiebereik is opgenomen.

Zie Discovery-resultaten controleren in de tutorial voor gedetailleerde stappen.

Extractie

De extractie leest de Oracle DDL en metagegevens voor de beoordeelde bronomvang. De geëxtraheerde definities vormen de invoer voor de conversie; een geslaagde extractie betekent niet dat een object is geconverteerd.

Conversion

Schemaconversieagenten gebruiken modellen in Microsoft Foundry om de geëxtraheerde Oracle-definities te vertalen naar PostgreSQL DDL en een compilatiepoging in de scratchdatabase te doen. Controleer zowel geconverteerde als niet-geconverteerde objecten in de Conversion Objectverkenner en controleer het gedrag afzonderlijk vóór implementatie.

Scratch-databank

Selecteer een lege database of een toegewezen, ongebruikte database op Azure Database for PostgreSQL flexible server voor conversievalidatie. Het hulpprogramma gebruikt schema's die overeenkomen met de Oracle-schema's die u selecteert; het isoleert geen bestaande objecten in schema's met een afzonderlijk voorvoegsel voor een tijdelijke naam.

De verbindingsgebruiker heeft toestemming nodig om verbinding te maken, schema's en validatieobjecten te maken en de overeenkomende schema's te verwijderen. Alleen CREATE op databaseniveau geeft geen toestemming om een schema te verwijderen dat eigendom is van een andere rol. Zie Vereiste PostgreSQL-bevoegdheden.

Compilatie- en statische controles kunnen syntaxis-, afhankelijkheids- en typefouten in deze omgeving identificeren. Ze testen geen productiegegevens, toepassingsgedrag of elk runtimepad.

Conversie-objectverkenner

Gebruik Conversion Objectverkenner om bron-naar-doeltoewijzingen te controleren, Oracle- en PostgreSQL-definities te vergelijken en conversienotities te lezen. Selecteer Vraag voor een uitleg over de conversie en afhankelijkheden van een object, of Fix voor door Copilot ondersteunde wijzigingen aan het PostgreSQL-bestand ervan. Compileer de bewerkte definitie handmatig in de doeldatabase waarin het geconverteerde schema is geïmplementeerd.

Zie Geconverteerde objecten controleren in Conversion Objectverkenner voor gedetailleerde stappen.

GitHub Copilot Agent-Modus

GitHub Copilot-agent-modus is een geïntegreerde Visual Studio Code-functie die begeleide prompts biedt waarmee u geconverteerde objecten kunt verfijnen en het geconverteerde schema kunt uitlijnen op uw toepassingsvereisten. Agentmodus biedt:

• Contextbewuste suggesties voor schemawijzigingen.
• Aanbevelingen voor best practices voor Azure Database voor PostgreSQL - Flexible Server.
• Codevoltooiing voor complexe transformaties.
• Integratie met uw bestaande ontwikkelwerkstroom.

Oracle-connectiviteitsmodi

Het hulpprogramma voor schemaconversie ondersteunt twee connectiviteitsmodi om verbinding te maken met uw Oracle-brondatabase: dun en dik. Als u het verschil begrijpt, kunt u de juiste modus voor uw omgeving kiezen.

Thin client-modus (standaard)

Thin mode maakt rechtstreeks verbinding met Oracle Database zonder extra Oracle-clientbibliotheken. Deze modus is de standaardinstelling en vereist geen extra instellingen.

• Vereist geen Oracle Instant Client-installatie.
• Ondersteunt Oracle Database 12.1 en hoger.
• Past bij de meeste scenario's voor schemaconversie.
• Maakt verbinding met behulp van standaard TCP/IP-netwerken.

Dikke clientmodus

De thick-modus maakt gebruik van Oracle Instant Client-bibliotheken om verbinding te maken met Oracle Database. Het hulpprogramma voor schemaconversie detecteert wanneer de dikke modus nodig is op basis van uw Oracle-netwerkconfiguratie en schakelt er automatisch naar over.

Wanneer de dikke clientmodus is 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/):

Als een van deze parameters is geconfigureerd in uw bron-Oracle-omgeving, is de dikke clientmodus vereist. Het hulpprogramma voor schemaconversie detecteert deze configuratie en schakelt automatisch over naar de dikke modus. Zorg ervoor dat Oracle Instant Client is geïnstalleerd op de computer waarop Visual Studio Code wordt uitgevoerd voordat u de conversie start.

Oracle Instant Client installeren

Als u de dikke clientmodus wilt gebruiken, installeert u Oracle Instant Client op de computer waarop Visual Studio Code en het hulpprogramma voor schemaconversie worden uitgevoerd. Zie de vereisten voor het besturingssysteem van de zelfstudie voor ondersteunde besturingssystemen.

1. Download het Oracle Instant Client Basic - of Basic Light-pakket voor uw besturingssysteem via Downloads van Oracle Instant Client. Kies een pakket dat compatibel is met uw besturingssysteem en de architectuur van de conversieomgeving.
2. Volg de installatie-instructies op de platformspecifieke downloadpagina om het pakket, de vereiste afhankelijkheden en de configuratie van het zoekpad van de bibliotheek te installeren.
3. Start Visual Studio Code opnieuw om de bijgewerkte omgevingsvariabelen op te halen.

Verificatie voor Microsoft Foundry

Het hulpprogramma voor schemaconversie ondersteunt twee verificatiemethoden voor het maken van verbinding met taalmodellen in Microsoft Foundry:

Verificatie via een API-sleutel

Api-sleutelverificatie maakt gebruik van een implementatiespecifieke sleutel om aanvragen te autoriseren. Deze methode is eenvoudig en geschikt voor ontwikkelings- en testscenario's.

Microsoft Entra ID-verificatie

Microsoft Entra ID verificatie biedt op tokens gebaseerde, identiteitsgestuurde toegang tot Microsoft Foundry zonder API-sleutels te beheren. Deze methode wordt aanbevolen voor productieomgevingen en organisaties met gecentraliseerd identiteitsbeheer.

Microsoft Entra ID-verificatie gebruiken:

1. Toewijzing van de vereiste rol: Zorg ervoor dat de aangemelde gebruiker of service-principal de rol Foundry User (voorheen Azure AI User) heeft op de Microsoft Foundry-resource die als host fungeert voor de implementatie van uw model. Wijs de rol toe in Azure Portal onder Toegangsbeheer (IAM). Zie rolgebaseerde toegangscontrole voor Microsoft Foundry voor meer informatie.
2. Aanmelden bij Azure in Visual Studio Code: Gebruik de opdracht Azure: Aanmelden vanuit het opdrachtenpalet (Ctrl+Shift+P) om u te verifiëren met uw Microsoft Entra ID-account.
3. Selecteer Entra ID-authenticatie: Selecteer in de configuratiestap voor taalmodellen van de Migration WizardMicrosoft Entra ID als authenticatiemethode in plaats van API-sleutel.
4. Provide the endpoint: Voer de URL van het eindpunt van Microsoft Foundry in. Het hulpprogramma verkrijgt het verificatietoken automatisch van uw aangemelde sessie.

Voor Microsoft Entra ID-authenticatie is de extensie Azure Account in Visual Studio Code vereist. De extensie moet zijn aangemeld met een identiteit met de juiste roltoewijzing voor de Microsoft Foundry-resource.

Beveiliging en netwerken

Wanneer u de functie voor schemaconversie gebruikt, moet u ervoor zorgen dat uw Visual Studio Code-omgeving veilig verbinding kan maken met zowel de Oracle-brondatabase als het flexibele Server-exemplaar van Azure Database for PostgreSQL dat u gebruikt als de scratchdatabase.

Microsoft raadt u aan verbinding te maken met uw Microsoft Foundry-resource met behulp van een privé-eindpunt. Zie Configure a private link for Microsoft Foundry voor meer informatie.

Zie Data, privacy en beveiliging voor Azure Directe modellen in Microsoft Foundry voor meer informatie over het beveiligen van uw Microsoft Foundry-verbindingen.

Waarom de functie voor schemaconversie gebruiken?

Schemaconversie vermindert handmatige inspanning door PostgreSQL-definities te genereren, deze in een scratchdatabase te controleren en resultaten op objectniveau en door AI ondersteunde beoordeling te bieden. U moet het gegenereerde schema nog steeds valideren op basis van de vereisten van uw toepassing vóór de implementatie.

• Automatische conversie: vermindert handmatige inspanning door automatisch compatibele schemaobjecten te converteren.
• AI-aangedreven transformatie: maakt gebruik van taalmodellen die worden gehost in Microsoft Foundry voor contextbewuste conversiebeslissingen.
• Scratch-databasecontroles: maakt gebruik van compilatie en beschikbare statische controles om conversieproblemen te identificeren.
• Integrated workflow: Werkt binnen de Visual Studio Code ontwikkelomgeving.
• Flexibele Oracle-connectiviteit: ondersteunt zowel thin als dikke clientmodi voor het maken van verbinding met Oracle-databases.
• Meerdere verificatieopties: Ondersteunt API-sleutelverificatie en Microsoft Entra ID-verificatie voor Microsoft Foundry.
• Revisie en verfijning: combineert conversienotities, bron-naar-doelvergelijking en Copilot-ondersteunde bewerkingen.
• Azure-optimalisatie: ontworpen voor Azure Database for PostgreSQL - Flexible Server.

Ondersteunde schemaobjecten

Het conversieprogramma ondersteunt een breed scala aan Oracle-schema- en codeobjecten, waaronder gegevensdefinitieelementen, onderdelen op schemaniveau en procedurele code. Hoewel u veel algemene objecten automatisch kunt converteren, moet u de toewijzing mogelijk handmatig controleren of aanpassen voor bepaalde Oracle-specifieke functies of eigen extensies. Zie de secties in dit artikel voor gedetailleerde lijsten met ondersteunde objecten en bekende beperkingen.

Hoe conversies worden geproduceerd

Microsoft Foundry-modellen vertalen geëxtraheerde Oracle DDL naar PostgreSQL-definities. Het hulpprogramma maakt gebruik van scratchdatabasecompilatie en beschikbare statische controles om problemen te identificeren en correcties te begeleiden.

Voor PL/pgSQL-routines plpgsql_check biedt u aanvullende statische controles van routineteksten. Deze controles kunnen problemen identificeren die met alleen het maken van routines niet worden opgemerkt. Zie Geconverteerde PL/pgSQL valideren met plpgsql_check voor meer informatie.

Een geconverteerde status is geen garantie voor een geslaagde compilatie, een volledige implementatie of gelijkwaardig runtimegedrag. Controleer objectdefinities en conversienotities in het HTML-rapport en de conversie-Objectverkenner, inclusief tijdelijke aanduidingen of afhankelijkheden die handmatig aandacht vereisen. Zie Beperkingen voor schemaconversie voor Oracle-specifieke hiaten.

Database-schema-objecten

Het conversieprogramma ondersteunt de volgende Oracle-databaseobjecten:

• Tabellen: Tabeldefinities, kolomspecificaties en beperkingen op tabelniveau.
• Beperkingen: primaire sleutels, refererende sleutels, unieke beperkingen en controlebeperkingen.
• Indexen: B-tree-indexen, unieke indexen en samengestelde indexen.
• Reeksen: Oracle-reeksobjecten voor het automatisch genereren van waarden.
• Triggers: Triggers op rij- en statementniveau.
• Weergaven: Standaarddatabaseweergaven.
• Gematerialiseerde weergaven: Oracle-gematerialiseerde weergaven en vernieuwingslogica.
• Schema's: objecten en organisatie op schemaniveau.
• Synoniemen: openbare en persoonlijke synoniemen (met beperkingen).

Oracle-codeobjecten

Het conversieprogramma ondersteunt de volgende Oracle-codeconstructies:

• Triggers: complexe triggerlogica en gebeurtenisafhandeling.
• Pakketten: packagespecificaties en pakketimplementaties van Oracle.
• Functies: door de gebruiker gedefinieerde functies met complexe logica.
• Opgeslagen procedures: opgeslagen Oracle-procedures en parameterafhandeling.
• Typen en verzamelingen: Oracle-objecttypen, TYPE BODY lidmethoden, VARRAYgeneste tabellen en SUBTYPE declaraties.

Pakketconversie

Oracle-pakketten hebben geen direct PostgreSQL-equivalent. De gegenereerde toewijzingen zijn afhankelijk van de brondefinities en u moet pakketleden en hun bellers controleren:

• Constanten: gegenereerde getterfuncties hebben de juiste waarde, het type en de volatiliteit nodig.
• Verzamelingen en cursors: toewijzingen kunnen matrices, domeinen of jsonbrefcursor. Controleer grenzen, indexering en verwachtingen van de aanroeper.
• Pakketstatus: gegenereerde helpers en sessie-instellingen vereisen validatie van initialisatie en status tussen aanroepen, transacties en sessies.
• Uitzonderingen: Controleer de toewijzing van Oracle-uitzonderingen en -foutcodes aan PostgreSQL-waarden SQLSTATE en exceptionhandlers.
• Alleen specificatiepakketten: uitvoer kan placeholderroutines bevatten die een fout genereren in plaats van de ontbrekende implementatie te implementeren.

Hiërarchische queries

Hiërarchische Oracle-query's kunnen worden vertegenwoordigd door algemene Tabelexpressies van PostgreSQL WITH RECURSIVE . Bekijk de gegenereerde verwerking van roots, parent-child-joins, diepte, paden, volgorde van sibling-knooppunten en cycli. Een recursieve query die wordt gecompileerd, stelt niet vast dat de resultaten overeenkomen met de oorspronkelijke Oracle-query.

Transactiebeheer

Conversie van routines die worden gebruikt PRAGMA AUTONOMOUS_TRANSACTION , kan afhankelijk zijn van een afzonderlijke verbinding via dblink. Controleer de gegenereerde functie of procedure, vereiste extensies en eventuele wijzigingen die nodig zijn in de aanroepers. Test transactiegrenzen, verbindings- en sessiecontext, commits, rollbacks en foutafhandeling. Stel niet dat compilatie het oorspronkelijke transactiegedrag of aanroepconventies behoudt.

Geconverteerde PL/pgSQL valideren met plpgsql_check

Bij het maken van een PL/pgSQL-routine worden niet alle instructies die kunnen worden uitgevoerd gevalideerd. Sommige ongeldige verwijzingen of typeverschillen komen alleen voor wanneer het relevante uitvoeringspad wordt uitgevoerd. De plpgsql_check extensie kan extra problemen detecteren door statische analyse van routine-lichamen.

Gebruik deze controles naast compilatie, niet als bewijs van equivalente bedrijfslogica of productiegereedheid. Controleer de gegenereerde definities en voer de functionele en gegevensvalidatie zelfstandig volledig uit.

Waar de controle wordt uitgevoerd

De controle wordt uitgevoerd op de scratchdatabase die u selecteert voor conversie. Het onderzoekt geconverteerde routines in die omgeving, niet productiegegevens of applicatieverkeer. plpgsql_check is een hulpmiddel voor validatie; bereid de runtime-extensies die de geconverteerde code vereist apart voor.

Wat gebeurt er als de extensie niet beschikbaar is

Zonder plpgsql_checkzijn er geen aanvullende bodycontroles beschikbaar. Een geslaagde compilatie of de status Converted betekent niet dat deze controles zijn uitgevoerd. Bevestig de beschikbaarheid van de extensie vóór conversie en controleer en test routines onafhankelijk, zelfs wanneer de extensie is geïnstalleerd.

Controle beschikbaar maken

Controleer de extensielijst voor uw PostgreSQL-versie, voeg plpgsql_check toe aan de toelatingslijst van de server en configureer de vereiste preload-bibliotheek. Start de server opnieuw op na het wijzigen van shared_preload_libraries, en bevestig vervolgens dat de extensie is geïnstalleerd in de geselecteerde scratch-database. Zie Vereiste extensies toestaan en installeren voor de volledige procedure.

Ondersteunde Oracle-versies

In deze sectie vindt u een overzicht van de versies van de database-engine die ondersteuning bieden voor automatische schemaconversie en worden overwegingen voor compatibiliteit gemarkeerd. Gebruik de vermelde ondersteunde Oracle- en PostgreSQL-releases voor de beste resultaten. Valideer conversies in een testomgeving zonder productie en gebruik de meest recente secundaire patch van elke ondersteunde primaire release. Als uw omgeving gebruikmaakt van een niet-ondersteunde versie of eigen Oracle-functies bevat, moet u mogelijk extra handmatige toewijzing uitvoeren of controleren vóór de implementatie.

De volgende Oracle-databaseversies ondersteunen schemaconversie:

• Oracle 21c
• Oracle 19c
• Oracle 18c
• Oracle 12.2
• Oracle 12.1

Feedback en ondersteuning

Voor bugs, functieaanvragen en problemen met betrekking tot de functie voor schemaconversie of de PostgreSQL-extensie, gebruikt u het ingebouwde feedbackhulpprogramma in Visual Studio Code. U kunt dit hulpprogramma op twee manieren openen:

Helpmenu

Ga naar Help>Probleem melden.

Opdrachtpalet

1. Open het opdrachtenpalet met Ctrl+Shift+P (Windows/Linux) of Cmd+Shift+P (macOS).
2. Voer de opdracht PGSQL: Rapportprobleem uit.

Wanneer u een probleem aanmaakt of feedback geeft, neemt u Schema Conversion: op als voorvoegsel in de titel. Met dit voorvoegsel kan het ontwikkelteam snel feedback over schemaconversie identificeren en prioriteren. Dit feedbackmechanisme helpt het ontwikkelingsteam de functie voor schemaconversie voortdurend te verbeteren en eventuele problemen aan te pakken die u tegenkomt tijdens uw migratieprojecten van Oracle naar Azure Database for PostgreSQL.

Verwante inhoud

• Best practices voor schemaconversie van Oracle naar Azure Database for PostgreSQL Flexible Server
• Geconverteerde objecten controleren in Conversion Objectverkenner
• Beperkingen voor schemaconversie van Oracle naar Azure Database for PostgreSQL flexibele server