Report di conversione degli schemi da Oracle ad Database di Azure per PostgreSQL - Server flessibile

La funzionalità di conversione dello schema da Oracle a Database di Azure per PostgreSQL genera diversi elementi in due fasi: extraction e conversion. Questi artefatti consentono di convalidare l'ambito, comprendere i risultati della conversione e risolvere i problemi. Ogni fase produce report strutturati, file CSV di supporto e file di log di runtime. Esaminare prima gli artefatti di estrazione, quindi esaminare gli artefatti di conversione prima di alzare di livello lo schema convertito nella destinazione di produzione.

Elementi di estrazione

La fase di estrazione viene eseguita per prima, quando lo strumento si connette all'origine Oracle e individua gli oggetti schema. Lo strumento genera gli artefatti seguenti prima dell'inizio della conversione guidata dall'intelligenza artificiale. Usarli per verificare la connettività, confermare l'ambito e identificare gli oggetti che richiedono una pianificazione manuale.

Report di estrazione Oracle

Il report di estrazione Oracle riepiloga gli elementi individuati dallo strumento nell'origine. Usarlo per verificare la connettività e verificare che sia stato trovato ogni oggetto di cui si prevede la migrazione.

Il report include:

  • Dettagli e versione della connessione dell'istanza Oracle.
  • Riepilogo dello schema con conteggi degli oggetti e frequenza di esito positivo dell'estrazione.
  • Suddivisione dei tipi di oggetto. Ad esempio, tabelle, indici, viste, procedure, pacchetti, funzioni, trigger e sequenze.
  • Tempo di elaborazione ed eventuali errori di estrazione.

Schermata del report di estrazione di Oracle.

Oggetti esclusi

Il excluded_objects.csv file elenca gli oggetti Oracle esclusi intenzionalmente dallo strumento dall'estrazione. Ad esempio, il PL/SQL con wrapping, i trigger di eventi di sistema, Java nel database e altre categorie non vengono estratti per progettazione. Ogni riga identifica lo schema, il tipo di oggetto, il nome dell'oggetto e il motivo dell'esclusione.

Usare questo file per pianificare la correzione manuale o il cambiamento di piattaforma per qualsiasi oggetto ignorato dallo strumento. Per l'elenco completo delle categorie ignorate per impostazione predefinita, consulta Limitazioni della conversione dello schema da Oracle ad Database di Azure per PostgreSQL.

Tipi non supportati

Il unsupported_types.csv file elenca i tipi di dati o i costrutti Oracle rilevati dallo strumento, ma non supporta la conversione automatica. Ogni riga identifica lo schema, l'oggetto e la colonna o l'argomento in cui è stato usato il tipo e il tipo di dati di origine.

Usare questo file per definire l'ambito della correzione manuale. Decidere se eseguire il mapping di ogni occorrenza a un tipo nativo postgreSQL, effettuare il refactoring dell'oggetto di origine o rimuoverlo dall'ambito di migrazione.

Registro di estrazione

Questo log acquisisce eventi di runtime dettagliati dalla fase di estrazione. Consultare il log per risolvere gli errori di connettività, i privilegi mancanti, la limitazione o le esclusioni impreviste quando il report di estrazione non spiega completamente cosa è successo.

Suddivisione in blocchi degli artefatti

Al termine dell'estrazione, lo strumento raggruppa gli oggetti Oracle estratti in batch con riconoscimento delle dipendenze denominati blocchi. La suddivisione in blocchi mantiene ogni chiamata a Microsoft Foundry entro il limite di token al minuto (TPM) della distribuzione e preserva le dipendenze tra gli oggetti durante la conversione.

Report di generazione blocchi

Il chunk_generation_report.md file descrive in che modo lo strumento raggruppa gli oggetti estratti in blocchi. Usarlo per comprendere le dimensioni dei blocchi, la distribuzione degli oggetti e l'ordinamento delle dipendenze prima dell'esecuzione della conversione o per analizzare il motivo per cui un oggetto specifico è atterrato in un blocco specifico.

Il report include:

  • Blocchi totali generati e gli oggetti in ogni blocco.
  • Distribuzione degli oggetti in base allo schema e al tipo di oggetto.
  • Relazioni di dipendenza che hanno influenzato la suddivisione in blocchi.
  • Dettagli della pianificazione dei token per blocco.

Artefatti di conversione

La fase di conversione viene eseguita dopo la fase di suddivisione in blocchi. Microsoft Foundry elabora un blocco alla volta in modo da restare entro il limite di token al minuto (TPM) della distribuzione. Lo strumento genera gli artefatti seguenti durante e dopo la fase di conversione. Usarli per convalidare i risultati della conversione, risolvere le attività di revisione e pianificare la distribuzione.

Rapporto di conversione per blocco

Per ogni blocco, lo strumento genera un report di conversione per ciascun blocco. Questo report acquisisce gli oggetti elaborati in tale blocco, il risultato della conversione e tutte le attività di revisione generate.

Usare i report per blocco per analizzare il comportamento di un batch specifico, correlare le attività di revisione con il blocco in cui sono state create o eseguire di nuovo un singolo blocco se si modifica la configurazione di origine o di destinazione.

Report di conversione tecnica

Questo report tecnico dettagliato per oggetto illustra l'intera esecuzione della conversione. Registra le mappature da origine a destinazione, le trasformazioni dei tipi di dati e quelle applicate dall'IA, gli avvisi di conversione e la posizione dei file PostgreSQL generati.

Usare questo report quando si esamina il codice generato dall'intelligenza artificiale, si esamina un'attività di revisione specifica o si produce un audit trail per una migrazione regolamentata.

Report di riepilogo dei clienti

Il file customer_summary.md è il riepilogo dello stato di preparazione pensato per i dirigenti, che aggrega i risultati di tutti i blocchi. Aprire questo report prima dopo il completamento della conversione. Usarlo per convalidare i risultati complessivi della conversione, pianificare la distribuzione e trovare le attività manuali che richiedono attenzione.

Il report include:

  • Statistiche di conversione e tasso di successo.
  • Mappatura oggetto per oggetto da Oracle a PostgreSQL.
  • Dettagli della trasformazione del tipo di dati.
  • Conteggio delle attività di revisione in base alla criticità.
  • Istruzioni di distribuzione e riferimenti a file.
  • Raccomandazioni sulle prestazioni e limitazioni note.

Schermata del report riepilogativo dei clienti.

Esaminare il report delle attività

Il file review_tasks.md esegue il mirroring delle attività di revisione visualizzate nel riquadro Schema Review dell'estensione PostgreSQL Visual Studio Code. Usarlo per riferimenti offline, audit trail o per condividere uno snapshot delle attività in sospeso e risolte con gli stakeholder che non hanno installato l'estensione. Per valutare e risolvere le attività, usare il riquadro Schema Review in Visual Studio Code. Per i dettagli, vedere Esaminare le attività e le cartelle di output per la conversione dello schema da Oracle ad Database di Azure per PostgreSQL.

Log di conversione

Questo log acquisisce eventi di runtime dettagliati dalla fase di conversione. Consultare il log per eseguire il debug delle limitazioni di Microsoft Foundry, dei blocchi del filtro dei contenuti, degli errori di convalida del database temporaneo o degli errori a livello di blocchi che non sono spiegati completamente nei report per blocchi o di riepilogo.

Utilizzare i report

Esaminare gli artefatti nell'ordine seguente:

  1. Aprire prima il report di estrazione Oracle, excluded_objects.csve unsupported_types.csv . Verificare che tutti gli schemi e i tipi di oggetto previsti siano stati individuati e decidere come gestire ogni oggetto escluso e tipo non supportato prima di avviare la conversione.
  2. Apri il report di generazione dei blocchi per verificare che gli oggetti che prevedi siano stati raggruppati in blocchi.
  3. Al termine della conversione, aprire il report di riepilogo dei clienti per convalidare i risultati complessivi e trovare gli elementi che richiedono attenzione.
  4. Classificare e risolvere le attività di revisione dal riquadro Schema Review dell'estensione PostgreSQL di Visual Studio Code. Per informazioni dettagliate sull'interfaccia utente, i livelli di criticità e il flusso di lavoro di risoluzione, vedere Rivedere le attività e le cartelle di output per la conversione di schema da Oracle al Database di Azure per PostgreSQL.
  5. Usare i report di conversione tecnica e per blocco per approfondire l'analisi di singoli oggetti, mappature o avvisi.
  6. Se l'estrazione o la conversione non riesce, consultare il log di estrazione e il log di conversione per diagnosticare la causa radice.

Contenuti correlati

  • Last updated on