Migrace z Oracle do PostgreSQL

Rozšíření PostgreSQL pro Visual Studio Code poskytuje ucelený pracovní postup pro migraci databází Oracle do PostgreSQL. Průvodce vás provede připojením k vašemu zdroji Oracle, výběrem schémat, konfigurací modelu Microsoft Foundry pro převod DDL s asistencí AI a výběrem pomocné databáze PostgreSQL pro ověření. Po vytvoření projektu řídicí panel sleduje extrakci, převod, export a kontrolu v jednom zobrazení.

Important

Pracovní postup migrace Oracle to PostgreSQL je k dispozici pouze v Visual Studio Code.

Spojení schématu a převodu aplikací

Rozšíření převede úlohu Oracle ve dvou průchodech. Nejprve se spustí převod schématu a vytvoří jazyk DDL (Data Definition Language) PostgreSQL pro vaše databázové objekty. Převod aplikace se spustí poté a aktualizuje kód, který tyto objekty volá.

Převod schématu

Převod schématu čte slovník dat Oracle pro vámi vybrané schémata, seskupí extrahované objekty do bloků uspořádaných závislostmi a převede každý blok dat pomocí vašeho nasazení Microsoft Foundry. Převedené objekty se kompilují proti pomocné databázi před jejich zápisem, takže DDL, který obdržíte, je ověřeno místo nejlepšího odhadu. Spuštění vytvoří:

  • Soubory PostgreSQL .sql na úrovni objektů uspořádané podle schématu Oracle a typu objektu.
  • Sestava převodu zaznamenává, které objekty byly převedeny, které byly přeskočeny, a celkovou úspěšnost.
  • Zkontrolujte úkoly pro objekty, které potřebují lidský úsudek, jako je záložní DDL nebo chování, které se liší mezi Oracle a PostgreSQL.
  • Poznámky k kódování, které popisují vzory Oracle nalezené ve schématu a jejich mapování na PostgreSQL.

Převod aplikace

Převod aplikace cílí na kód specifický pro Oracle, který obklopuje databázi: skripty SQL, volání uložených procedur, zavaděč řídicí soubory, skripty prostředí a Java soubory. Vezme kódovací poznámky z převodu schématu jako vstup, takže převedený kód aplikace se zařádkuje s názvy objektů, typy a konvence volání, které převod schématu skutečně vytvořil.

Kód aplikace související s databází uvnitř tohoto rozšíření můžete převést nebo předat práci do rozšíření aplikace Copilot modernizace GitHubu za účelem úplného předání modernizace.

Sekvencování dvou průchodů

Nejprve spusťte převod schématu. Převod aplikace závisí na kódovacích poznámkách a převedených názvech objektů, které generuje převod schématu, takže převod kódu aplikace před vyrovnáním schématu vytvoří kód, který cílí na objekty, které se mohou stále měnit. Pokud po změně oboru schématu nebo opravě zdrojového objektu znovu spustíte převod schématu, zkontrolujte kód aplikace znovu v aktualizovaných poznámkách ke kódování.

Prerequisites

Než začnete, ujistěte se, že máte:

  • Visual Studio Code je nainstalován.
  • Nainstalované rozšíření PostgreSQL .
  • Přístup ke zdrojové databázi Oracle s oprávněními ke čtení pro extrakci schématu
  • Flexibilní server Azure Database for PostgreSQL, který se použije jako pomocné ověřovací databáze. Převod schématu nepodporuje Azure HorizonDB jako pomocné databáze.
  • Prostředek Microsoft Foundry s nasazeným gpt-5.2 modelem. Potřebujete adresu URL koncového bodu a klíč rozhraní API nebo účet Microsoft Entra ID s přístupem.

Ověřte, že je povolená funkce migrace.

Nastavení pgsql.enableMigrations řídí zobrazení Migrace a všechny příkazy migrace. Toto nastavení je standardně zapnuté.

Pokud se na bočním panelu nezobrazuje zobrazení Migrace, otevřete Visual Studio Code nastavení (Ctrl+, v systému Windows/Linux, Cmd+, v systému macOS) a ověřte, že pgsql.enableMigrations je nastavená hodnota true.

Vytvoření projektu migrace

Projekt migrace má podobu čtyřkrokového průvodce, který před vytvořením pracovního prostoru projektu shromažďuje údaje o zdroji, cíli a konfiguraci AI.

Krok 1: nastavení Project

  1. Otevřete zobrazení Migrace na bočním panelu.

  2. Spusťte nový projekt jedním z těchto způsobů:

    • Pokud pracovní prostor ještě neobsahuje project migrace, vyberte v zobrazení možnost + Vytvořit migraci Project.
    • + Vyberte tlačítko na panelu nástrojů zobrazení.
    • V Průzkumníku klikněte pravým tlačítkem na složku pracovního prostoru a vyberte Otevřít Project migrace.

    Otevře se stránka Nový projekt migrace z Oracle do Azure Database for PostgreSQL, na které je uvedeno, co potřebujete:

    • Podrobnosti o připojení ke zdrojové databázi
    • Názvy schémat, která se mají převést
    • Adresa URL a klíč koncového bodu pro prostředek Microsoft Foundry
    • Název připojení pro existující instanci Azure Database for PostgreSQL

  3. Do pole Název Project zadejte název.

  4. Vyberte Další: Připojení Oracle.

Snímek obrazovky stránky nového migračního projektu s polem Název projektu.

Krok 2: Připojení k Oracle

Stránka Připojit k Oracle shromažďuje přihlašovací údaje ke zdrojové databázi Oracle a umožňuje načíst schémata.

  1. Vyplňte pole připojení Oracle:

    Pole Popis
    Název hostitele Oracle Název hostitele nebo IP adresa databázového serveru Oracle.
    Oracle Port Port naslouchání (výchozí: 1521).
    Oracle SID nebo název služby Oracle SID nebo název služby pro instanci databáze.
    Uživatelské jméno Oracle Uživatel databáze s přístupem pro čtení k objektům schématu.
    Heslo Oracle Heslo pro uživatele Oracle.

  2. Vyberte Načíst schémata pro připojení a načtení seznamu dostupných schémat.

  3. V rozevíracím seznamu Schémata vyberte jedno nebo více schémat, která chcete migrovat.

  4. Vyberte Další: Připojení PostgreSQL.

Krok 3: Vyberte pracovní databázi Azure Database for PostgreSQL

Na stránce Zvolit pracovní databázi Azure Database for PostgreSQL se vybírá instance služby PostgreSQL, kterou model AI používá k ověření převedených souborů DDL.

Note

Pro ověření použijte vyhrazenou pracovní databázi. Během procesu převodu může rozšíření spouštět převedené DDL na tuto databázi.

  1. V rozevíracím seznamu Připojení PostgreSQL vyberte existující profil připojení. Pokud připojení, které potřebujete, není uvedené, vyberte Aktualizovat profily a znovu načtěte dostupné profily nebo nejprve vytvořte nové připojení v zobrazení Připojení a identita .
  2. V rozevíracím seznamu Databáze PostgreSQL vyberte cílovou databázi. Pokud je seznam prázdný, vyberte Načíst databáze .
  3. Po výběru databáze rozšíření automaticky ověří, že jsou nainstalovaná doporučená rozšíření PostgreSQL. Můžete také vybrat Možnost Ověřit rozšíření a spustit kontrolu ručně. Pokud některá rozšíření chybí, zobrazí se na stránce pokyny k jejich zařazení do seznamu povolených a jejich instalaci.
  4. Vyberte Další: Konfigurace modelu Microsoft Foundry.

Krok 4: Konfigurace modelu Microsoft Foundry

Stránka Zvolit Microsoft Foundry Model konfiguruje nasazení Microsoft Foundry, které využívá schéma a převod kódu.

  1. Vyplňte pole jazykového modelu:

    Pole Popis
    Název modelu gpt-5.2.
    Koncový bod Microsoft Foundry Adresa URL koncového bodu prostředku Microsoft Foundry (například https://<resource>.openai.azure.com/).
    Metoda ověřování Zvolte klíč rozhraní API nebo id Microsoft Entra.
    klíč rozhraní API Microsoft Foundry Klíč rozhraní API pro prostředek Microsoft Foundry (zobrazený při metodě ověřování je klíč rozhraní API).
    účet Azure Účet Microsoft s přístupem k prostředku (zobrazuje se, když je Metoda ověřování nastavená na Microsoft Entra ID).
    Nájemce Microsoft Entra tenanta pro účet (zobrazuje se, když je metoda ověřováníMicrosoft Entra ID).
    Název nasazení Název nasazeného modelu v prostředku Microsoft Foundry

  2. Vyberte Test Microsoft Foundry Connection a ověřte připojení.

  3. Vyberte Vytvořit projekt migrace.

Tip

Microsoft Foundry doporučuje optimální výkon migrace 500 000 TPM (tokeny za minutu).

Spuštění migrace schématu

Po vytvoření projektu se otevře řídicí panel Oracle Migration . Na řídicím panelu se zobrazují karty Migrace schématu a Kontrola schématu spolu s rozbalovací sekcí Nastavení, která shrnuje konfiguraci vašeho projektu.

Extrakce a převod schémat

Karta Migrace schématu (krok 1) spouští extrakci, převod a export jako souvislý proces.

  1. Na kartě Migrace schématu vyberte Migrovat.

    Popisek tlačítka se aktualizuje s postupem procesu:

    Stav Popisek tlačítka
    Probíhá extrakce Extrahuje se ...
    Extrakce dokončená, čeká na převod Obnovení migrace
    Převod probíhá Převádění ...
    Všechny fáze jsou dokončeny. Migrace dokončena

  2. Sledujte průběh v rozbalené kartě:

    • Extrahování ukazuje počet extrahovaných objektů (například 15 z 42 extrahovaných objektů) a aktuální schéma a zpracovávaný objekt.
    • Převod ukazuje počet převedených bloků dat (například "3 z 8 převedených bloků") a aktuální blok dat, který se zpracovává.

  3. Po dokončení exportu vyberte Zobrazit sestavu migrace, čímž otevřete vygenerovanou sestavu migrace.

Kontrola úloh migrace

Karta Revize schématu (krok 2) zobrazuje položky, které po převodu vyžadují ruční pozornost. Přepínač seskupených / úkolů v horní části oblasti revizí umožňuje zvolit, jak seznam procházet.

Seskupené zobrazení

Seskupené zobrazení uspořádá úkoly do sbalitelných skupin accordionu podle kategorie. Toto zobrazení použijte, když chcete zpracovat související problémy společně.

  1. Na kartě Revize schématu vyberte Zkontrolovat a rozbalte plochu kontroly a pak vyberte Seskupené.

  2. Pomocí karet Čekající a Vyřešené můžete přepínat mezi úkoly, které stále vyžadují pozornost, a úkoly, které jste už schválili.

  3. Rozbalením skupiny zobrazíte jeho metadata (schémata, typy objektů, závažnost) a jednotlivé karty úloh v ní.

  4. Pomocí akcí na úrovni skupiny můžete hromadně zpracovávat úlohy:

    Činnost Popis
    Spustit vše Otevřete všechny nevyřízené úlohy ve skupině v režimu agenta Copilot pro kontrolu s pomocí AI.
    Vyřešit vše Označte všechny úkoly ve skupině jako vyřešené. V potvrzovací dialogovém okně se zobrazí název skupiny a počet úkolů, než budete pokračovat.
    Obnovit vše Vraťte všechny vyřešené úkoly ve skupině do čekajícího stavu. K dispozici na kartě Vyřešeno .
    Zobrazit v úkolech Přepněte na ploché zobrazení Úkoly filtrované podle této skupiny.

  5. Pokud chcete pracovat s jednou úlohou ve skupině, vyberte Spustit úlohu a otevřete ji v režimu agenta Copilot nebo vyberte Vyřešit a označte ji jako dokončenou. Výběrem možnosti Obnovit u vyřešené úlohy ji vrátíte do čekajícího stavu.

Note

Možnosti Vyřešit vše a Resetovat vše jsou zakázané, pokud skupina obsahuje více než 800 úkolů.

Zobrazení úkolů

Zobrazení Úkoly zobrazuje všechny úkoly kontroly v ploché tabulce. Toto zobrazení použijte, pokud chcete řadit, filtrovat nebo prohledávat všechny úkoly bez ohledu na skupinu.

  1. Vyberte Úkoly v přepínači.
  2. Pomocí rozevíracích seznamů filtru (Stav, Závažnost, Typ objektu, Schéma) seznam úkolů zúžíte.
  3. Výběrem možnosti Spustit úlohu u čekající položky ji otevřete v režimu agenta Copilot pro kontrolu a opravu AI.
  4. Po opravě položky vyberte Vyřešit a označte ji jako dokončenou.

Tip

Výběrem možnosti Zobrazit protokoly na řídicím panelu zkontrolujte soubory protokolů extrakce a převodu pro řešení potíží.

Migrace kódu aplikace

Po migraci schématu převeďte kód aplikace specifický pro Oracle (skripty SQL, uložené procedury, soubory řízení zavaděče, skripty prostředí nebo soubory Java) na ekvivalenty kompatibilní s PostgreSQL. Migrace aplikací je funkce ve verzi Preview.

Volba metody migrace

Rozšíření nabízí dvě cesty pro migraci kódu aplikace:

  • Úplná modernizace aplikací: Pokud nainstalujete rozšíření modernizace aplikace Copilot GitHubu, vyberte Možnost Migrovat pomocí modernizace aplikací a pokračujte v migraci pomocí poznámek kódu z převodu schématu. Než budete pokračovat, vyberte Zobrazit poznámky k kódování a projděte si vygenerované pokyny.
  • Možnost pouze databáze: Chcete-li v rámci tohoto rozšíření převést pouze kód aplikace související s databází, vyberte možnost Migrovat pomocí rozšíření PostgreSQL.

Převod kódu aplikace v rámci rozšíření

  1. Na kartě Migrace aplikace vyberte Migrovat data (nebo Vyberte metodu , pokud se zjistí rozšíření modernizace aplikace).
  2. Na stránce Převést aplikaci vyberte Vybrat aplikaci Oracle a převést a zvolte složku, která obsahuje kód aplikace Oracle.
  3. Vyberte připojení PostgreSQL a databázi PostgreSQL pro kontext převodu.
  4. Pokud je seznam databází prázdný, vyberte Načíst databáze .
  5. Vyberte Převést aplikaci a spusťte převod.

Použití nástrojů Copilot pro migraci aplikací

Rozšíření zaregistruje dva nástroje jazykového modelu Copilot pro pomoc s migrací:

  • Převaděč aplikací klientského kódu Oracle (pgsql_migration_oracle_app): Převede kód klientské aplikace Oracle na ekvivalenty PostgreSQL pomocí šablon výzvy a pokynů pro kódování z analýzy migrace schématu. Přijímá následující parametry:

    • Složka základu kódu aplikace (povinné): Umístění kódu, který se má převést.
    • Cesta k umístění poznámek kódování (volitelné): Cesta k psaní poznámek z migrace schématu
    • Postgres DB Name (volitelné): Název databáze PostgreSQL pro kontext převodu.
    • Připojení k databázi Postgres (volitelné): Název připojení pro databázi PostgreSQL.

  • Show Oracle to Postgres Migration Report (pgsql_migration_show_report): Zobrazí sestavu migrace vygenerovanou převodem schématu. Vyžaduje cestu k parametru Soubor sestavy .

Další informace o používání nástrojů Copilot najdete v tématu Copilot integrace.

Porovnání převedených souborů

Po konverzi zkontrolujte změny vedle sebe pomocí vestavěných příkazů diff.

  1. V Průzkumníku klikněte pravým tlačítkem myši na konvertovaný soubor SQL ve složce oracle nebo postgres v projektu migrace a vyberte Porovnat páry souborů migrace DDL.
  2. Pro převedené soubory kódu aplikace (.sql, .ctl, .sh, .load, nebo .java), klikněte pravým tlačítkem myši na soubor a vyberte Porovnat páry souborů migrace aplikace.

Porovnávací zobrazení vedle sebe zobrazuje původní zdroj Oracle spolu s převedeným výstupem PostgreSQL, takže můžete odhalit případné artefakty, které vyžadují ruční úpravu.

Note

Soubory DDL musí dodržovat strukturu folder/oracle|postgres/SCHEMA_NAME/DDL-TYPE/filename.sql příkazu compare, aby vyhledaly odpovídající dvojici souborů.

Správa projektů migrace

Ke správě projektů použijte zobrazení Migrace na bočním panelu:

Činnost Popis
Open Migration Project Otevřete existující projekt migrace na řídicím panelu.
Zobrazit v Průzkumníku Umožňuje zobrazit složku projektu v zobrazení Průzkumníka.
Vymazat Odebrat migrační projekt. Před odstraněním se zobrazí výzva k potvrzení.
Refresh Znovu načtěte seznam migračních projektů v aktuálním pracovním prostoru.

Související obsah

  • Last updated on