Esaminare gli oggetti convertiti in Esplora oggetti di conversione

Usare Esplora oggetti di conversione per esaminare e perfezionare i risultati della conversione da Oracle a PostgreSQL. Lo strumento di esplorazione mostra gli oggetti di origine insieme ai corrispondenti nomi, tipi e stati di destinazione. Ogni oggetto apre un confronto da origine a destinazione, con azioni di Copilot per spiegare la conversione o contribuire a modificare il file PostgreSQL generato.

Per istruzioni sull'apertura dello strumento di esplorazione da una conversione completata, vedere Esaminare e perfezionare gli oggetti convertiti nell'esercitazione.

Trovare ed esaminare gli oggetti

Usare i filtri sopra la tabella dei risultati per restringere gli oggetti da esaminare:

Controllo Purpose
Filtrare in base al nome dell'oggetto di origine Trovare un oggetto in base al nome dell'origine Oracle.
Tutti gli schemi Limitare i risultati a uno schema di origine.
Tutti i tipi di oggetto di origine Limitare i risultati in base al tipo di oggetto Oracle.
Tutti gli stati Limitare i risultati in base agli stati disponibili per la conversione.

Leggere Schema, Tipo di origine e Oggetto di origine insieme per identificare l'oggetto Oracle. Confrontare l'oggetto di destinazione e il tipo di destinazione per comprendere il mapping PostgreSQL. La colonna Stato mostra il risultato della conversione dell'oggetto e Azioni fornisce Domanda e Correzione.

Usare i controlli pagina sotto la tabella quando i risultati si estendono su più di una pagina.

Screenshot della conversione Esplora oggetti che mostra i filtri degli oggetti, i mapping da origine a destinazione, gli stati e le azioni Ask e Fix.

Esaminare i pacchetti e altri oggetti con più istruzioni

I pacchetti e altri oggetti di origine possono produrre più istruzioni PostgreSQL. Espandere l'oggetto padre per esaminare le voci associate anziché considerare la conversione come una singola istruzione PostgreSQL.

Esaminare i membri del pacchetto

Usare la gerarchia dei pacchetti per utilizzare i singoli membri e i rispettivi equivalenti PostgreSQL:

  1. Individuare il pacchetto usando i filtri dello schema e del nome dell'oggetto di origine sopra la tabella principale.
  2. Selezionare la freccia di espansione accanto al pacchetto per espandere le voci dei membri.
  3. Esaminare il mapping da origine a destinazione di ogni membro, inclusi il tipo di origine Oracle e il tipo di destinazione PostgreSQL.
  4. Selezionare il membro da ispezionare ed esaminare il confronto da origine a destinazione e le note di conversione.

Esaminare i membri singolarmente per comprendere le modifiche apportate per ciascuno di essi. Una visualizzazione a livello di pacchetto consente di individuare i membri, ma non sostituisce la revisione delle definizioni generate.

Filtrare i membri in base al tipo di oggetto di origine

Per un pacchetto con molti membri, usare il filtro di tipo oggetto all'interno del pacchetto espanso per concentrarsi su un tipo di membro di origine Oracle alla volta. Il filtro usa il tipo di origine Oracle del membro, non il tipo di destinazione PostgreSQL.

I due filtri di tipo oggetto servono a scopi diversi:

Posizione del filtro Cosa filtra
Tutti i tipi di oggetto di origine sopra la tabella principale Oggetti sorgente nell'elenco principale dei risultati.
Filtro di tipo oggetto all'interno di un pacchetto espanso Membri del pacchetto per tipo di origine Oracle.

Dopo aver esaminato un tipo di membro, modificare o rimuovere il filtro di tipo membro per esaminare i membri rimanenti.

Espandere e comprimere la gerarchia

Usare i controlli expand-all e collapse-all al livello che si sta esaminando:

Level Purpose
Esploratore Espandere o comprimere gli oggetti espandibili nell'elenco delle cartelle.
Pacchetto Espandere o comprimere i membri all'interno del pacchetto.

Utilizzare la freccia di espansione di un oggetto espandibile solo quando si desidera espandere o comprimere l'oggetto.

Confrontare le definizioni e leggere le note sulla conversione

Selezionare un oggetto per aprire la relativa visualizzazione diff. La definizione Oracle viene visualizzata a sinistra e la definizione di PostgreSQL generata viene visualizzata a destra. Esaminare il confronto per comprendere le modifiche apportate a nomi, tipi, parametri e costrutti specifici del database.

Leggere il pannello Note di conversione insieme alle definizioni. Le note forniscono contesto sulla conversione e sulle differenze che richiedono attenzione. Esaminarli per gli oggetti convertiti e gli oggetti che necessitano di correzione.

Screenshot di una visualizzazione diff da Oracle a PostgreSQL con la definizione di origine, la definizione generata e il pannello Note di conversione.

Chiedi a Copilot di spiegare una conversione

Selezionare Domanda per un oggetto per chiedere a GitHub Copilot di spiegarne la conversione, incluse le relative dipendenze. Usare la spiegazione insieme alle note sulla visualizzazione delle differenze e sulla conversione per comprendere in che modo la definizione di PostgreSQL è correlata alla sorgente Oracle.

Esaminare la spiegazione di Copilot in base alle definizioni e ai requisiti dell'applicazione prima di apportare modifiche.

Correggere un oggetto e applicare le modifiche

Correggi apre un prompt di Copilot con i dettagli dell'oggetto. Copilot usa tale contesto per apportare modifiche al file PostgreSQL. Esaminare le modifiche risultanti prima di compilarle.

È possibile modificare i file generati prima della distribuzione. Per la compilazione manuale, usare un database non di produzione e verificare che siano disponibili gli schemi e le dipendenze necessari. Se è necessario preparare il database, vedere Setup Experience.

Per correggere e compilare manualmente un oggetto nel database non di produzione:

  1. Selezionare Correzione per l'oggetto da modificare.
  2. Usare Copilot per apportare le correzioni necessarie ed esaminare la definizione aggiornata di PostgreSQL.
  3. Aprire il file PostgreSQL modificato nell'editor SQL.
  4. Connettere l'editor SQL al server PostgreSQL non di produzione.
  5. Connettersi al database in tale server in cui è distribuito lo schema convertito. Confermare il database attivo dell'editor.
  6. Esaminare i riferimenti allo schema in SQL e selezionare l'istruzione o le istruzioni complete da eseguire.
  7. Selezionare il pulsante Play nell'editor SQL per eseguire le istruzioni selezionate e compilare gli oggetti. È anche possibile eseguire la selezione con Esegui query PostgreSQL.
  8. Esaminare l'output di esecuzione. Correggere eventuali errori segnalati ed eseguire di nuovo la definizione aggiornata in base alle esigenze.

Il comando Esegui query PostgreSQL dell'editor SQL esegue la query SQL selezionata. Se non è selezionato alcun testo, esegue l'intero contenuto dell'editor. Quando un file contiene definizioni per più membri convertiti, selezionare istruzioni complete per evitare l'esecuzione involontaria di definizioni non correlate.

La modifica di un file e la compilazione del file nel database sono passaggi separati. Usare i risultati dell'esecuzione per determinare se la definizione aggiornata è stata applicata. Verificare che sql di distribuzione generata includa le correzioni testate prima della distribuzione di produzione; non presupporre che la modifica di un file per oggetto aggiorni deploy.sql.

Per la procedura per connettere l'editor, selezionare un database ed eseguire SQL, vedere Editor di query e IntelliSense.

Convalidare oltre la compilazione

La compilazione riuscita non stabilisce che l'oggetto convertito si comporta come la relativa origine Oracle. Prima della distribuzione di produzione, testare in modo indipendente la gestione dei dati, la logica di business, le dipendenze e il comportamento dell'applicazione con lo schema convertito.

Contenuti correlati

  • Ultimo aggiornamento: