Cos'è la conversione dello schema da Oracle al server flessibile di Database di Azure per PostgreSQL?

La funzionalità di conversione dello schema da Oracle a Database di Azure per PostgreSQL nell'estensione PostgreSQL di Visual Studio Code consente di convertire gli oggetti dello schema di database Oracle esistenti in uno schema compatibile con PostgreSQL. Questa funzionalità è progettata per schemi relazionali e produce lo schema convertito per Database di Azure per PostgreSQL server flessibile.

Lo strumento fornisce un'interfaccia utente basata su progetto per automatizzare la conversione dello schema. Se alcuni oggetti non possono essere convertiti automaticamente, lo strumento li contrassegna come attività di revisione, che è possibile risolvere manualmente usando gitHub agente Copilot modalità.

Architecture

Il processo di conversione dello schema prevede l'utilizzo di più componenti:

• Database Oracle di origine: database Oracle esistente che contiene lo schema da convertire.
• Visual Studio Code estensione PostgreSQL: interfaccia primaria per la gestione del processo di conversione.
• Database di Azure per PostgreSQL Flexible Server: ospita gli schemi temporanei utilizzati per la convalida e il test.
• Microsoft Foundry: fornisce i modelli di linguaggio che alimentano la trasformazione dello schema basato su intelligenza artificiale.
• Agenti di conversione dello schema: agenti basati su intelligenza artificiale che gestiscono il processo di conversione automatica.

Come funziona

Il processo di conversione dello schema usa un approccio intelligente e a più fasi che combina la trasformazione automatizzata con la supervisione umana:

• Connessione e individuazione: lo strumento si connette al database Oracle e cataloga tutti gli oggetti schema. Analizza la struttura, le dipendenze e la complessità per creare un piano di conversione.
• AI-powered transformation: gli agenti di conversione dello schema usano modelli di linguaggio ospitati in Microsoft Foundry per trasformare costrutti specifici di Oracle in equivalenti compatibili con PostgreSQL. L'intelligenza artificiale prende in considerazione il contesto, le relazioni e le procedure consigliate per la piattaforma.
• Convalida negli schemi scratch: Il strumento verifica tutti gli oggetti convertiti negli schemi scratch nel Server flessibile di Database di Azure per PostgreSQL. Questo passaggio verifica la correttezza e la compatibilità della sintassi prima della generazione dell'output finale.
• Generazione di attività di revisione: lo strumento identifica come attività di revisione gli oggetti che non possono essere completamente automatizzati o che richiedono il giudizio umano. Questi oggetti possono includere una logica di business complessa o funzionalità specifiche di Oracle che richiedono attenzione manuale.
• Risoluzione guidata: la modalità agente Copilot GitHub fornisce assistenza per completare le attività di revisione. Offre suggerimenti mirati in base al contesto e procedure consigliate per il server flessibile di Azure Database per PostgreSQL, grazi a cui prendere decisioni informate.
• Generazione di output: lo strumento converte gli oggetti convalidati correttamente in file PostgreSQL .sql organizzati, pronti per la distribuzione nell'ambiente di destinazione.

Installare l'estensione

La funzionalità di conversione dello schema da Oracle a PostgreSQL è incorporata nell'estensione PostgreSQL per Visual Studio Code. Non è necessario installare un'estensione separata.

Passaggi di installazione

1. Apri estensioni Marketplace: in Visual Studio Code selezionare l'icona Estensioni nella barra delle attività a sinistra oppure usare il tasto di scelta rapida da tastiera Ctrl+Shift+X (Windows/Linux) o Cmd+Shift+X (macOS).
2. Cercare l'estensione: nella casella di ricerca Extensions Marketplace immettere PostgreSQL (o l'ID ms-ossdata.vscode-pgsqlestensione ) per trovare l'estensione.
3. Installa l'estensione: nei risultati della ricerca individuare PostgreSQL pubblicato da Microsoft e quindi selezionare Install. Nel Marketplace sono disponibili diverse estensioni PostgreSQL, quindi verificare che il server di pubblicazione sia Microsoft prima dell'installazione.
4. Access Schema Conversion: dopo l'installazione dell'estensione, viene visualizzata un'icona a forma di elefante nella barra delle attività Visual Studio Code. Selezionare l'icona per aprire l'estensione PostgreSQL e accedere alla funzionalità di conversione dello schema.

Flusso di lavoro di conversione dello schema

Questa sezione illustra i concetti fondamentali utilizzati nell'intero flusso di lavoro di conversione dello schema da Oracle ad Database di Azure per PostgreSQL, incluse le unità di conversione (schemi, tabelle, indici, viste e procedure), le attività di revisione per il controllo umano, la convalida del database temporaneo, gli agenti di conversione dello schema basati sull'intelligenza artificiale e i conseguenti artefatti SQL di PostgreSQL. La comprensione di questi concetti consente di interpretare i risultati della conversione, definire le priorità e risolvere gli elementi contrassegnati e preparare i file convertiti per la distribuzione nel server flessibile di Database di Azure per PostgreSQL.

Database temporaneo

Lo strumento di conversione dello schema usa un server flessibile Database di Azure per PostgreSQL come ambiente di convalida temporaneo. All'interno di tale server, lo strumento crea uno o più schemi scratch, ovvero schemi PostgreSQL di breve durata che contengono oggetti convertiti in modo che lo strumento possa testarli senza influire sui dati di produzione.

L'uso di schemi scratch all'interno di un database scratch consente allo strumento di verificare che:

• Gli oggetti convertiti sono sintatticamente corretti.
• Le dipendenze tra gli oggetti vengono risolte nell'ordine corretto.
• Le definizioni degli oggetti rimangono compatibili con la versione di PostgreSQL di destinazione.
• Le funzionalità di Database di Azure per PostgreSQL - Server flessibile si applicano correttamente.

Esaminare le attività

Lo strumento contrassegna gli elementi per la revisione manuale quando l'intelligenza artificiale non è in grado di convertire completamente un oggetto o consiglia di confermare il risultato. Le attività di revisione comuni includono:

• Procedure PL/SQL complesse che richiedono una regolazione manuale.
• Tipi di dati specifici di Oracle che hanno più alternative in PostgreSQL.
• Funzioni personalizzate che contengono logica specifica di Oracle.

Per altre informazioni sulle priorità delle attività e sulle cartelle di output generate, vedere Esaminare le attività e le cartelle di output per Oracle per Database di Azure per PostgreSQL conversione flessibile dello schema del server.

Modalità agente di GitHub Copilot

La modalità agente Copilot di GitHub è una funzionalità integrata di Visual Studio Code che fornisce istruzioni guidate per completare le attività di revisione e allineare lo schema convertito ai requisiti dell'applicazione. La modalità agente offre:

• Suggerimenti con riconoscimento del contesto per le modifiche dello schema.
• Raccomandazioni sulle procedure consigliate per Database di Azure per PostgreSQL - Server flessibile.
• Completamento del codice per trasformazioni complesse.
• Integrazione con il flusso di lavoro di sviluppo esistente.

Modalità di connettività Oracle

Lo strumento di conversione dello schema supporta due modalità di connettività per la connessione al database Oracle di origine: thin e thick. Comprendere la differenza consente di scegliere la modalità corretta per l'ambiente in uso.

Modalità thin client (impostazione predefinita)

La modalità thin si connette direttamente a Oracle Database senza librerie client Oracle aggiuntive. Questa modalità è l'impostazione predefinita e non richiede alcuna configurazione aggiuntiva.

• Non richiede l'installazione di Oracle Instant Client.
• Supporta Oracle Database 12.1 e versioni successive.
• Si adatta alla maggior parte degli scenari di conversione degli schemi.
• Si connette usando la rete TCP/IP standard.

Modalità client pesante

La modalità Thick utilizza le librerie di Oracle Instant Client per connettersi a Oracle Database. Lo strumento di conversione dello schema rileva quando è necessaria la modalità spessa in base alla configurazione di rete Oracle e passa automaticamente a essa.

Quando è necessaria la modalità thick client

È possibile determinare se è necessaria la modalità client spessa controllando i file di configurazione di rete Oracle nell'ambiente di origine. Cercare i parametri seguenti nel sqlnet.ora file (in genere si trova in $ORACLE_HOME/network/admin/):

Se uno qualsiasi di questi parametri è configurato nell'ambiente Oracle di origine, è necessaria la modalità thick client. Lo strumento di conversione dello schema rileva questa configurazione e passa automaticamente alla modalità spessa. Assicurarsi che Oracle Instant Client sia installato nel computer in cui Visual Studio Code è in esecuzione prima di avviare la conversione.

Installare Oracle Instant Client

Per usare la modalità thick client, installare Oracle Instant Client nel computer in cui Visual Studio Code e lo strumento di conversione dello schema sono in esecuzione. La conversione dello schema è supportata solo in Windows e Linux .

1. Scaricare il pacchetto Oracle Instant Client Basic o Basic Light dal sito Web di Oracle per il sistema operativo.
2. Estrarre il pacchetto in una directory nel computer.
3. Aggiungere la directory Instant Client alla variabile di ambiente di sistema PATH :
   • Windows: aggiungere la directory Instant Client alla variabile tramite PATH oppure usando PowerShell.
   • Linux: aggiungere la directory Instant Client a PATH e impostare la LD_LIBRARY_PATH variabile di ambiente per includere la directory. Assicurarsi che la libaio libreria sia installata.
4. Riavviare Visual Studio Code per recuperare le variabili di ambiente aggiornate.

Autenticazione per Microsoft Foundry

Lo strumento di conversione dello schema supporta due metodi di autenticazione per la connessione ai modelli linguistici in Microsoft Foundry:

Autenticazione con chiave API

L'autenticazione con chiave API usa una chiave specifica della distribuzione per autorizzare le richieste. Questo metodo è semplice e adatto per scenari di sviluppo e test.

Autenticazione tramite Microsoft Entra ID

L'autenticazione di Microsoft Entra ID fornisce un accesso a Microsoft Foundry basato su token e sull'identità, senza dover gestire le chiavi API. Questo metodo è consigliato per ambienti di produzione e organizzazioni con gestione centralizzata delle identità.

Per usare l'autenticazione di Microsoft Entra ID:

1. Assegna il ruolo richiesto: assicurati che l'utente o l'entità servizio che ha effettuato l'accesso abbia il ruolo Foundry User (in precedenza Azure AI User) per la risorsa Microsoft Foundry che ospita la distribuzione del modello. Assegnare il ruolo nel portale di Azure sotto Controllo di accesso (IAM). Per altre informazioni, vedere Controllo degli accessi in base al ruolo per Microsoft Foundry.
2. Accedere ad Azure in Visual Studio Code: usare il comando Azure: Accedi dal Riquadro comandi (Ctrl+Shift+P) per autenticarti con l'account Microsoft Entra ID.
3. Seleziona l'autenticazione Entra ID: nel passaggio di configurazione del modello linguistico di Migration Wizard, seleziona Microsoft Entra ID come metodo di autenticazione invece di chiave API.
4. Specifica l'endpoint: Immetti l'URL dell'endpoint Microsoft Foundry. Lo strumento acquisisce automaticamente il token di autenticazione dalla sessione di accesso.

Sicurezza e rete

Utilizzando la funzionalità di conversione dello schema, assicurati che il tuo ambiente di Visual Studio Code possa connettersi in modo sicuro sia al database Oracle di origine che all'istanza del server flessibile di Azure Database per PostgreSQL utilizzata come database temporaneo.

Microsoft consiglia di connettersi alla risorsa Microsoft Foundry usando un endpoint privato. Per altre informazioni, vedere Configurare un collegamento privato per Microsoft Foundry.

Per altre informazioni sulla protezione delle connessioni di Microsoft Foundry, vedere Dati, privacy e sicurezza per i Modelli diretti di Azure in Microsoft Foundry.

Perché usare la funzionalità di conversione dello schema?

La conversione degli schemi Oracle in Database di Azure per PostgreSQL semplifica la migrazione e la modernizzazione. Riduce le attività manuali e i rischi automatizzando le trasformazioni, convalidando i risultati in un database scratch e fornendo una revisione assistita dall'intelligenza artificiale e un output ottimizzato per Azure pronto per la distribuzione.

• Conversione automatica: riduce lo sforzo manuale convertendo automaticamente gli oggetti dello schema compatibili.
• trasformazione basata su AI: usa modelli linguistici ospitati in Microsoft Foundry per decisioni di conversione con riconoscimento del contesto.
• Approccio di convalida: usa schemi scratch per verificare che gli oggetti convertiti funzionino correttamente.
• Flusso di lavoro integrato: funziona all'interno dell'ambiente di sviluppo Visual Studio Code.
• Connettività Oracle flessibile: supporta entrambe le modalità client, thin e thick, per la connessione a database Oracle.
• Opzioni di autenticazionemultiple: supporta la chiave API e l'autenticazione Microsoft Entra ID per Microsoft Foundry.
• Revisione e perfezionamento: fornisce indicazioni chiare per le attività di revisione manuale.
• Ottimizzazione di Azure: Progettata per Database di Azure per PostgreSQL - Server flessibile.

Oggetti dello schema supportati

Lo strumento di conversione supporta un'ampia gamma di oggetti di codice e schema Oracle, inclusi elementi di definizione dei dati, componenti a livello di schema e codice procedurale. Sebbene sia possibile convertire automaticamente molti oggetti comuni, potrebbe essere necessario esaminare o personalizzare manualmente il mapping per determinate funzionalità specifiche di Oracle o estensioni proprietarie. Per elenchi dettagliati di oggetti supportati e limitazioni note, vedere le sezioni di questo articolo.

Come vengono prodotte le conversioni

Lo strumento di conversione dello schema combina la traduzione basata su intelligenza artificiale con la convalida automatizzata per offrire risultati affidabili. I modelli Foundry di Microsoft traducono il DDL Oracle in PostgreSQL. Lo strumento compila quindi ogni oggetto convertito in uno schema scratch nel server flessibile Database di Azure per PostgreSQL di destinazione, esegue l'analisi statica e applica correzioni automatiche per i problemi comuni. Le fasi rimanenti della pipeline, ovvero l'analisi dell'origine, l'estrazione dei metadati e la generazione di script, vengono eseguite come passaggi prevedibili e basati su regole.

Per le routine PL/pgSQL, lo strumento aggiunge un controllo semantico del corpo che usa l'estensione plpgsql_check nel database scratch. Quando il controllo rileva un difetto che la compilazione normale non rileva, lo strumento elimina tale routine e lo invia nuovamente tramite il ciclo di correzione di intelligenza artificiale invece di scriverlo nell'output. Per altre informazioni, vedere Convalidare PL/pgSQL convertito con plpgsql_check.

Questo approccio usa l'intelligenza artificiale in cui aggiunge il maggior valore e mantiene il resto del flusso di lavoro deterministico e verificabile. Gli oggetti che non possono essere convalidati completamente vengono contrassegnati come attività di revisione in modo da poterli risolvere prima di applicare lo schema convertito. Per le funzionalità Oracle che non hanno un equivalente pratico di PostgreSQL, vedere Oracle per Database di Azure per PostgreSQL limitazioni di conversione dello schema del server flessibile.

Oggetti dello schema del database

Lo strumento di conversione supporta gli oggetti di database Oracle seguenti:

• Tabelle: definizioni di tabella, specifiche di colonna e vincoli a livello di tabella.
• Vincoli: chiavi primarie, chiavi esterne, vincoli univoci e vincoli CHECK.
• Indici: indici ad albero B, indici univoci e indici compositi.
• Sequenze: oggetti sequence di Oracle per valori con incremento automatico.
• Trigger: trigger a livello di riga e a livello di istruzione.
• Viste: viste di database standard.
• Viste materializzate: viste materializzate di Oracle e logica di aggiornamento.
• Schemi: oggetti a livello di schema e organizzazione.
• Sinonimi: sinonimi pubblici e privati (con limitazioni).

Oggetti di codice Oracle

Lo strumento di conversione supporta i costrutti di codice Oracle seguenti:

• Trigger: logica di trigger complessa e gestione degli eventi.
• Pacchetti: specifiche e corpi dei pacchetti Oracle.
• Funzioni: funzioni definite dall'utente con logica complessa.
• Procedure memorizzate: procedure memorizzate di Oracle e gestione dei parametri.
• Tipi e raccolte: tipi di oggetto Oracle, TYPE BODY metodi membro, VARRAYtabelle annidate e SUBTYPE dichiarazioni.

Conversione di pacchetti

I pacchetti Oracle non hanno un equivalente PostgreSQL diretto, quindi lo strumento converte ogni parte di un pacchetto in un costrutto PostgreSQL che mantiene la superficie chiamabile:

• Costanti: lo strumento converte le costanti del pacchetto pubblico in IMMUTABLE funzioni getter.
• Raccolte e cursori: tabelle annidate e VARRAY diventano domini di matrice, dove VARRAY ottiene anche un vincolo di lunghezza. Le matrici associative con chiave di stringa diventano jsonb domini e REF CURSOR diventano refcursor.
• Stato del pacchetto: le variabili del pacchetto pubblico diventano coppie getter e setter supportate da un'impostazione di sessione, che emula lo stato della sessione del pacchetto Oracle.
• Eccezioni: le eccezioni dichiarate dall'utente diventano funzioni che restituiscono un SQLSTATE valore. Ad esempio, un'eccezione inizializzata con -20001 esegue il mapping a U0001.
• Pacchetti di sola specifica: un pacchetto senza corpo viene convertito in stub che generano un errore quando viene chiamato, in modo che la superficie chiamabile esista ancora.

Query gerarchiche

Le query gerarchiche Oracle eseguono la conversione in espressioni di tabella comuni di PostgreSQL WITH RECURSIVE . Lo strumento converte CONNECT BY e PRIOR nel join ricorsivo del membro, START WITH nel membro di ancoraggio e LEVEL in un contatore di profondità. Converte SYS_CONNECT_BY_PATHanche , CONNECT_BY_ROOT, ORDER SIBLINGS BYe NOCYCLE. Dopo la conversione, lo strumento verifica che l'oggetto generato abbia la forma ricorsiva prevista e ritenta la conversione in caso contrario.

Controllo delle transazioni

Una routine che usa mantiene PRAGMA AUTONOMOUS_TRANSACTION la classe di oggetti Oracle originale, pertanto una funzione rimane una funzione e i chiamanti esistenti che lo usano in un'espressione SELECT o continuano a funzionare. Il lavoro autonomo viene eseguito su una connessione separata tramite l'estensione dblink , quindi assicurarsi che dblink sia disponibile nel server di destinazione. Una routine che usa un pragma esplicito COMMIT o ROLLBACK senza questo pragma viene convertita in una routine, perché PostgreSQL consente il controllo delle transazioni.

Convalidare pl/pgSQL convertito con plpgsql_check

PostgreSQL non convalida completamente il corpo di una routine PL/pgSQL quando viene creato. CREATE FUNCTION conferma che il corpo analizza, ma non risolve le tabelle, le colonne e le variabili a cui fa riferimento il corpo. Una routine che legge una colonna che non esiste viene creata correttamente e non riesce solo la prima volta che viene eseguita. In una migrazione, che trasforma un difetto di conversione in un evento imprevisto di produzione, perché la distribuzione ha un aspetto pulito.

Lo strumento di conversione dello schema chiude il divario con l'estensione plpgsql_check . Dopo la compilazione di una routine convertita nel database scratch, lo strumento esegue un controllo semantico del corpo su di esso. Quando il controllo rileva un difetto autentico, lo strumento rimuove la routine e la restituisce al ciclo di correzione di intelligenza artificiale, che lo ripristina e lo compila nuovamente. Solo le routine che passano vengono scritte nell'output di conversione.

Questa convalida è il motivo principale per cui una routine convertita è attendibile prima di distribuirla. Considerare plpgsql_check come parte obbligatoria dell'ambiente di conversione anziché un componente aggiuntivo facoltativo.

Posizione in cui viene eseguito il controllo

Il controllo viene eseguito interamente sul database scratch creato dallo strumento durante la conversione. Il database di destinazione non è necessario in fase di esecuzione e non è necessario plpgsql_check che lo strumento generi dipende da esso. L'estensione è un controllo di qualità in fase di conversione, non una dipendenza di runtime.

Cosa accade quando l'estensione non è disponibile

Il controllo non è aperto. Quando plpgsql_check non è consentito o non è disponibile nel server che ospita il database scratch, lo strumento ignora il controllo e la conversione continua. Nessun errore e non viene visualizzato alcun avviso nel report di conversione dello schema, pertanto un'esecuzione senza l'estensione ha lo stesso aspetto di un'esecuzione con essa.

Le routine vengono ancora compilate, quindi gli errori di sintassi vengono ancora rilevati. Ciò che si perde è la convalida del corpo più profonda, quindi i difetti, ad esempio una colonna o un riferimento di tabella non risolti, possono raggiungere l'output generato e la superficie in un secondo momento in fase di esecuzione. Verificare che l'estensione sia disponibile prima di basarsi sui risultati della conversione.

Rendere disponibile il controllo

plpgsql_checkè supportato in Database di Azure per PostgreSQL server flessibile per PostgreSQL 14 e versioni successive. Consenti l'estensione, aggiungerla a shared_preload_librariese riavviare il server prima di eseguire la conversione. Lo strumento installa quindi l'estensione nel database scratch. Per la procedura completa, vedere Procedure consigliate per Oracle per Database di Azure per PostgreSQL conversione flessibile dello schema del server.

Versioni di Oracle supportate

Questa sezione riepiloga le versioni del motore di database che supportano la conversione automatica dello schema ed evidenzia le considerazioni sulla compatibilità. Usare le versioni di Oracle e PostgreSQL supportate elencate per ottenere risultati ottimali. Convalidare le conversioni in un ambiente di test non di produzione e usare la patch secondaria più recente di ogni versione principale supportata. Se l'ambiente usa una versione non supportata o include funzionalità proprietarie di Oracle, potrebbe essere necessario eseguire il mapping manuale aggiuntivo o la revisione prima della distribuzione.

Le versioni di database Oracle seguenti supportano la conversione dello schema:

• Oracle 21c
• Oracle 19c
• Oracle 18c
• Oracle 12.2
• Oracle 12.1

Feedback e supporto

Per bug, richieste di funzionalità e problemi relativi alla funzionalità di conversione dello schema o all'estensione PostgreSQL, usare lo strumento di feedback predefinito in Visual Studio Code. È possibile accedere a questo strumento in due modi:

Menu Aiuto

Vai a Guida>Segnala un problema.

Palette dei comandi

1. Aprire il riquadro comandi con Ctrl+Shift+P (Windows/Linux) o Cmd+Shift+P (macOS).
2. Eseguire il comando PGSQL: Problema del report.

Quando crei il problema o fornisci commenti e suggerimenti, includi Schema Conversion: come prefisso nel titolo. Questo prefisso consente al team di sviluppo di identificare e classificare rapidamente in ordine di priorità il feedback correlato alla conversione dello schema. Questo meccanismo di feedback consente al team di sviluppo di migliorare continuamente la funzionalità di conversione dello schema e risolvere eventuali problemi riscontrati durante Oracle per Database di Azure per PostgreSQL progetti di migrazione.

Contenuti correlati

• Procedure consigliate per Oracle per Database di Azure per PostgreSQL conversione flessibile dello schema del server
• Esaminare le attività e le cartelle di output per Oracle per Database di Azure per PostgreSQL conversione flessibile dello schema del server
• Oracle per Database di Azure per PostgreSQL limitazioni di conversione dello schema del server flessibile