Oracle–PostgreSQL migrálás

Az Visual Studio Code PostgreSQL-bővítménye egy végpontok közötti munkafolyamatot biztosít az Oracle-adatbázisok PostgreSQL-be való migrálásához. Egy irányított varázsló végigvezeti az Oracle-forráshoz való csatlakozáson, a sémák kiválasztásán, egy Microsoft Foundry-modell konfigurálásán az AI által támogatott DDL-konverzióhoz, valamint egy PostgreSQL-adatbázis kiválasztásán az ellenőrzéshez. A projekt létrehozása után az irányítópult egyetlen nézetben követi nyomon a kinyerési, konvertálási, exportálási és felülvizsgálati elemet.

Important

Az Oracle–PostgreSQL migrálási munkafolyamat csak Visual Studio Code érhető el.

Prerequisites

Mielőtt hozzákezdene, győződjön meg arról, hogy:

  • Visual Studio Code telepítve.
  • A PostgreSQL-bővítmény telepítve van.
  • Hozzáférés oracle-forrásadatbázishoz olvasási engedélyekkel a séma kinyeréséhez.
  • Egy PostgreSQL-példány, amely egy új ellenőrzési adatbázisként (például Azure Database for PostgreSQL rugalmas kiszolgálóként) használható.
  • Egy Microsoft Foundry-erőforrás telepített gpt-5.2 modellel. A végpont URL-címére és egy API-kulcsra vagy egy Microsoft Entra ID-fiókra van szüksége hozzáféréssel.

Ellenőrizze, hogy engedélyezve van-e a migrálási funkció

A pgsql.enableMigrations beállítás szabályozza a Migrálások (előzetes verzió) nézetet és az összes migrálási parancsot. Ez a beállítás alapértelmezés szerint engedélyezve van.

Ha a Migrálások (előzetes verzió) nézet nem jelenik meg az oldalsávon, ellenőrizze a beállítást:

  1. Nyissa meg a VS Code beállításait (Ctrl+, Windows/Linux, Cmd+, macOS rendszeren).
  2. Keressen a pgsql.enableMigrations kifejezésre.
  3. Győződjön meg arról, hogy az érték true.

Migrálási projekt létrehozása

A migrálási projekt egy négylépéses varázsló, amely összegyűjti a forrás, a cél és az AI konfigurációját a projekt-munkaterület létrehozása előtt.

1. lépés: Project beállítás

  1. Nyissa meg a Migrálások (előzetes verzió) nézetet az oldalsávon.

  2. Jelölje ki a + gombot a nézet eszköztárán, vagy kattintson a jobb gombbal egy munkaterületmappára az Explorerben, és válassza a Migrálás létrehozása Project lehetőséget.

    Megnyílik a Migrálási projekt új Oracle-Azure Database for PostgreSQL lapja, amely felsorolja a szükséges elemet:

    • A forrásadatbázis kapcsolati adatai
    • Az átalakítandó séma(ok) neve
    • Végpont URL-címe és kulcsa egy Microsoft Foundry-erőforráshoz
    • Meglévő PostgreSQL-példány kapcsolatneve

  3. Adjon meg egy nevet a Project Név mezőben.

  4. Válassza a Következő: Oracle-kapcsolat lehetőséget.

Képernyőkép az új áttelepítési project lapról Project Név mezővel.

2. lépés: Csatlakozás az Oracle-hez

A Csatlakozás az Oracle-hez lap összegyűjti az Oracle-forrásadatbázis hitelesítő adatait, és lehetővé teszi a sémák betöltését.

  1. Töltse ki az Oracle kapcsolatmezőit:

    Field Description
    Oracle Hostname Az Oracle-adatbáziskiszolgáló állomásneve vagy IP-címe.
    Oracle-port Figyelőport (alapértelmezett: 1521).
    Oracle SID vagy szolgáltatásnév Az adatbázispéldány Oracle SID- vagy szolgáltatásneve.
    Oracle felhasználónév A sémaobjektumokhoz olvasási hozzáféréssel rendelkező adatbázis-felhasználó.
    Oracle-jelszó Az Oracle-felhasználó jelszava.

  2. Válassza a Sémák betöltése lehetőséget a csatlakozáshoz és az elérhető sémák listájának lekéréséhez.

  3. A Sémák legördülő listában válasszon ki egy vagy több áttelepítendő sémát.

  4. Válassza a Tovább: PostgreSQL-kapcsolat lehetőséget.

3. lépés: Azure Database for PostgreSQL ideiglenes adatbázis kiválasztása

A Select a Azure Database for PostgreSQL scratch database page kiválasztja azt a PostgreSQL-példányt, amelyet az AI-modell a konvertált DDL-fájlok ellenőrzésére használ.

Megjegyzés:

Az érvényesítéshez használjon külön erre a célra szolgáló adatbázist. A bővítmény a konvertálási folyamat során végrehajthatja a konvertált DDL-t ezen az adatbázison.

  1. A PostgreSQL-kapcsolat legördülő listájában válasszon ki egy meglévő kapcsolatprofilt. Ha a szükséges kapcsolat nem szerepel a listában, válassza a Profilok frissítése lehetőséget az elérhető profilok újratöltéséhez, vagy hozzon létre új kapcsolatot a Kapcsolatok és identitás nézetben.
  2. A PostgreSQL Database legördülő listájában válassza ki a céladatbázist. Ha a lista üres, válassza az Adatbázisok betöltése lehetőséget.
  3. Az adatbázis kiválasztása után a bővítmény automatikusan ellenőrzi, hogy telepítve vannak-e az ajánlott PostgreSQL-bővítmények. A bővítmények ellenőrzése lehetőség kiválasztásával manuálisan is futtathatja az ellenőrzést. Ha valamelyik bővítmény hiányzik, az oldal felsorolja őket, és útmutatást nyújt a Azure Database for PostgreSQL rugalmas kiszolgálódokumentációban való engedélyezéshez és telepítéshez.
  4. Válassza a Tovább: Microsoft Foundry modellkonfiguráció lehetőséget.

4. lépés: A Microsoft Öntödei modell konfigurálása

A Microsoft Foundry-modell kiválasztása oldal konfigurálja azt a Microsoft Foundry-telepítést, amely a séma- és kódkonverziót működteti.

  1. Töltse ki a nyelvi modell mezőit:

    Field Description
    Modell neve gpt-5.2.
    Microsoft Foundry-végpont Microsoft Foundry-erőforrásvégpont URL-címe (például https://<resource>.openai.azure.com/).
    Hitelesítési módszer Válassza az API-kulcsot vagy Microsoft Entra azonosítót.
    Microsoft Foundry API-kulcs API-kulcs a Microsoft Foundry-erőforráshoz (akkor jelenik meg, ha a Hitelesítési módszer értéke API-kulcs).
    Azure fiók Az erőforráshoz hozzáféréssel rendelkező Microsoft-fiók (akkor jelenik meg, ha a Hitelesítési módszer értéke Microsoft Entra Id).
    Bérlő A fiók Azure AD-bérlője (akkor jelenik meg, ha a Hitelesítési módszer értéke Microsoft Entra Id).
    Üzembe helyezés neve A Microsoft Foundry-erőforrásban üzembe helyezett modell neve.

  2. Válassza a Microsoft Foundry-kapcsolat tesztelése lehetőséget a kapcsolat ellenőrzéséhez.

  3. Válassza a Migrálási projekt létrehozása lehetőséget.

Tip

Microsoft Foundry 500 000 TPM-t (token per minute) javasol az optimális migrálási teljesítmény érdekében.

Sémamigráció futtatása

A projekt létrehozása után megnyílik az Oracle Migration irányítópultja. Az irányítópult megjeleníti a sémamigrálási és séma-felülvizsgálati kártyákat, valamint a projektkonfigurációt összegző Beállítások harmonikát.

Sémák kinyerés és konvertálása

A sémamigrálási kártya (1. lépés) folyamatos folyamatként futtatja a kinyerési, konvertálási és exportálási folyamatokat.

  1. A sémamigrálási kártyán válassza az Áttelepítés lehetőséget.

    A gombcímke a folyamat előrehaladtával frissül:

    Status Gombcímke
    Kinyerés folyamatban Kivonás...
    A kinyerés befejeződött, az átalakítás függőben van Migrálás folytatása
    A konvertálás fut Konvertálás...
    Minden fázis befejeződött Az áttelepítés befejeződött

  2. Kövesd nyomon az előrehaladást a kibővített kártyán:

    • A kinyerés a kinyert objektumok számát (például "15 a 42 kinyert objektumból") és az aktuális sémát és objektumot jeleníti meg.
    • Az átalakítás a konvertált adattömbök számát (például "3/8 konvertált adattömb") és a feldolgozandó aktuális adattömböket jeleníti meg.

  3. Az exportálás befejezése után válassza a Migrálási jelentés megtekintése lehetőséget a létrehozott migrálási jelentés megnyitásához.

Áttelepítési feladatok áttekintése

A séma-felülvizsgálati kártya (2. lépés) megjeleníti azokat az elemeket, amelyek manuális figyelmet igényelnek az átalakítás után. A véleményezési terület tetején található Csoportosított / feladatok kapcsolóval kiválaszthatja, hogyan dolgozhat a listában.

Csoportosított nézet

A Csoportosított nézet a felülvizsgálati feladatokat kategóriák szerint összecsukható harmonikacsoportokba rendezi. Ezt a nézetet akkor használja, ha együtt szeretné feldolgozni a kapcsolódó problémákat.

  1. A Séma áttekintése kártyán válassza a Véleményezés lehetőséget a felülvizsgálati felület kibontásához, majd válassza a Csoportosítás lehetőséget.

  2. A Függőben és a Megoldva lapokkal válthat a még figyelmet igénylő és a már jóváhagyott feladatok között.

  3. Bontsa ki a csoportot a metaadatok (sémák, objektumtípusok, kritikusság) és a benne lévő egyes feladatkártyák megtekintéséhez.

  4. A csoportszintű műveletek használatával tömegesen dolgozhatja fel a feladatokat:

    Action Description
    Az összes futtatása Nyissa meg a csoport összes függőben lévő feladatát Copilot Ügynök módban az AI által támogatott felülvizsgálathoz.
    Összes feloldása Jelölje meg a csoport összes feladatát megoldottként. A megerősítést kérő párbeszédpanelen a csoport neve és a tevékenységek száma látható a folytatás előtt.
    Összes alaphelyzetbe állítása Adja vissza a csoport összes megoldott feladatát a függőben lévő állapotba. A Feloldva lapon érhető el.
    Megtekintés a Feladatokban Váltson a csoportra szűrt, lapos Feladatok nézetre.

  5. A csoporton belüli egyetlen tevékenység végrehajtásához válassza a Feladat futtatása lehetőséget Copilot Ügynök módban való megnyitásához, vagy válassza a Feloldás lehetőséget a befejezettként való megjelöléséhez. Egy megoldott feladat függőben lévő állapotba való visszaállításához válassza a Visszaállítás lehetőséget.

Megjegyzés:

Ha egy csoport több mint 800 feladatot tartalmaz, az Összes feloldása és Összes alaphelyzetbe állítása le vannak tiltva.

Feladatok nézet

A Feladatok nézet az összes áttekintő tevékenységet megjeleníti egy táblázaton belül. Ezt a nézetet akkor használja, ha csoporttól függetlenül minden tevékenységet rendezni, szűrni vagy keresni szeretne.

  1. Válassza a választóban a Feladatok lehetőséget.
  2. A szűrő legördülő listájával (Állapot, Kritikusság, Objektumtípus, Séma) szűkítheti a feladatlistát.
  3. Egy függőben lévő elemnél válassza a Feladat futtatása lehetőséget, hogy azt a Copilot Agent Mode-ban nyissa meg MI-alapú ellenőrzéshez és javításhoz.
  4. Miután kijavított egy elemet, válassza a Feloldás lehetőséget a kész megjelöléséhez.

Tip

Válassza a Naplók megtekintése lehetőséget az irányítópulton a kinyerési és konvertálási naplófájlok hibaelhárítási vizsgálatához.

Alkalmazáskód migrálása

A séma áttelepítése után konvertálja az Oracle-specifikus alkalmazáskódot (SQL-szkriptek, tárolt eljárások, betöltővezérlőfájlok, rendszerhéjszkriptek vagy Java fájlok) PostgreSQL-kompatibilis megfelelőkké. Az alkalmazásmigrálás egy előzetes verziójú funkció.

Migrálási módszer kiválasztása

A bővítmény két elérési utat kínál az alkalmazáskód migrálásához:

  • Teljes alkalmazáskorszerűsítés – Ha telepítve van a GitHub Copilot alkalmazás modernizálási bővítmény, válassza az Áttelepítés alkalmazáskorszerűsítéssel lehetőséget a migrálás folytatásához a sémakonverzió kódolási megjegyzéseivel. Válassza a Kódolási jegyzetek megtekintése lehetőséget a létrehozott útmutató áttekintéséhez a folytatás előtt.
  • Csak adatbázissal kapcsolatos beállítás – Ha csak az adatbázissal kapcsolatos alkalmazáskódot szeretné konvertálni ezen a bővítményen belül, válassza a Migrálás a PostgreSQL-bővítmény használatával lehetőséget.

Alkalmazáskód konvertálása a bővítményen belül

  1. Az alkalmazásmigrálási kártyán válassza az Adatok migrálása lehetőséget (vagy válassza a metódust , ha az alkalmazás modernizálási bővítményét észleli).
  2. Az Alkalmazás konvertálása lapon válassza az Oracle-alkalmazás kiválasztása a konvertáláshoz lehetőséget, és válassza ki az Oracle-alkalmazáskódot tartalmazó mappát.
  3. Válassza ki a PostgreSQL-kapcsolatot és a PostgreSQL-adatbázist a konverziós környezethez.
  4. Ha az adatbázislista üres, válassza az Adatbázisok betöltése lehetőséget.
  5. Válassza az Alkalmazás konvertálása lehetőséget az átalakítás elindításához.

Copilot eszközök használata alkalmazásmigráláshoz

A bővítmény két Copilot nyelvi modelleszközt regisztrál a migrálási támogatáshoz:

  • Oracle-ügyfélkód-alkalmazáskonverter (pgsql_migration_oracle_app) – Az Oracle-ügyfélalkalmazás kódját PostgreSQL-ekvivalenssé alakítja a sémamigrálási elemzés parancssori sablonjaival és kódolási útmutatásával. A következő paramétereket fogadja el:

    • Application Codebase mappa (kötelező) – A konvertálni kívánt kód helye.
    • Kódolási jegyzetek helyének elérési útja (nem kötelező) – A séma migrálásából származó jegyzetek kódolásának elérési útja.
    • Postgres DB neve (nem kötelező) – A PostgreSQL-adatbázis neve konverziós környezethez.
    • Postgres DB-kapcsolat (nem kötelező) – A PostgreSQL-adatbázis kapcsolatneve.

  • Oracle to Postgres Migration Report (pgsql_migration_show_report) megjelenítése – Megjeleníti a sémaátalakítás által létrehozott áttelepítési jelentést. A jelentésfájl elérési útja paramétert igényel.

További információ az Copilot eszközök használatáról: Copilot integráció.

Konvertált fájlok összehasonlítása

Az átalakítás után tekintse át egymás mellett a módosításokat a beépített diff parancsokkal.

  1. Az Explorerben kattintson a jobb gombbal egy konvertált SQL-fájlra az áttelepítési oracle projekt vagy postgres mappa alatt, és válassza a DDL-áttelepítési fájlpárok összehasonlítása lehetőséget.
  2. Konvertált alkalmazáskódfájlok (.sql, , .ctl, .sh.loadvagy .java) esetén kattintson a jobb gombbal a fájlra, és válassza az Alkalmazásmigrálási fájlpárok összehasonlítása lehetőséget.

Az egymás melletti diff nézet az eredeti Oracle-forrást és az átalakított PostgreSQL-kimenetet jeleníti meg, így azonosíthatók a manuális módosítást igénylő összetevők.

Megjegyzés:

A DDL-fájloknak követnie kell az összehasonlítási parancs szerkezetét folder/oracle|postgres/SCHEMA_NAME/DDL-TYPE/filename.sql az egyező fájlpár megkereséséhez.

Migrálási projektek kezelése

A projektek kezeléséhez használja az oldalsáv Migrálások (előzetes verzió) nézetét:

Action Description
Migrációs projekt megnyitása Nyisson meg egy meglévő migrálási projektet az irányítópulton.
Megjelenítés az Explorerben A projektmappa megjelenítése Explorer nézetben.
Delete Migrálási projekt eltávolítása. A rendszer a törlés előtt megerősítést kér.
Felfrissít Töltse be újra az áttelepítési projektek listáját az aktuális munkaterületen.

Kapcsolódó tartalom

  • Last updated on