Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
Ez az oktatóanyag végigvezeti az Oracle-ügyfélalkalmazás kódjának Azure Database for PostgreSQL konvertálásán a Visual Studio Code PostgreSQL-bővítmény és GitHub Copilot Ügynök mód használatával a kódátalakítás automatizálásához és érvényesítéséhez.
Ez magában foglalja a környezet beállítását, az alkalmazás kódbázisának importálását, a konvertálási folyamat futtatását és a létrehozott PostgreSQL-kompatibilis kód áttekintését. Mielőtt hozzákezdene, győződjön meg arról, hogy elvégezte a sémakonvertálási projektet az optimális eredmények érdekében.
Az átalakítás során a következőkre számíthat:
- Környezet beállítása: GitHub Copilot ügynök üzemmód konfigurálása a megfelelő AI-modellel
- Codebase importálása: Az alkalmazáskód rendszerezése a migrálási projekt struktúrájában
- AI-feldolgozás: GitHub Copilot adatbázis-környezet használatával dolgozza fel és konvertálja az alkalmazáskódot
- TODO-feladat végrehajtása: Automatizált feladatlista létrehozása és rendszeres konvertálása
- Jelentéskészítés: Átfogó konverziós jelentés eredményekkel és javaslatokkal
- Fájl-összehasonlítás: Beépített diff eszközök az eredeti és a konvertált kód áttekintéséhez
Prerequisites
Ez a szakasz azokat az előfeltételeket ismerteti, amelyek az Oracle-ról az Azure Database for PostgreSQL-re történő alkalmazáskonvertáló funkció használatához szükségesek a Visual Studio Code-ban, a konvertálás megkezdése előtt.
Rendszerkövetelmények
| Követelmény | Specification |
|---|---|
| Visual Studio Code verzió | 1.95.2 vagy újabb |
| GitHub Copilot előfizetés | Pro+, Business, Enterprise |
Operációs rendszer támogatása
| Platform | Architecture |
|---|---|
| Windows | x64 és ARM64 |
| Linux | x64 és ARM64 |
| macOS | x64 (Intel) és ARM64 (Apple Silicon) |
Az AI-modell követelményei
Az alábbi AI-modellek egyikére van szükség GitHub Copilot Ügynök módban:
| Modell | Változat |
|---|---|
| Claude | Szonett 4.6 vagy Opus 4.6 vagy újabb |
Az alkalmazáskonvertálás megkezdése előtt állítsa a GitHub Copilot ügynök módú modelljét Claude Sonnet 4.6-os vagy Claude Opus 4.6-os vagy újabb verzióra az optimális kódátalakítási eredmények érdekében.
A PostgreSQL verziótámogatása
| Céladatbázis | Változat |
|---|---|
| Azure adatbázis a PostgreSQL rugalmas kiszolgálóhoz | A PostgreSQL 15-ös vagy újabb verziója |
| Azure HorizonDB | A PostgreSQL 17-es vagy újabb verziója |
Sémakonvertálási javaslat
Bár nem szükséges előre elvégezni az adatbázisséma-átalakítást, javasoljuk, hogy először végezze el a séma migrálását. Ha már konvertálta az Oracle-sémát PostgreSQL-re, az alkalmazáskonvertálási folyamat pontosabb kontextust és jobb minőségű kódátalakítást eredményez a következő műveletekkel:
- Kódolási megjegyzések: A sémakonvertálás során létrehozott metaadat-összetevők (lásd alább a Mi a kódolási jegyzetek? című témakört)
- Adatbázis-környezet: Közvetlen hozzáférés konvertált sémaobjektumokhoz
- Adattípus-leképezések: A típusátalakítások pontos ismerete
Egyéb előfeltételek
- Adatbázis-kapcsolat a Azure Database for PostgreSQL-példányhoz
- Hozzáférés Visual Studio Code bővítmény marketplace-hez és GitHub Copilot szolgáltatásokhoz
Mik azok a kódolási megjegyzések?
A kódolási jegyzetek a sémakonvertálási fázis során automatikusan létrehozott metaadat-összetevők. Rögzítik az Oracle-to-PostgreSQL-sémakonvertálás kulcsátalakítási adatait és megállapításait, amelyeket a folyamat később az alkalmazáskódok konvertálásának javítására használ.
A kódolási jegyzetek olyan információkat tartalmazhatnak, mint például:
- Adattípus-leképezések és szerkezeti változások
- Sorozatok, identitások és összetett típusok konvertálási részletei
- Dátum-/idő- vagy intervallum-implementációk módosítása
- Hivatkozási integritási korlátozásokkal rendelkező táblákra mutató hivatkozások
- Összetett Oracle-csomagok összegzése, beleértve az eljárást és a függvény-aláírásokat
- További AI-alapú tippek a kódfordítás pontosságának javításához
Az alkalmazáskonvertálás során az AI-modell ezeket a jegyzeteket környezetfüggő jelekként használja, hogy pontosabb és szemantikailag igazított PostgreSQL-kompatibilis kódot állítsunk elő.
Alkalmazáskonvertálási folyamat
Ez a szakasz végigvezeti a teljes alkalmazáskonvertálási munkafolyamaton: beállítja a környezetet, importálja a kódbázist, futtatja a konvertálást, áttekinti a létrehozott jelentést, és összehasonlítja a fájlmódosításokat.
1. lépés: A környezet beállítása
- Nyissa meg a Visual Studio Code-t a PostgreSQL bővítménnyel telepítve.
- Nyissa meg a GitHub Copilot csevegőfelületet.
- A modellhez válassza a Claude Sonnet 4.6 vagy a Claude Opus 4.6 lehetőséget.
A Claude Sonnet 4.6 vagy a Claude Opus 4.6 használata szükséges az optimális alkalmazáskonvertálási eredményekhez. Az alacsonyabb modellek kevésbé pontos átalakításokat eredményezhetnek.
2. lépés: A migrálási projekt megnyitása
Nyissa meg a sémakonvertálási projektet tartalmazó munkaterületet.
Lépjen a migrálási projekt mappastruktúrájához:
.github/postgres-migration/project_name/Ellenőrizze, hogy a projektstruktúra tartalmazza-e a sémaátalakításhoz szükséges mappákat és fájlokat.
3. lépés: A kódbázis másolása a migrálási projektbe
Keresse meg a
application_codemappát a projektben:.github/postgres-migration/project_name/application_code/Másolja a migrálni kívánt codebase mappát a projektmappán belüli
application_codemappába.A fájlok logikus rendszerezése a rendszeres átalakítás megkönnyítése érdekében.
Az eredeti alkalmazáskódot biztonsági mentésként külön helyen tárolhatja. Csak másolja a konvertálni kívánt fájlokat az áttelepítési projekt struktúrájába.
4. lépés: Az ügyfélkód migrálása
- A PostgreSQL-bővítmény áttelepítési paneljén válassza az Alkalmazás áttelepítése lehetőséget az alkalmazáskonvertálási varázsló elindításához.
- A megjelenő űrlapon válassza ki a munkaterület gyökerébe másolt mappát.
- Válassza ki az alkalmazás környezetét tartalmazó adatbázist:
- A PostgreSQL-adatbázis, ahol üzembe helyezte a konvertált DDL-t, vagy
- Az a PostgreSQL-adatbázis, amelyben az alkalmazásséma már létezik
- Válassza az Alkalmazás konvertálása lehetőséget.
Ez a művelet a következő folyamatokat indítja el:
- Egyéni összetett prompt és ügynök üzemmódú eszköz meghívása
- Létrehoz egy TODO-listát azokról a tevékenységekről, amelyeken az Ügynök mód folytatja a munkát
- Csatlakozik és beolvassa az adatbázist a továbbfejlesztett kontextus érdekében
- Alkalmazáskódfájlok szisztematikus konvertálása
5. lépés: A konvertálási folyamat figyelése
- Tekintse meg a GitHub Copilot ügynök üzemmód felületét, miközben a fájlokat dolgozza fel.
- Az ügynök szisztematikusan dolgozik a létrehozott TODO-listán.
- Tekintse át az ügynöktől érkező minden olyan ösztönzést vagy kérdést, amely választ igényelhet.
- Az eredmények áttekintése előtt engedélyezze a konvertálási folyamat teljes befejezését.
6. lépés: Továbbfejlesztett Java átalakítás GitHub Copilot alkalmazás modernizálási bővítményével (nem kötelező)
Ha Java kóddal dolgozik: A konvertálás megkezdése előtt a GitHub Copilot app modernizálási bővítmény telepítésével javíthatja a konvertálási folyamatot.
Automatikus tesztfordítás
A két VS Code-bővítmény kommunikál egymással a zökkenőmentes integráció érdekében. Java kód konvertálásakor az Alkalmazáskorszerűsítési bővítmény automatikusan elvégzi a konvertált kód tesztelési fordítását a folyamat korai szakaszában felmerülő szintaxishibák vagy fordítási problémák azonosítása érdekében.
Automatikus egységteszt-létrehozás
A konvertált kódbázis alapján az alkalmazás modernizálási bővítménye automatikusan létrehozza az egységteszteket annak ellenőrzéséhez, hogy a konvertált alkalmazás megfelelően működik-e. Ez az integráció az alkalmazáskorszerűsítési bővítmény képességeit használja a következő lehetőségekre:
- A konvertált Java osztályok és metódusok elemzése
- Megfelelő tesztesetek létrehozása kritikus kódútvonalakhoz
- A PostgreSQL-adatbázis kapcsolataival működő tesztszerelvények létrehozása
Az GitHub Copilot alkalmazás modernizálási bővítményének telepítése erősen ajánlott Java migrálási projektekhez, mivel jelentősen felgyorsítja az ellenőrzést, és automatizált fordítási ellenőrzésekkel és teszteléssel javítja az átalakítás minőségét.
7. lépés: Kódkonvertálási jelentés áttekintése
- Amikor az alkalmazáskonverzió ügynök módban fejeződik be, automatikusan létrehoz és megnyit egy átfogó jelentést.
- A jelentés részletes eredményeket és az átalakításhoz javasolt következő lépéseket tartalmazza.
A jelentésekkel kapcsolatos átfogó útmutatásért: Lásd az Oracle to Azure Database for PostgreSQL alkalmazáskonvertálás által létrehozott jelentéseket (előzetes verzió) részletes információkért a konvertálási eredmények értelmezéséről, a fájlállapotok megértéséről, és az érvényesítési stratégia tervezéséről.
8. lépés: Kódmódosítások összehasonlítása a fájldiff funkcióval
- Kattintson a jobb gombbal egy átalakított fájlra (például egy
.javafájlra), és válassza az App Migration File Pairs összehasonlítása lehetőséget. - Ez megnyitja az eredeti és a konvertált fájlok egymás melletti nézetét.
- Ezzel tesztelheti a kritikus átalakításokat.
Hatékony fájlösszehasonlítási stratégia: Tekintse meg az Oracle to Azure Database for PostgreSQL alkalmazáskonverzió által létrehozott jelentéseket (előzetes verzió) az útmutatásokért, amelyek segítenek az átnézendő fájlok rangsorolásában és az érvényesítési erőfeszítések összpontosításában.
9. lépés: Konvertált alkalmazáskód ellenőrzése
Alapvető ellenőrzési lépések:
- Nem gyártási tesztkörnyezet beállítása a konvertált PostgreSQL-sémával
- Adatbázis-kapcsolat tesztelése az új PostgreSQL-kapcsolati sztringekkel
- Kritikus üzleti munkafolyamatok végrehajtása az alkalmazás viselkedésének ellenőrzéséhez
- SQL-lekérdezés eredményeinek ellenőrzése az Oracle várt eredményeivel szemben
- A konvertálási jelentésben azonosított megjelölt területek kezelése
Important
Az AI-rendszerek időnként hibákat is elkövethetnek. A funkcionális regressziók, biztonsági problémák vagy adathozzáférési problémák megelőzése érdekében az éles környezetben való üzembe helyezés előtt függetlenül ellenőrizze az összes átalakított alkalmazáskódot.
Szisztematikus érvényesítési megközelítés: Használja a legjobb gyakorlatok keretrendszereit az Oracle-alkalmazás kódjának Azure Database for PostgreSQL (előzetes verzió) konvertálásához, hogy az Oracle-integráció összetettsége és a konverziós jelentés eredményei alapján priorizálja a tesztelést.
Átalakítás utáni lépések
Az alkalmazásátalakítás befejezése után:
- Egységtesztek futtatása: Hajtsa végre az alkalmazás tesztcsomagját a konvertált kódon.
- Integrációs tesztelés: Tesztelje az alkalmazást a PostgreSQL-adatbázissal.
- Teljesítménytesztelés: Ellenőrizze, hogy a lekérdezési teljesítmény megfelel-e a követelményeknek.
- Kód áttekintése: A csapattagok a pontosság érdekében tekintse át a konvertált kódot.
- Dokumentációfrissítés: Frissítse az Oracle-specifikus funkciókra hivatkozó dokumentációkat.
Átfogó érvényesítési stratégiák: Lásd A legjobb gyakorlatok az Oracle-alkalmazáskód Azure Database for PostgreSQL (előzetes verzió) átalakításához a részletes ellenőrzési keretrendszerek, tesztelési prioritások és csapatkoordinációs megközelítések megismeréséhez a konvertálás összetettsége alapján.
A Visual Studio Code bővítményről további információért keresse fel a PostgreSQL bővítménye a Visual Studio Code-hoz oldalt.
Kapcsolódó tartalom
- Az Oracle alkalmazások Azure Database for PostgreSQL-ra való konverziója (előzetes verzió) micsoda?
- Az Oracle-ből az Azure Database for PostgreSQL alkalmazás átalakítás által generált jelentések (előnézet)
Az Oracle-alkalmazáskód Azure Database for PostgreSQL (előzetes verzió) - Oracle az Azure Database for PostgreSQL alkalmazásra történő konvertálás korlátozásai (előzetes verzió)