Estensione Database Migration Assessment per Oracle

L'estensione Valutazione della migrazione del database per Oracle in Azure Data Studio consente di valutare un carico di lavoro Oracle per la migrazione ad Azure SQL e Database di Azure per PostgreSQL. L'estensione identifica una destinazione SQL di Azure o PostgreSQL appropriata con raccomandazioni di ridimensionamento appropriate e la complessità della migrazione.

Prerequisiti

• Azure Data Studio versione 1.39 o successiva.
• Un database Oracle che esegue la versione 11g o successiva.
• Agli utenti Oracle devono essere assegnati privilegi CONNECT e edizione Standard LECT ANY DICTIONARY.

Installare l'estensione di Azure Data Studio

Seguire questa procedura per installare l'estensione Valutazione migrazione del database per Oracle in Azure Data Studio.

1. Aprire 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. Seleziona Installa.

   

Configurare le impostazioni dell'estensione

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

1. Passare alle estensioni e selezionare Valutazione migrazione del database 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 ion 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 ORACLE_HOME variabile di ambiente sia impostata e che il TNSNAMES.ORA file si trovi in <ORACLE_HOME>/network/admin folder.
      2. Per il database contenitore, è possibile connettere il database radice del contenitore usando l'ID del servizio CDB oppure usare il nome del servizio di database collegabile per connettersi al database collegabile.
   3. Specificare il nome utente del database nel campo ID utente.
   4. Specificare la password del database nel campo Password .

   

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 un titolo, demo1ad esempio .
   2. Immettere un'impostazione per Valutazione.

      1. Immettere il database di migrazione di destinazione nel campo Piattaforma di destinazione. Attualmente supporta SQL di Azure e PostgreSQL come destinazioni.

         Nota

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

      2. Nella sezione Raccolta dati prestazioni selezionare Esegui raccolta dati 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. Immettere il valore del moltiplicatore nel campo Fattore di scala .

         • Se lo SKU consigliato deve prendere in considerazione altri carichi di picco, il moltiplicatore del fattore di scala deve 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. Esistono 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 trovare 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 vuole 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 varie 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. Ora viene visualizzata la nuova valutazione nella sezione "Ultime cinque valutazioni".

    

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

    

14. Selezionare Aggiorna oppure 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: esito positivo, non riuscito, in corso o annullato.

Visualizzare la valutazione

Al termine della valutazione, viene generato un output consolidato tramite schede per ogni destinazione SQL di Azure: SQL Server in Azure Macchine virtuali, 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 relativa alla compatibilità delle funzionalità fornisce il risultato della revisione 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 i dettagli del report, viene prima visualizzato il riepilogo della valutazione.

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

Nella scheda Dettagli database seguente viene fornita la suddivisione per ogni base dello schema. Mostra l'elenco degli schemi individuati, la fattibilità della migrazione e il tempo stimato per convertire lo schema in ore.

Questa stima è basata su un modello statistico che si applica al numero di 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.

Nota

Gli schemi predefiniti oracle o di sistema seguenti sono esclusi dalla valutazione del carico di lavoro:

APEX, APPQOSSYS, AUDSYS, CSMIG, CTXSYS, DBMS_PRIVILEGE_CAPTURE, DBSFWUSER, DBSNMP, DIP, DMSYS, DVF, DVSYS, EXFSYS, FLOW_, GSMADMIN_INTERNAL, LBACSYS, MDDATA, MDSYS, MGDSYS, MGMT_VIEW, MTMSYS, ODM, ODM_MTR, OJVMSYS, OLAPSYS, ORACLE_OCM, ORDDATA, ORDPLUGINS, ORDSYS, OSE$HTTP$ADMIN, OUTLN, OWBSYS, OWBSYS_AUDIT, PERFSTAT, SDE, SI_INFORMTN_SCHEMA, SPATIAL_CSW_ADMIN_USR, SPATIAL_WFS_ADMIN_USR, SQLTXPLAIN, SYS, SYSMAN, SYSTEM, TRACESRV, TSMSYS, WEBSYS, WKPROXY, WKSYS, WK_PROXY, WK_TEST, WMSYS, XDB, XS$NULL

La raccomandazione sku fornisce gli elementi seguenti:

• Destinazione di Azure appropriata.

• Livello di servizio.

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

  

La raccomandazione sku valuta varie metriche delle prestazioni, ad esempio CPU, memoria, operazioni di I/O al secondo, latenza e archiviazione. In base all'utilizzo e ai dati di configurazione, lo strumento di raccomandazione fornisce la destinazione appropriata e il livello di servizio appropriato. La raccomandazione sku si basa sull'istanza radice del contenitore o sull'utilizzo del database collegabile. La selezione dello schema viene ignorata e non applicabile al ridimensionamento dello SKU.

Nota

Se la funzionalità del repository del carico di lavoro automatico (AWR) è abilitata nell'istanza oracle, lo SKU recommender userà le DBA_HIST_ visualizzazioni per raccogliere i metadati delle metriche delle prestazioni. In caso contrario, il consigliatore userà la configurazione del server e altre informazioni sulla visualizzazione di sistema per ridimensionare la destinazione SQL di Azure.

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 "Ready - automatically convert", "Needs review" e "Not ready - richiede la conversione manuale".

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

La valutazione delle funzionalità fornisce le funzionalità mappate da Oracle a Destinazione dati di Azure e il lavoro necessario per eseguire la migrazione di tali funzionalità alla destinazione di Azure.

È possibile scaricare il report per la visualizzazione offline selezionando Scarica report combinati o Scarica 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 Valutazione migrazione del database per Oracle.
2. Selezionare l'icona Gestisci e selezionare Impostazioni estensioni.
3. Specificare il nuovo percorso delle valutazioni in Oracle Assessment: Percorso delle valutazioni.

Risoluzione dei problemi

Registri

L'estensione archivia 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

Nota

Per impostazione predefinita, l'estensione archivia gli ultimi sette file di log.

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

Sistema operativo	Percorso
Windows	C:\Users\<username>\.azuredatastudio\extensions\microsoft.azuredatastudio-dma-oracle-<VersionNumber>\bin\service\Properties\ConfigSettings\extension-settings.json
Linux	~/.azuredatastudio/extensions/microsoft.azuredatastudio-dma-oracle-<VersionNumber>/<VersionNumber>/bin/service/Properties/ConfigSettings/extension-settings.json
macOS	/Users/<username>/.azuredatastudio/extensions/microsoft.azuredatastudio-dma-oracle-<VersionNumber>/<VersionNumber>/bin/service/Properties/ConfigSettings/extension-settings.json

Per altre informazioni sulla risoluzione dei problemi, vedere Risolvere gli errori di valutazione della migrazione del database 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 dispone dell'autorizzazione di lettura e scrittura per la cartella di valutazione.
  • Se è presente un file o una cartella mancante, eliminare la valutazione e generare una nuova valutazione.

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

  Motivo: impossibile 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.

Per assistenza, contattare Microsoft

Se è necessaria ulteriore assistenza da Microsoft, contattare @dmasupport. Per velocizzare il turnaround, è possibile allegare i log dalla directory di log predefinita.

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