Estensione Database Migration Assessment per Oracle

L'estensione Database Migration Assessment per Oracle in Azure Data Studio consente di valutare un carico di lavoro Oracle per la migrazione a Azure SQL e al Database di Azure per PostgreSQL. L'estensione identifica una destinazione di Azure SQL o PostgreSQL appropriata con raccomandazioni sul corretto dimensionamento e rileva il possibile livello di complessità della migrazione.

Prerequisiti

• Azure Data Studio versione 1.39 o successiva.

• Un Oracle Database che esegue la versione 11g o successiva.

• Gli utenti Oracle devono avere privilegi CONNECT e SELECT ANY DICTIONARY assegnati.

Installare l'estensione di Azure Data Studio

Seguire questa procedura per installare l'estensione Database Migration Assessment per Oracle in Azure Data Studio.

1. Aprire la gestione estensioni in Azure Data Studio. È possibile selezionare l'icona delle estensioni o scegliere Estensioni dal menu Visualizza.

2. Digitare Oracle nella barra di ricerca.

3. Selezionare l'estensione Database Migration Assessment per Oracle e visualizzarne i dettagli.

4. Selezionare Installa.

   

Configurare le impostazioni dell'estensione

È possibile configurare diverse impostazioni di estensione dopo l'installazione dell'estensione.

1. Passare alle estensioni e selezionare Database Migration Assessment per Oracle, selezionare l'icona gestisci impostazioni e quindi selezionare le impostazioni di estensione.

   

2. In Impostazioni di estensione modificare le impostazioni di estensione per soddisfare i requisiti dell'ambiente.

   

   Nota

   Per eseguire la valutazione del codice Oracle in PostgreSQL, il percorso home del client Oracle e il percorso di installazione Ora2Pg sono parametri obbligatori.

Eseguire la valutazione

Dopo aver installato l'estensione di valutazione, il passaggio successivo consiste nel connettersi al database Oracle, raccogliere le informazioni sui metadati dall'istanza di Oracle e generare un report di valutazione.

1. Passare all'icona Connessioni nella barra dei menu.

   

2. Compilare i campi di Dettagli connessione.

   1. Nel campo Tipo di connessione selezionare Oracle.
   2. Nel campo Origine dati digitare il nome e l'istanza del server Oracle.
      1. È anche possibile specificare il nome TNS. (Assicurarsi che la variabile di ambiente ORACLE_HOME sia impostata e che il file TNSNAMES.ORA si trovi in <ORACLE_HOME>/network/admin folder).
      2. Per il database contenitore, è possibile collegare il database radicale del contenitore usando l'ID del servizio CDB oppure usare il nome del servizio di database collegabile per connettersi al database collegabile.
   3. Nel campo ID utente inserire il nome del database.
   4. Nel campo password inserire la password del database.

   

3. Selezionare Connetti.

4. A questo punto nel menu Dettagli connessione viene visualizzata una nuova connessione.

5. Fare clic con il pulsante destro del mouse sulla connessione Oracle e scegliere Gestisci.

   

6. Selezionare Valutazione della migrazione.

   

7. Selezionare Esegui nuova valutazione.

   

8. Specificare i dettagli della valutazione.

   1. Nel campo Nome valutazione immettere, ad esempio, un titolo demo1.
   2. Immettere un’Impostazione di valutazione.

      1. Nel campo Piattaforma di destinazione immettere il database di destinazione della migrazione. Attualmente supporta Azure SQL e PostgreSQL come destinazioni.

         Nota

         La destinazione PostgreSQL è in anteprima. Questa opzione di destinazione verrà interrotta. È consigliabile esportare eventuali valutazioni precedenti.

      2. Nella sezione Raccolta dati sulle prestazioni selezionare Esegui raccolta dati sulle prestazioni nel database Oracle (connesso) o Aggiungi report AWR.

         È consigliabile usare l'opzione connessa se si esegue questo strumento durante un picco o un carico realistico. In caso contrario, specificare i report AWR generati in passato per le raccomandazioni relative alle prestazioni e al dimensionamento.

         Nota

         L'opzione di valutazione del report AWR non è abilitata per il database collegabile.

      3. Nel campo Fattore di scala immettere il valore del moltiplicatore.

         • Se lo SKU consigliato deve considerare altri picchi di carico, il moltiplicatore del fattore di scala dovrà essere maggiore di 1. Ad esempio, carico burst, utilizzo stagionale e pianificazione futura della capacità. Quando viene eseguita la migrazione di un carico di lavoro dello schema Oracle parziale, il moltiplicatore deve essere minore di 1.

      4. Nel campo Utilizzo percentile immettere il valore di percentile per il dimensionamento della destinazione di Azure.

         • Il valore di percentile dell'esempio di prestazioni da tenere in considerazione per il dimensionamento della destinazione di Azure.

   

9. Sono disponibili due tipi di valutazione:

   • Valutazione del carico di lavoro. In questa valutazione, il modulo di valutazione Oracle esegue un'individuazione leggera degli oggetti schema e classifica la complessità dello schema per la migrazione a varie categorie con una stima di alto livello per le ore di conversione. Questa valutazione preliminare consente di comprendere la fattibilità della migrazione alla piattaforma di destinazione.

   • Valutazione del codice. La valutazione del codice esegue una valutazione approfondita degli oggetti dello schema Oracle e suggerisce quindi un'idoneità complessiva degli oggetti di codice con "ready", "need review" e "not ready" a livello granulare e le ore di conversione associate con un'accuratezza maggiore.

     Nota

     L'estensione usa il convertitore di schemi Ora2Pg open source per le valutazioni del codice.

     Se il client Oracle e/o Ora2Pg non è installato nello stesso computer di Azure Data Studio, installarli manualmente o usare lo script di installazione Ora2Pg da GitHub.

     Se il client Oracle e Ora2Pg sono installati, assicurarsi che il percorso iniziale del client Oracle e il percorso di installazione Ora2Pg vengano aggiornati nelle impostazioni dell'estensione.

     • Quando si seleziona Valutazione del codice per gli scenari SQL, selezionare gli schemi a cui si desidera accedere per la conversione e la migrazione da Oracle a SQL. Per impostazione predefinita, per la valutazione vengono selezionati tutti gli schemi idonei.

10. Scegliere Esegui convalida per eseguire i prerequisiti e diverse regole di convalida correlate alle autorizzazioni di sicurezza, alle impostazioni di configurazione e così via. Se la convalida non riesce, è necessario correggere gli errori per continuare.

11. Al termine della convalida, è possibile selezionare Esegui valutazione.

12. Viene ora visualizzata la nuova valutazione nella sezione delle “Ultime cinque valutazioni”.

    

13. Selezionare il collegamento della valutazione per visualizzare la pagina dei dettagli di valutazione. È possibile visualizzare lo stato di valutazione più recente.

    

14. Selezionare Aggiorna o attendere il completamento della valutazione. Per impostazione predefinita, la pagina di stato della valutazione viene aggiornata ogni 15 secondi. Lo stato mostra uno dei quattro stati: operazione riuscita, operazione non riuscita, in corso o operazione annullata.

Visualizzare la valutazione

Al termine della valutazione, viene generato un output consolidato tramite schede per ogni destinazione Azure SQL: SQL Server in Macchine virtuali Azure, database SQL di Azure e Istanza gestita di SQL di Azure o Database di Azure per PostgreSQL - Server flessibile.

Ogni scheda ha più sezioni. La scheda mostra la fattibilità complessiva della migrazione alla destinazione. È possibile eseguire il drill-down su vari carichi di lavoro in varie categorie di complessità della migrazione:

• La sezione sulla compatibilità delle funzionalità fornisce il risultato della verifica della valutazione delle funzionalità.
• La raccomandazione sullo SKU fornisce il dimensionamento appropriato della destinazione.
• La valutazione del codice fornisce la complessità del codice degli oggetti di database.

Quando si seleziona Visualizza dettagli report, viene prima mostrato il riepilogo della valutazione.

Se la destinazione selezionata è Database per PostgreSQL di Azure, la scheda Dettagli database o Valutazione codice sarà disponibile in base alla selezione del tipo di valutazione.

La scheda di dettagli del database seguente fornisce il dettaglio in base allo schema. Mostra l'elenco di schemi individuati, la fattibilità della migrazione e il tempo stimato per convertire lo schema in ore.

Questa stima si basa su un modello statistico che si applica al conteggio degli oggetti, alle righe di codice, alle funzionalità abilitate e alle dimensioni del database. Per una stima più accurata sulla conversione del codice, usare la valutazione del codice.

La raccomandazione sullo SKU fornisce i seguenti elementi:

• Destinazione di Azure appropriata.

• Tre livelli di servizio.

• Le soglie delle metriche vengono usate per fornire lo SKU consigliato.

  

La raccomandazione sullo SKU valuta varie metriche delle prestazioni: CPU, memoria, operazioni di I/O al secondo, latenza e archiviazione. In base ai dati sull'utilizzo e sulla configurazione, vengono raccomandati la destinazione indicata e il livello di servizio appropriato. I consigli SKU si basano sull'istanza radicale del contenitore o sull'utilizzo del database collegabile. La selezione dello schema viene ignorata e non è disponibile per il ridimensionamento dello SKU.

La compatibilità del codice (solo per le destinazioni PostgreSQL) fornisce un riepilogo degli oggetti dello schema che possono essere convertiti nella destinazione di Azure. Il report fornisce l'interruzione degli oggetti che possono essere convertiti automaticamente, pronti con condizioni e devono essere corretti e convertiti manualmente.

Il report mostra il numero totale di oggetti e le ore di lavoro di conversione necessarie per eseguire la migrazione del codice al database PostgreSQL di Azure. L'immagine grafica fornisce l'interruzione per ogni tipo di oggetto schema, ad esempio tabelle, viste e cluster. Le attività vengono classificate come "Pronto - automaticamente convertite", "Richiede revisione" e "Non pronto - richiede la conversione manuale".

Un drill-down per le sezioni "Non pronto" e "Richiede revisione" fornisce l'elenco delle attività di correzione e le ore di lavoro per ogni attività.

La valutazione delle funzionalità fornisce le funzionalità di mappate di dati di destinazione da Oracle ad Azure e il lavoro richiesto per eseguirne la migrazione alla destinazione di Azure.

È possibile scaricare il report per la visualizzazione offline selezionando Download report combinati o Download singoli report.

È anche possibile annullare una valutazione in corso, eliminarne una e spostarle in un'altra directory.

Percorso di valutazione delle modifiche

1. Passare al marketplace delle estensioni e cercare Database Migration Assessment per Oracle.
2. Selezionare l’icona Gestisci, quindi selezionare le impostazioni Estensioni.
3. Specificare il nuovo percorso delle valutazioni in Oracle Assessment: Percorso delle valutazioni.

Risoluzione dei problemi

Registri

L'estensione contiene errori, avvisi e altri log di diagnostica nella directory di log predefinita:

• Windows - C:\Users\<username>.dmaoracle\logs\
• Linux: ~/.dmaoracle/logs
• macOS: /Users/<username>/.dmaoracle/logs

Per cambiare la directory di log, aggiornare la proprietà LogDirectory nel file delle impostazioni dell'estensione.

Per altre informazioni sulla risoluzione dei problemi, vedere Risoluzione dei problemi relativi a Database Migration Assessment per gli errori di estensione Oracle.

Problemi noti e limitazioni

• Il percorso specificato non esiste.

  Motivo: file o autorizzazioni mancanti per la cartella della valutazione.

  Possibile soluzione:

  • L'utente ha l'autorizzazione di lettura e scrittura per la cartella della valutazione.
  • In caso di file o cartelle mancanti, eliminare la valutazione e generarne una nuova.

• È stata rilevata un'eccezione di timeout della connessione durante l'interazione con Oracle.

  Motivo: non è possibile connettersi all'istanza di Oracle.

  Possibile soluzione:

  • Controllare se le regole del firewall bloccano la porta di ascolto Oracle.
  • Eseguire tnsping e verificare se l'ID servizio viene risolto.

Contattare Microsoft per assistenza

Se è necessaria ulteriore assistenza da Microsoft, contattare @dmasupport. Per un turnaround più rapido, è possibile allegare i log dall'elenco log predefinito.

Contenuto correlato

• Estensione per Oracle (anteprima)
• Estensione di migrazione di Azure SQL per Azure Data Studio
• Toolkit di conversione schema di database (DSCT)
• Estendere la funzionalità di Azure Data Studio