Kurz: Převod flexibilních serverových aplikací Oracle do Azure Database for PostgreSQL (Preview)

Tento kurz vás provede převodem kódu klientské aplikace Oracle na Azure Database for PostgreSQL pomocí rozšíření Visual Studio Code PostgreSQL s režimem agenta GitHub Copilot k automatizaci a ověření transformace kódu.

Popisuje nastavení prostředí, import základu kódu aplikace, spuštění procesu převodu a kontrolu generovaného kódu kompatibilního s PostgreSQL. Než začnete, ujistěte se, že jste dokončili projekt převodu schématu pro optimální výsledky.

Při převodu můžete očekávat toto:

Nastavení prostředí: Nakonfigurujte režim agenta GitHub Copilot s odpovídajícím modelem AI.
Import základu kódu: Uspořádání kódu aplikace ve struktuře projektu migrace
AI processing: GitHub Copilot zpracovává a převádí kód aplikace pomocí kontextu databáze
Provádění úkolů TODO: Automatizované generování seznamů úkolů a systematický převod
Generování sestav: Komplexní sestava převodu obsahující výsledky a návrhy doporučení
Porovnání souborů: Integrované diff nástroje pro kontrolu původního vs. převedeného kódu

Předpoklady

Tato část popisuje předpoklady pro použití funkce převodu aplikací z Oracle do Azure Database for PostgreSQL ve Visual Studio Code před zahájením převodu.

Požadavky na systém

Requirement	Specifikace
verze Visual Studio Code	1.95.2 nebo vyšší
GitHub Copilot předplatné	Pro+, Business, Enterprise

Podpora operačního systému

Platform	Architecture
Windows	x64 a ARM64
Linux	x64 a ARM64
macOS	x64 (Intel) a ARM64 (Apple Silicon)

Požadavky na model AI

Potřebujete jeden z následujících modelů AI nakonfigurovaný v režimu agenta GitHub Copilot:

Model	Version
Claude	Sonnet 4.6 nebo Opus 4.6 nebo vyšší

Před zahájením převodu aplikace nastavte model režimu agenta GitHub Copilot na Claude Sonnet 4.6 nebo Claude Opus 4.6 nebo vyšší pro optimální výsledky transformace kódu.

Podpora verzí PostgreSQL

Cílová databáze	Version
Flexibilní server Azure Database pro PostgreSQL	PostgreSQL verze 15 nebo vyšší
Azure HorizonDB	PostgreSQL verze 17 nebo vyšší

Doporučení pro převod schématu

I když není nutné provést převod schématu databáze předem, nejprve se důrazně doporučuje dokončit migraci schématu. Pokud jste již převedli schéma Oracle na PostgreSQL, proces převodu aplikace poskytuje přesnější kontext a výsledky transformace kódu vyšší kvality prostřednictvím:

Poznámky k kódování: Artefakty metadat generované během převodu schématu (viz Co jsou poznámky ke kódování? níže)
Kontext databáze: Přímý přístup k převedeným objektům schématu
Mapování datových typů: Přesné porozumění transformacím typů

Další předpoklady

Připojení databáze k instanci Azure Database for PostgreSQL
Přístup k tržišti rozšíření Visual Studio Code a službám GitHub Copilot

Co jsou kódovací poznámky?

Poznámky k kódování jsou artefakty metadat automaticky generované během fáze převodu schématu. Zaznamenávají klíčové podrobnosti transformace a přehledy z převodu schématu Oracle-to-PostgreSQL, které tento proces později používá k vylepšení převodu kódu aplikace.

Kódovací poznámky můžou obsahovat například tyto informace:

Mapování datových typů a strukturální změny
Podrobnosti o převodu sekvencí, identit a složených typů
Úpravy implementací data/času nebo intervalu
Odkazy na tabulky s omezeními referenční integrity
Souhrny složitých balíčků Oracle, včetně procedur a podpisů funkcí
Další rady generované AI ke zlepšení přesnosti překladu kódu

Během převodu aplikace model AI tyto poznámky používá jako kontextové signály k vytvoření přesnějšího a sémanticky sladěného kódu kompatibilního s PostgreSQL.

Proces převodu aplikace

Tato část vás provede kompletním pracovním postupem převodu aplikace: nastavte své prostředí, naimportujte základ kódu, spusťte převod, zkontrolujte vygenerovanou sestavu a porovnejte změny souborů.

Krok 1: Nastavení prostředí

Otevřete Visual Studio Code s nainstalovaným rozšířením PostgreSQL.
Otevřete rozhraní chatu GitHub Copilot.
Pro model vyberte Claude Sonnet 4.6 nebo Claude Opus 4.6 .

Pro optimální výsledky převodu aplikací je vyžadováno použití Claude Sonnet 4.6 nebo Claude Opus 4.6. Nižší modely můžou produkovat méně přesné převody.

Krok 2: Otevření projektu migrace

Otevřete pracovní prostor obsahující projekt převodu schématu.
Přejděte do struktury složek projektu migrace:
```
.github/postgres-migration/project_name/
```
Ověřte, že struktura projektu obsahuje potřebné složky a soubory z převodu schématu.

Krok 3: Zkopírování základu kódu do projektu migrace

application_code Vyhledejte složku v projektu:

.github/postgres-migration/project_name/application_code/

Zkopírujte složku základu kódu, kterou chcete migrovat do application_code složky uvnitř složky projektu.
Uspořádejte soubory logicky, abyste usnadnili systematický převod.

Ponechte původní kód aplikace v samostatném umístění jako zálohu. Zkopírujte jenom soubory, které chcete převést do struktury projektu migrace.

Krok 4: Spuštění migrace kódu klienta

Na panelu Migrace rozšíření PostgreSQL vyberte Migrovat aplikaci a spusťte průvodce převodem aplikace.
Ve formuláři, který se načte, vyberte složku, kterou jste zkopírovali do kořenového adresáře pracovního prostoru.
Zvolte databázi, která má kontext pro vaši aplikaci:
- Databáze PostgreSQL, do které jste nasadili převedený DDL, nebo
- Databáze PostgreSQL, ve které už schéma aplikace existuje
Vyberte Převést aplikaci.

Tato akce zahájí následující procesy:

Vyvolá vlastní složený příkazový řádek a nástroj Režim agenta.
Vygeneruje seznam úkolů, na jejichž základě bude režim agenta pracovat.
Připojuje se k databázi a čte ji pro vylepšený kontext.
Systematicky převádí soubory kódu aplikace.

Krok 5: Monitorování průběhu převodu

Sledujte rozhraní režimu agenta GitHub Copilot, jak zpracovává soubory.
Agent pracuje systematicky prostřednictvím generovaného seznamu úkolů.
Zkontrolujte všechny výzvy nebo dotazy od agenta, které můžou vyžadovat vstup.
Nechte proces převodu plně dokončit, než zkontrolujete výsledky.

Krok 6: Vylepšený převod jazyka Java s rozšířením GitHub Copilot pro modernizaci aplikací (volitelné)

Pokud pracujete s kódem Java: Proces převodu můžete vylepšit instalací GitHub Copilot rozšíření modernizace aplikací před zahájením převodu.

Automatická kompilace testů

Dvě rozšíření VS Code vzájemně komunikují, aby poskytovala bezproblémovou integraci. Při převodu Java kódu rozšíření modernizace aplikací automaticky provede testovací kompilaci převedeného kódu, aby bylo možné identifikovat případné chyby syntaxe nebo problémy kompilace v rané fázi procesu.

Automatické generování testů jednotek

Na základě převedené kódové základny Rozšíření pro modernizaci aplikací automaticky generuje jednotkové testy, které pomáhají ověřit, že se převedená aplikace chová správně. Tato integrace využívá možnosti rozšíření modernizace aplikací k:

Analýza převedených tříd a metod Java
Generování vhodných testovacích případů pro kritické cesty kódu
Vytvoření testovacích zařízení, která pracují s připojeními k databázi PostgreSQL

Instalace rozšíření pro modernizaci aplikací GitHub Copilot je velmi doporučeno pro projekty migrace na Java, protože výrazně urychluje ověřování a zlepšuje kvalitu převodu prostřednictvím automatizované kontroly kompilace a generování testů.

Krok 7: Revize zprávy o převodu kódu

Po dokončení převodu aplikace v režimu agenta se automaticky vygeneruje a otevře komplexní sestavu.
Zpráva obsahuje podrobné výsledky a doporučené další kroky pro váš převod.

Pro komplexní pokyny k sestavě: Viz Oracle na Azure Database pro PostgreSQL aplikaci konvertované vygenerované sestavy (Preview) pro podrobné informace o interpretaci výsledků převodu, pochopení stavů souborů a plánování vaší validační strategie.

Krok 8: Porovnání změn kódu pomocí funkce porovnání souborů

Klikněte pravým tlačítkem myši na převedený soubor (například .java soubor) a vyberte Porovnat páry souborů migrace aplikací.
Tím se otevře souběžné zobrazení původních a převedených souborů.
Tuto možnost použijte k ověření kritických transformací před testováním.

Efektivní strategie porovnávání souborů: Podívejte se na vygenerované zprávy z převodu aplikací Oracle na Azure Database for PostgreSQL (Preview) pro pokyny, jak stanovit priority souborů k prvnímu přezkoumání a jak zaměřit své ověřovací úsilí.

Krok 9: Ověření převedeného kódu aplikace

Základní kroky ověření:

Nastavení neprodukčního testovacího prostředí s převedeným schématem PostgreSQL
Testování připojení k databázi pomocí nových připojovacích řetězců PostgreSQL
Spuštění důležitých obchodních pracovních postupů za účelem ověření chování aplikace
Ověření výsledků dotazu SQL na základě očekávaných výsledků od Oracle
Adresní oblasti označené příznakem v sestavě převodu

Important

Systémy umělé inteligence můžou občas dělat chyby. Pokud chcete zabránit funkčním regresím, problémům se zabezpečením nebo problémům s přístupem k datům, nezávisle ověřte veškerý převedený kód aplikace před nasazením do produkčního prostředí.

Systematický přístup k validaci: Použijte rámce ověřování v osvědčených postupech pro převod kódu aplikace Oracle na Azure Database for PostgreSQL (Preview) k určení priority testování na základě složitosti integrace Oracle a výsledků sestav převodu.

Kroky po převodu

Po dokončení převodu aplikace:

Spusťte testy jednotek: Spusťte sadu testů vaší aplikace proti převedenému kódu.
Testování integrace: Otestujte aplikaci pomocí databáze PostgreSQL.
Testování výkonu: Ověřte, že výkon dotazů splňuje požadavky.
Revize kódu: Požádejte členy týmu, aby zkontrolovali přesnost převedeného kódu.
Aktualizace dokumentace: Aktualizujte veškerou dokumentaci, která odkazuje na funkce specifické pro Oracle.

Kompletní validační strategie: Podívejte se na Nejlepší postupy pro převod kódu aplikace Oracle na Azure Database for PostgreSQL (Preview) pro podrobné validační rámce, priority testování a přístupy ke koordinaci týmu na základě složitosti převodu.

Další informace o rozšíření Visual Studio Code najdete v rozšíření PostgreSQL pro Visual Studio Code

Váš názor

Byla tato stránka užitečná?

Poslední aktualizace v 2026-06-08