Condividi tramite

Esercitazione: Conversione dello schema da Oracle a Database di Azure per PostgreSQL (anteprima)

Questa esercitazione illustra come convertire gli schemi di database Oracle in Database di Azure per PostgreSQL usando l'estensione PostgreSQL di Visual Studio con Azure OpenAI per automatizzare e convalidare la conversione dello schema

Illustra la connessione alla sorgente Oracle e al database di destinazione Azure per PostgreSQL, la configurazione di Azure OpenAI, l'esecuzione del Wizard di Migrazione e l'analisi degli artefatti generati per PostgreSQL. Prima di iniziare, assicurarsi di disporre dell'accesso alla rete e delle credenziali sia per i server che per una distribuzione OpenAI di Azure.

Ecco cosa ci si può aspettare durante la conversione:

  • Rilevamento schema: lo strumento analizza gli oggetti schema di Oracle
  • Elaborazione IA: Azure OpenAI elabora e converte oggetti compatibili
  • Convalida: gli oggetti convertiti vengono convalidati nel database scratch
  • Rivedi attività: gli oggetti che richiedono attenzione manuale vengono contrassegnati
  • Generazione di output: gli oggetti convertiti correttamente vengono salvati come file PostgreSQL

Prerequisiti

Questa sezione descrive i prerequisiti per l'uso della funzionalità di conversione dello schema da Oracle a Database di Azure per PostgreSQL in Visual Studio Code prima di avviare una conversione.

Requisiti di sistema

Categoria Dettagli
Versione di Visual Studio Code 1.95.2 o versione successiva
Sottoscrizione di GitHub Copilot Pro+, Business, Enterprise

Supporto dei sistemi operativi

Sistema operativo Dettagli supporto
Windows Solo architettura x64
Linux Architettura x64
macOS macOS 13+

Supporto della versione di PostgreSQL

Componente Requisiti di versione
Database di Azure per PostgreSQL PostgreSQL versione 15 o successiva
Database temporaneo Database di Azure per PostgreSQL

Requisiti del modello di intelligenza artificiale

È necessario uno dei componenti di intelligenza artificiale seguenti configurati:

Componente IA Versione del modello
Azure OpenAI Distribuzione GPT-4.1

Configurazione della distribuzione di Azure OpenAI

È necessario configurare la distribuzione di Azure OpenAI con il nome del modello gpt-4.1.

Formato endpoint di esempio:

https://{your-resource}.openai.azure.com/openai/deployments/gpt-4.1/chat/completions?api-version=2025-01-01-preview

Privilegi di database necessari

Prima di eseguire la conversione dello schema, assicurarsi che gli account abbiano i privilegi minimi necessari su entrambi il database Oracle di origine e il database Azure Database for PostgreSQL. L'account Oracle richiede l'accesso in lettura ai dati e alle visualizzazioni dizionario, in modo che lo strumento possa analizzare lo schema e il codice. L'account Scratch PostgreSQL deve essere in grado di creare schemi, tabelle e altri oggetti per la convalida. Usare un account del servizio dedicato laddove possibile. Seguire il principio dei privilegi minimi. Coordinarsi con gli amministratori del database per concedere eventuali diritti con privilegi elevati temporanei e convalidare la connettività e l'accesso prima di avviare la conversione.

Privilegi Oracle di origine

Per il database Oracle di origine sono necessari i privilegi minimi seguenti:

Privilegio Scopo
CONNECT Connessione di base al database
SELECT_CATALOG_ROLE Accesso alle viste del dizionario dei dati
SELEZIONARE QUALSIASI DIZIONARIO Leggere i metadati di sistema e gli oggetti dizionario
SELEZIONARE SYS.ARGUMENT$ Accesso alle informazioni sugli argomenti di procedura e funzione

Privilegi dei database di scratch

Per il server flessibile del Database di Azure per PostgreSQL (DB temporaneo) sono necessari i seguenti privilegi sul server flessibile:

Privilegio Scopo
CREA SCHEMA Creare schemi di convalida
CREARE SUL DATABASE Creare oggetti di database per la convalida
CONNESSIONE DELLE CONCESSIONI SUL DATABASE Autorizzazioni di connessione per i processi di convalida

Requisiti di rete

  • Connettività in uscita agli endpoint OpenAI di Azure
  • Connettività del database a database Oracle di origine e database PostgreSQL di destinazione
  • Accesso HTTPS per il marketplace delle estensioni di Visual Studio Code e i servizi Di GitHub Copilot
  • Accesso al repository GitHub a https://github.com/microsoft/pgsql-tools/

Processo di migrazione

Questa sezione illustra il flusso di lavoro di migrazione completo: installare l'estensione PostgreSQL, creare e testare le connessioni all'origine Oracle e alla destinazione database di Azure per PostgreSQL, aprire e inizializzare un progetto di migrazione, configurare Azure OpenAI per la conversione dello schema, eseguire la Migrazione guidata per individuare e convertire gli schemi, convalidare gli oggetti convertiti in un database scratch e rivedere o correggere eventuali elementi contrassegnati prima di applicare gli artefatti PostgreSQL generati alla destinazione.

Passaggio 1: Installare l'estensione PostgreSQL Visual Studio Code

  1. Apri Visual Studio.

  2. Passare alla visualizzazione Estensioni (CTRL+MAIUSC+X).

  3. Cercare PostgreSQL e installare l'estensione PostgreSQL .

    1. Download del Marketplace

    Screenshot dell'installazione dell'estensione PostgreSQL in VS Code.

Passaggio 2: Creare una connessione PostgreSQL

  1. Nel pannello dell'estensione PostgreSQL creare una connessione al database di Azure per PostgreSQL.

  2. Immettere i dettagli di connessione necessari (host, database, nome utente, password).

  3. Testare e salvare la connessione.

    Screenshot dell'aggiunta di una nuova connessione PostgreSQL.

Passaggio 3: Aprire una nuova area di lavoro

  1. Creare una nuova cartella nel computer locale per il progetto di migrazione.

  2. Aprire una nuova area di lavoro in Visual Studio Code.

    Screenshot dell'aggiunta di una nuova area di lavoro in VS Code.

Passaggio 4: Inizializzare il progetto di migrazione

  1. Vai a l'estensione PostgreSQL.

  2. Passare al pannello Migrazioni (anteprima).

  3. Selezionare Crea progetto di migrazione.

    Screenshot della creazione di un nuovo progetto di migrazione.

Passaggio 5: Configurare le impostazioni del progetto

  1. Nella Procedura guidata di migrazione, inserire il nome del progetto.

  2. Selezionare Avanti per procedere con il passaggio successivo.

    Screenshot del nome del progetto.

Passaggio 6: Configurare la connessione Oracle

  1. Immettere i dettagli della connessione Oracle , tra cui:

    • Nome host o server
    • Numero di porta
    • Nome del database o del servizio
    • Nome utente e password

  2. Selezionare Carica schemi.

  3. Il sistema testa la connessione Oracle.

  4. In caso di esito positivo, elenca tutti gli schemi definiti dall'utente disponibili in Oracle.

  5. Scegliere uno o più schemi da convertire in PostgreSQL.

  6. Seleziona Avanti per continuare.

    Screenshot della configurazione di un server Oracle.

Passaggio 7: Configurare un database postgreSQL scratch

  1. Seleziona la connessione Azure Database per PostgreSQL che hai definito nell'estensione PostgreSQL

  2. Selezionare il database di destinazione dall'elenco a discesa

  3. Selezionare Avanti per continuare

    Screenshot della configurazione di un database temporaneo.

Passaggio 8: Configurare un modello linguistico OpenAI di Azure

  1. Immettere i dettagli di Azure OpenAI , tra cui:

    • URL del punto finale
    • Chiave dell'API
    • Nome distribuzione (deve essere gpt-4.1)

  2. Selezionare Test connessione per verificare la configurazione

  3. Una volta che la connessione è riuscita, selezionare Crea progetto di migrazione

    Screenshot della configurazione del modello linguistico.

Passaggio 9: Eseguire la conversione dello schema

  1. Il sistema passa alla procedura guidata principale di migrazione

  2. Selezionare Esegui migrazione per avviare il processo di conversione dello schema

  3. Monitorare lo stato di avanzamento della conversione nell'interfaccia di Visual Studio

    Screenshot dello stato di avanzamento della fase di migrazione.

Passaggio 10: Esaminare il report di conversione dello schema

  1. Una volta completata la conversione dello schema, viene generato un report di conversione dello schema .
  2. Esaminare gli oggetti convertiti correttamente o ignorati.
  3. Il report visualizza la percentuale di esito positivo della conversione.

Passaggio 11: Esaminare e perfezionare le attività di conversione

  1. Una volta completata la conversione dello schema, vengono create attività di revisione per gli oggetti che richiedono attenzione.
  2. Usare gli agenti Di GitHub Copilot o convertire manualmente gli schemi in PostgreSQL.
  3. Esaminare e confrontare le istruzioni di conversione dello schema precedente e nuove conversioni.

Passaggio 12: Convalidare gli oggetti convertiti prima della distribuzione

  1. Convalidare in modo indipendente tutti gli oggetti convertiti in un ambiente non di produzione.
  2. Verificare che le dipendenze, i vincoli e i carichi di lavoro rappresentativi si comportino come previsto.
  3. Esaminare le risoluzioni per tutte le attività di revisione e ripetere il test dopo le modifiche.

Importante

Responsabilità di convalida dei clienti: lo stesso motore di intelligenza artificiale usato per la conversione dello schema può anche facilitare la convalida e la revisione. I sistemi di intelligenza artificiale possono occasionalmente confermare i propri errori. Per evitare perdite di dati, regressioni funzionali o problemi di sicurezza, convalidare in modo indipendente tutti gli oggetti convertiti e le risoluzioni delle attività di revisione prima della distribuzione nell'ambiente di produzione. Come parte dei controlli, valutare la possibilità di abilitare il filtro del contenuto di Azure AI Foundry per ridurre gli output dannosi o indesiderati. Per indicazioni, vedere Filtro del contenuto in Azure AI Foundry.

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

Contenuti correlati

  • Last updated on