Migrazione da Oracle a PostgreSQL

L'estensione PostgreSQL per Visual Studio Code fornisce un flusso di lavoro end-to-end per la migrazione di database Oracle a PostgreSQL. Una procedura guidata illustra la connessione all'origine Oracle, la selezione di schemi, la configurazione di un modello di Microsoft Foundry per la conversione DDL assistita dall'intelligenza artificiale e la scelta di un database scratch PostgreSQL per la convalida. Dopo aver creato il progetto, un dashboard tiene traccia dell'estrazione, della conversione, dell'esportazione e della revisione in una singola visualizzazione.

Prerequisiti

Prima di iniziare, assicurati di avere:

• Visual Studio Code installato.
• Estensione PostgreSQL installata.
• Accesso a un database di origine Oracle con autorizzazioni di lettura per l'estrazione dello schema.
• Un'istanza di PostgreSQL da usare come database di convalida scratch(ad esempio, un server flessibile Database di Azure per PostgreSQL).
• Una risorsa Microsoft Foundry con un modello gpt-5.2 distribuito. Sono necessari l'URL dell'endpoint e una chiave API o un account Microsoft Entra ID con accesso.

Verificare che la funzionalità delle migrazioni sia abilitata

L'impostazione pgsql.enableMigrations controlla la visualizzazione Migrazioni (anteprima) e tutti i comandi di migrazione. Questa opzione è attivata per impostazione predefinita.

Se la visualizzazione Migrazioni (anteprima) non viene visualizzata nella barra laterale, verificare l'impostazione:

1. Aprire le impostazioni di VS Code (CTRL+, in Windows/Linux, Cmd+, in macOS).
2. Cercare "pgsql.enableMigrations".
3. Verificare che il valore sia true.

Creare un progetto di migrazione

Un progetto di migrazione è una procedura guidata in quattro passaggi che raccoglie la configurazione di origine, destinazione e intelligenza artificiale prima di creare l'area di lavoro del progetto.

Passaggio 1: Configurazione del progetto

1. Aprire la visualizzazione Migrazioni (anteprima) nella barra laterale.

2. Selezionare il pulsante + nella barra degli strumenti della vista oppure fare clic con il pulsante destro del mouse su una cartella dell'area di lavoro in Explorer e selezionare Crea progetto di migrazione.

   Si apre la pagina Nuovo progetto di migrazione da Oracle ad Database di Azure per PostgreSQL, che elenca ciò che è necessario:

   • Dettagli di connessione per il database di origine
   • Nome degli schemi da convertire
   • URL dell'endpoint e chiave per una risorsa Microsoft Foundry
   • Nome della connessione per un'istanza di PostgreSQL esistente

3. Immettere un nome nel campo nome Project.

4. Selezionare Avanti: Connessione Oracle.

Passaggio 2: Connettersi a Oracle

La pagina Connetti a Oracle raccoglie le credenziali del database di origine Oracle e consente di caricare gli schemi.

1. Completare i campi di connessione Oracle:

   Campo	Descrizione
   Oracle Hostname	Nome host o indirizzo IP del server di database Oracle.
   Porta Oracle	Porta del listener (impostazione predefinita: 1521).
   SiD Oracle o nome del servizio	SID Oracle o nome del servizio per l'istanza del database.
   Nome utente Oracle	Utente del database con accesso in lettura agli oggetti schema.
   Oracle Password	Password per l'utente Oracle.

2. Selezionare Carica schemi per connettersi e recuperare l'elenco degli schemi disponibili.

3. Nell'elenco a discesa Schemi selezionare uno o più schemi di cui eseguire la migrazione.

4. Selezionare Avanti: Connessione PostgreSQL.

Passaggio 3: Scegli un database temporaneo di Database di Azure per PostgreSQL

La pagina Scegli un database temporaneo di Database di Azure per PostgreSQL seleziona l'istanza di Database di Azure per PostgreSQL utilizzata dal modello di intelligenza artificiale per convalidare i file DDL convertiti.

1. Nell'elenco a discesa Connessione PostgreSQL selezionare un profilo di connessione esistente. Se la connessione necessaria non è elencata, selezionare Aggiorna profili per ricaricare i profili disponibili o creare prima una nuova connessione nella visualizzazione Connessioni e identità .
2. Nell'elenco a discesa Database PostgreSQL selezionare il database di destinazione. Selezionare Carica database se l'elenco è vuoto.
3. Dopo aver selezionato un database, l'estensione verifica automaticamente che siano installate le estensioni PostgreSQL consigliate. È anche possibile selezionare Verify Extensions (Verifica estensioni ) per eseguire manualmente il controllo. Se mancano estensioni, nella pagina sono elencate e vengono fornite indicazioni sull'elenco di elementi consentiti e sull'installazione tramite la documentazione del server flessibile Database di Azure per PostgreSQL.
4. Selezionare Avanti: Configurazione del modello di Microsoft Foundry.

Passaggio 4: Configurare il modello Microsoft Foundry

La pagina Choose a Microsoft Foundry Model consente di configurare la distribuzione Microsoft Foundry che supporta la conversione dello schema e del codice.

1. Completare i campi del modello linguistico:

   Campo	Descrizione
   Nome modello	gpt-5.2.
   Microsoft Foundry Endpoint	URL dell'endpoint della risorsa Microsoft Foundry (ad esempio, https://<resource>.openai.azure.com/).
   Metodo di autenticazione	Scegliere Chiave API o ID Microsoft Entra.
   Chiave API di Microsoft Foundry	Chiave API per la risorsa Microsoft Foundry (visualizzata quando il metodo di autenticazione è chiave API).
   Account Azure	account Microsoft con accesso alla risorsa (mostrata quando il metodo di autenticazione è Microsoft Entra ID).
   Tenant	tenant Azure AD per l'account (visualizzato quando Metodo di autenticazione è Microsoft Entra ID).
   Nome distribuzione	Nome del modello distribuito nella risorsa Microsoft Foundry.

2. Selezionare Test connessione Microsoft Foundry per verificare la connettività.

3. Selezionare Crea progetto di migrazione.

Eseguire la migrazione dello schema

Dopo aver creato il progetto, viene aperto il dashboard di Migrazione Oracle . Nel dashboard vengono visualizzate le schede Di migrazione delloschema e Revisione schema , insieme a un pannello Impostazioni che riepiloga la configurazione del progetto.

Estrarre e convertire gli schemi

La scheda Migrazione dello schema (Passaggio 1) esegue estrazione, conversione ed esportazione in un'unica pipeline continua.

1. Nella scheda Migrazione schema selezionare Esegui migrazione.

   L'etichetta del pulsante viene aggiornata man mano che la pipeline avanza:

   Condizione	Etichetta del pulsante
   Estrazione in corso	Estrazione in corso...
   Estrazione completata, conversione in sospeso	Riprendi migrazione
   Conversione in corso	Conversione in corso...
   Tutte le fasi sono completate	Migrazione completata

2. Monitorare lo stato di avanzamento nella scheda espansa:

   • L'estrazione mostra il numero di oggetti estratti (ad esempio, "15 di 42 oggetti estratti") e lo schema e l'oggetto corrente elaborati.
   • La conversione mostra il numero di blocchi convertiti (ad esempio, "3 di 8 blocchi convertiti") e il blocco corrente elaborato.

3. Al termine dell'esportazione, selezionare Visualizza report di migrazione per aprire il report di migrazione generato.

Esaminare le attività di migrazione

La scheda Revisione schema (passaggio 2) visualizza gli elementi che richiedono attenzione manuale dopo la conversione. Un selettore Attività / raggruppate nella parte superiore dell'area di revisione consente di scegliere come scorrere l'elenco.

Visualizzazione raggruppata

La visualizzazione Raggruppata organizza le attività di revisione in gruppi di fisarmonica collapsible per categoria. Usare questa visualizzazione quando si desidera elaborare insieme i problemi correlati.

1. Nella scheda Revisione schema selezionare Rivedi per espandere l'area di revisione e quindi selezionare Raggruppata.

2. Usare le schede In sospeso e Risolto per passare da un'attività all'altra che richiede ancora attenzione e attività già approvate.

3. Espandi un gruppo per visualizzarne i metadati (schemi, tipi di oggetti, criticità) e le singole schede delle attività contenute al suo interno.

4. Usare le azioni a livello di gruppo per elaborare le attività in blocco:

   Action	Descrizione
   Esegui tutto	Aprire ogni attività in sospeso nel gruppo in modalità agente Copilot per la revisione assistita da intelligenza artificiale.
   Risolvi tutto	Contrassegna tutte le attività del gruppo come risolte. Una finestra di dialogo di conferma mostra il nome del gruppo e il numero di attività prima di procedere.
   Reimposta tutto	Restituisce tutte le attività risolte nel gruppo allo stato in sospeso. Disponibile nella scheda Risolto .
   Visualizza nelle attività	Passa alla visualizzazione in formato elenco Attività filtrata per questo gruppo.

5. Per agire su una singola attività all'interno del gruppo, selezionare Esegui attività per aprirla in Copilot modalità agente oppure selezionare Risolvi per contrassegnarla. Selezionare Reimposta su un'attività risolta per riportarla allo stato in sospeso.

Visualizzazione Attività

La visualizzazione Attività mostra tutte le attività di revisione in una tabella flat. Usare questa visualizzazione quando si desidera ordinare, filtrare o cercare in tutte le attività indipendentemente dal gruppo.

1. Selezionare Attività nel commutatore.
2. Usare gli elenchi a discesa dei filtri (Stato, Criticità, Tipo di oggetto, Schema) per restringere l'elenco delle attività.
3. Selezionare Esegui attività in un elemento in sospeso per aprirla in modalità agente Copilot per la revisione e la correzione assistita dall'intelligenza artificiale.
4. Dopo aver corretto un elemento, selezionare Risolvi per contrassegnarlo completato.

Eseguire la migrazione del codice dell'applicazione

Dopo la migrazione dello schema, convertire il codice dell'applicazione specifico di Oracle (script SQL, stored procedure, file di controllo del caricatore, script della shell o file Java) in equivalenti compatibili con PostgreSQL. La migrazione delle applicazioni è una funzionalità di anteprima.

Scegliere un metodo di migrazione

L'estensione offre due percorsi per la migrazione del codice dell'applicazione:

• Modernizzazione completa delle app: se l'estensione di modernizzazione di GitHub app Copilot è installata, selezionare Esegui la migrazione usando la modernizzazione delle app per continuare la migrazione con le note di codifica dalla conversione dello schema. Selezionare Visualizza note sulla codifica per esaminare le indicazioni generate prima di procedere.
• Opzione solo database : per convertire solo il codice dell'applicazione correlata al database all'interno di questa estensione, selezionare Esegui la migrazione tramite l'estensione PostgreSQL.

Convertire il codice dell'applicazione all'interno dell'estensione

1. Nella scheda Migrazione dell'applicazione selezionare Esegui migrazione dati (o Seleziona metodo se viene rilevata l'estensione di modernizzazione dell'app).
2. Nella pagina Converti applicazioneselezionare Seleziona applicazione Oracle da convertire e scegliere la cartella contenente il codice dell'applicazione Oracle.
3. Selezionare una connessione PostgreSQL e un database PostgreSQL per il contesto di conversione.
4. Selezionare Carica database se l'elenco di database è vuoto.
5. Selezionare Converti applicazione per avviare la conversione.

Usare gli strumenti di Copilot per la migrazione delle applicazioni

L'estensione registra due strumenti del modello linguistico Copilot per assistenza per la migrazione:

• Oracle Client Code Application Converter (pgsql_migration_oracle_app): converte il codice dell'applicazione client Oracle in equivalenti PostgreSQL usando modelli di richiesta e linee guida per la codifica dall'analisi della migrazione dello schema. Accetta i parametri seguenti:

  • Cartella codebase dell'applicazione (obbligatorio): percorso del codice da convertire.
  • Percorso delle note di codifica (facoltativo) — Percorso delle note di codifica della migrazione dello schema.
  • Nome database Postgres (facoltativo): nome del database PostgreSQL per il contesto di conversione.
  • Connessione al database Postgres (facoltativo): nome della connessione per il database PostgreSQL.

• Mostra report di migrazione da Oracle a Postgres (pgsql_migration_show_report): visualizza il report di migrazione generato dalla conversione dello schema. Richiede un parametro Path to Report File .

Per altre informazioni sull'uso degli strumenti di Copilot, vedere integrazione Copilot.

Confrontare i file convertiti

Dopo la conversione, rivedi le modifiche una accanto all’altra usando i comandi diff integrati.

1. In Esplora file, fare clic con il pulsante destro del mouse su un file SQL convertito nella cartella oracle o postgres nel progetto di migrazione e selezionare Confronta le coppie di file di migrazione DDL.
2. Per i file di codice dell'applicazione convertiti (.sql, .ctl, .sh.load, o .java), fare clic con il pulsante destro del mouse sul file e scegliere Confronta coppie di file di migrazione dell'applicazione.

La visualizzazione comparativa affiancata mostra il codice sorgente Oracle originale accanto all'output PostgreSQL convertito, in modo da poter individuare eventuali artefatti che richiedono un intervento manuale.

Gestire i progetti di migrazione

Usare la visualizzazione Migrazioni (anteprima) nella barra laterale per gestire i progetti:

Contenuti correlati

• integrazione di Copilot
• Connessioni e identità
• Informazioni di riferimento sulle impostazioni
• Informazioni di riferimento sugli strumenti di Copilot