Esercitazione: Conversione di applicazioni server flessibili da Oracle a Database di Azure per PostgreSQL (anteprima)

Questa esercitazione illustra come convertire il codice dell'applicazione client Oracle in Database di Azure per PostgreSQL usando l'estensione PostgreSQL Visual Studio Code con GitHub Copilot modalità agente per automatizzare e convalidare la trasformazione del codice.

Illustra la configurazione dell'ambiente, l'importazione della codebase dell'applicazione, l'esecuzione del processo di conversione e la revisione del codice compatibile con PostgreSQL generato. Prima di iniziare, assicurarsi di aver completato un progetto di conversione dello schema per ottenere risultati ottimali.

Ecco cosa ci si può aspettare durante la conversione:

• Configurazione dell'ambiente: Configurare la Modalità Agente di GitHub Copilot con il modello di intelligenza artificiale appropriato
• Importazione codebase: organizzare il codice dell'applicazione nella struttura del progetto di migrazione
• elaborazione AI: GitHub Copilot elabora e converte il codice dell'applicazione usando il contesto del database
• Esecuzione attività TODO: generazione automatica dell'elenco di attività e conversione sistematica
• Generazione di report: rapporto di conversione completo con risultati e raccomandazioni
• Confronto tra file: strumenti diff predefiniti per la revisione del codice originale o convertito

Prerequisiti

Questa sezione descrive i prerequisiti per l'utilizzo della funzionalità di conversione delle applicazioni da Oracle a Azure Database per PostgreSQL in Visual Studio Code, prima di iniziare una conversione.

Requisiti di sistema

Requisito	Specificazione
Versione di Visual Studio Code	1.95.2 o versione successiva
sottoscrizione GitHub Copilot	Pro+, Business, Enterprise

Supporto dei sistemi operativi

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

Requisiti del modello di intelligenza artificiale

È necessario uno dei modelli di intelligenza artificiale seguenti configurati in modalità agente GitHub Copilot:

Modello	Version
Claude	Sonnet 4.6 o Opus 4.6 o versione successiva

Prima di avviare la conversione dell'applicazione, impostare il modello GitHub Copilot modalità agente su Claude Sonnet 4.6 o Claude Opus 4.6 o versione successiva per ottenere risultati ottimali della trasformazione del codice.

Supporto della versione di PostgreSQL

Database di destinazione	Version
Database di Azure per PostgreSQL - Server flessibile	PostgreSQL versione 15 o successiva
Azure HorizonDB	PostgreSQL versione 17 o successiva

Raccomandazione per la conversione dello schema

Anche se non è necessario eseguire prima una conversione dello schema di database, è consigliabile completare prima una migrazione dello schema. Se lo schema Oracle è già stato convertito in PostgreSQL, il processo di conversione dell'applicazione offre un contesto più accurato e risultati di trasformazione del codice di qualità superiore tramite:

• Note sulla codifica: gli artefatti dei metadati generati durante la conversione dello schema (vedere Che cosa sono le note sulla codifica? di seguito)
• Contesto del database: accesso diretto agli oggetti schema convertiti
• Mapping dei tipi di dati: conoscenza accurata delle trasformazioni dei tipi

Altri prerequisiti

• Connettività del database per l'istanza di Database di Azure per PostgreSQL
• Accesso ai servizi GitHub Copilot e del marketplace delle estensioni Visual Studio Code

Che cosa sono le note di codifica?

Le note di codifica sono artefatti di metadati generati automaticamente durante la fase di conversione dello schema. Acquisiscono i dettagli della trasformazione chiave e le informazioni dettagliate dalla conversione dello schema da Oracle a PostgreSQL usata successivamente dal processo per migliorare la conversione del codice dell'applicazione.

Le note sulla codifica possono includere informazioni come:

• Mappatura dei tipi di dati e modifiche strutturali
• Dettagli della conversione per sequenze, identità e tipi compositi
• Modifiche alle implementazioni di data/ora o intervallo
• Riferimenti alle tabelle con vincoli di integrità referenziale
• Riepiloghi di pacchetti Oracle complessi, incluse le firme di procedure e funzioni
• Altri hint generati dall'intelligenza artificiale per migliorare l'accuratezza della traduzione del codice

Durante la conversione dell'applicazione, il modello di intelligenza artificiale usa queste note come segnali contestuali per produrre codice compatibile con PostgreSQL più preciso e semanticamente allineato.

Processo di conversione dell'applicazione

Questa sezione illustra il flusso di lavoro di conversione completo dell'applicazione: configurare l'ambiente, importare la codebase, eseguire la conversione, esaminare il report generato e confrontare le modifiche dei file.

Passaggio 1: Configurare l'ambiente

• Aprire Visual Studio Code con l'estensione PostgreSQL installata.
• Aprire l'interfaccia di chat GitHub Copilot.
• Selezionare Claude Sonnet 4.6 o Claude Opus 4.6 per il modello.

Per ottenere risultati ottimali della conversione delle applicazioni, è necessario usare Claude Sonnet 4.6 o Claude Opus 4.6. I modelli inferiori potrebbero produrre conversioni meno accurate.

Passaggio 2: Aprire il progetto di migrazione

• Aprire l'area di lavoro contenente il progetto di conversione dello schema.

• Passare alla struttura di cartelle del progetto di migrazione:

  .github/postgres-migration/project_name/
  

• Verificare che la struttura del progetto includa le cartelle e i file necessari dalla conversione dello schema.

Passaggio 3: Copiare la codebase nel progetto di migrazione

• Individuare la application_code cartella nel progetto:

  .github/postgres-migration/project_name/application_code/
  

• Copiare la cartella codebase di cui si vuole eseguire la migrazione nella cartella all'interno della application_code cartella del progetto.

• Organizzare i file in modo logico per facilitare la conversione sistematica.

Mantieni il codice originale dell'applicazione in una posizione separata come backup. Copiare solo i file da convertire nella struttura del progetto di migrazione.

Passaggio 4: Avviare la migrazione del codice client

• Nel pannello Migrazione dell'estensione PostgreSQL selezionare Esegui migrazione applicazione per avviare la conversione guidata dell'applicazione.
• Nel modulo caricato selezionare la cartella copiata nella radice dell'area di lavoro.
• Scegliere il database con il contesto per l'applicazione:
  • Database PostgreSQL in cui è stato distribuito il DDL convertito o
  • Database PostgreSQL in cui esiste già lo schema dell'applicazione
• Selezionare Converti applicazione.

Questa azione avvia i processi seguenti:

• Richiama un prompt composito personalizzato e uno strumento in modalità agente
• Genera un elenco TODO di attività su cui la Modalità Agente procede a lavorare.
• Si connette e legge il database per un contesto avanzato
• Converte sistematicamente i file di codice dell'applicazione

Passaggio 5: Monitorare lo stato di avanzamento della conversione

• Guarda l'interfaccia di GitHub Copilot in modalità agente mentre elabora i file.
• L'agente gestisce l'elenco TODO generato in modo sistematico.
• Esaminare eventuali richieste o domande dell'agente che potrebbero richiedere un input.
• Consentire il completamento completo del processo di conversione prima di esaminare i risultati.

Passaggio 6: Conversione avanzata di Java con l'estensione GitHub Copilot per la modernizzazione delle app (facoltativo)

Se si utilizza codice Java: puoi migliorare il processo di conversione installando l'GitHub Copilot App Modernization Extension prima di iniziare la conversione.

Compilazione automatica dei test

Le due estensioni di VS Code comunicano tra loro per offrire un'integrazione semplice. Quando si converte Java codice, l'estensione di modernizzazione delle app esegue automaticamente una compilazione di test del codice convertito per identificare eventuali errori di sintassi o problemi di compilazione all'inizio del processo.

Generazione automatica di unit test

In base alla codebase convertita, l'estensione per la modernizzazione delle app genera automaticamente unit test per verificare che l'applicazione convertita si comporti correttamente. Questa integrazione sfrutta le funzionalità dell'estensione di modernizzazione delle app per:

• Analizzare le classi e i metodi Java convertiti
• Generare test case appropriati per i percorsi di codice critici
• Crea fixture di test che funzionano con le connessioni al database PostgreSQL

L'installazione dell'estensione di modernizzazione delle app GitHub Copilot è altamente consigliata per Java progetti di migrazione, poiché accelera notevolmente la convalida e migliora la qualità della conversione tramite controlli di compilazione automatizzati e generazione di test.

Passaggio 7: Esaminare il report di conversione del codice

• Al termine della conversione dell'applicazione in modalità agente, viene generato automaticamente e aperto un report completo.
• Il report fornisce risultati dettagliati e i passaggi successivi consigliati per la conversione.

Per indicazioni complete sui report: vedere i report generati da Oracle su Azure Database per PostgreSQL (Anteprima) per informazioni dettagliate sull'interpretazione dei risultati della conversione, sulla comprensione degli stati dei file e sulla pianificazione della strategia di convalida.

Passaggio 8: Confrontare le modifiche del codice usando la funzionalità diff dei file

• Fare clic con il pulsante destro del mouse su un file convertito (ad esempio, un .java file) e selezionare Confronta coppie di file di migrazione dell'app.
• Verrà visualizzata una visualizzazione affiancata dei file originali e convertiti.
• Usare questa opzione per convalidare le trasformazioni critiche prima del test.

Strategia efficace di confronto dei file : consultare i report generati dalla conversione delle applicazioni Oracle verso Azure Database per PostgreSQL (Anteprima) per indicazioni sulla priorità dei file da revisionare e su come concentrare efficacemente i vostri sforzi di convalida.

Passaggio 9: Convalidare il codice dell'applicazione convertito

Passaggi di convalida essenziali:

• Configurare un ambiente di test non di produzione con lo schema PostgreSQL convertito
• Testare la connettività del database con le nuove stringhe di connessione PostgreSQL
• Eseguire flussi di lavoro aziendali critici per verificare il comportamento dell'applicazione
• Convalidare i risultati delle query SQL rispetto ai risultati previsti da Oracle
• Indirizzare le aree contrassegnate identificate nel report di conversione

Importante

I sistemi di intelligenza artificiale possono occasionalmente commettere errori. Per evitare regressioni funzionali, problemi di sicurezza o problemi di accesso ai dati, convalidare in modo indipendente tutto il codice dell'applicazione convertito prima della distribuzione nell'ambiente di produzione.

Approccio di convalida sistematica: utilizzare i framework di convalida nelle Best practices per convertire il codice dell'applicazione Oracle in Database di Azure per PostgreSQL (anteprima) per classificare in ordine di priorità i test in base ai risultati del report di conversione e alla complessità dell'integrazione con Oracle.

Passaggi post-conversione

Dopo aver completato la conversione dell'applicazione:

• Esegui i test unitari: Avvia il gruppo di test dell'applicazione sul codice convertito.
• Test di integrazione: testare l'applicazione con il database PostgreSQL.
• Test delle prestazioni: verificare che le prestazioni delle query soddisfino i requisiti.
• Revisione del codice: chiedere ai membri del team di esaminare il codice convertito per ottenere l'accuratezza.
• Aggiornamento della documentazione: aggiornare qualsiasi documentazione che faccia riferimento alle funzionalità specifiche di Oracle.

Strategie di convalida complete: vedere le procedure consigliate per la conversione del codice delle applicazioni Oracle in Database di Azure per PostgreSQL (Anteprima) per framework di convalida dettagliati, priorità di test e approcci di coordinamento del team in base alla complessità della conversione.

Per altre informazioni sull'estensione Visual Studio Code, vedere l'estensione PostgreSQL per Visual Studio Code

Contenuti correlati

• Che cos'è la conversione delle applicazioni da Oracle a Azure Database per PostgreSQL (Anteprima)?
• Rapporti generati di conversione dell'applicazione da Oracle a Azure Database per PostgreSQL (Anteprima)
• Migliori pratiche per convertire il codice dell'applicazione Oracle in Database di Azure per PostgreSQL (Anteprima)
• Conversione da Oracle a Azure Database per PostgreSQL, limitazioni dell'applicazione (anteprima)