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.

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
  • Instance PostgreSQL, která bude sloužit jako dočasná ověřovací databáze (například Azure Database for PostgreSQL – Flexible Server).
  • 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 ovládá zobrazení Migrations (Preview) a všechny příkazy pro migrace. Toto nastavení je standardně zapnuté.

Pokud se na bočním panelu nezobrazuje zobrazení Migrace (Preview), ověřte nastavení:

  1. Otevřete nastavení VS Code (Ctrl+, na Windows/Linuxu, Cmd+, v macOS).
  2. Vyhledejte pgsql.enableMigrations.
  3. Potvrďte, že hodnota je 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. Na bočním panelu otevřete zobrazení Migrace (Preview ).

  2. Klikněte na tlačítko + na panelu nástrojů zobrazení nebo klikněte pravým tlačítkem na složku pracovního prostoru v Průzkumníku a vyberte možnost Vytvořit projekt 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ázev 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 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 se nainstalují 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í, stránka je vypíše a poskytne pokyny k jejich přidání na seznam povolených a k jejich instalaci v dokumentaci ke službě Azure Database for PostgreSQL – Flexible Server.
  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 Tenant Azure AD pro daný úč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 Preview.

Volba metody migrace

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

  • Úplná modernizace aplikací – Pokud je nainstalované rozšíření modernizace GitHubu aplikace Copilot, vyberte Možnost Migrovat pomocí modernizace aplikací a pokračujte v migraci pomocí poznámek ke kódování 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řevodník aplikačního kódu klienta Oracle (pgsql_migration_oracle_app) — Převádí aplikační kód klienta Oracle na ekvivalentní kód pro PostgreSQL pomocí šablon promptů a pokynů pro psaní kódu 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 ke kódování (volitelné) — Cesta k poznámkám ke kódování 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 (Preview) 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