Installare i componenti SSMA in SQL Server (OracleToSQL)

Oltre all'installazione di SQL Server Migration Assistant (SSMA), è necessario installare anche i componenti nel computer che esegue SQL Server. Questi componenti includono il pacchetto di estensione SSMA, che supporta la migrazione dei dati e i provider Oracle per abilitare la connettività da server a server.

Pacchetto di estensione SSMA per Oracle

Il pacchetto di estensione SSMA installa le stored procedure estese e aggiunge il database sysdb all'istanza specificata di SQL Server. Le stored procedure estese forniscono funzionalità necessarie per emulare funzionalità e comportamento di Oracle, mentre il sysdb database contiene le tabelle e le stored procedure necessarie per eseguire la migrazione dei dati.

Inoltre, quando si esegue la migrazione dei dati a SQL Server, SSMA crea processi di SQL Server Agent quando viene usato il motore di migrazione dei dati sul lato server per la migrazione dei dati.

Prerequisiti

Prima di installare i componenti del server SSMA per Oracle in SQL Server, assicurarsi che il sistema soddisfi i requisiti seguenti:

• Windows 11 e versioni successive oppure Windows Server 2022 e versioni successive.

• .NET Framework versione 4.7.2 o successiva. Scaricare .NET Framework.

• Viene installata un'istanza di SQL Server.

• Provider OLE DB per Oracle (se si usa OLE DB) e connettività al database Oracle di cui si vuole eseguire la migrazione. Si possono installare provider dai media del prodotto Oracle o dal sito Web Oracle.

  Importante

  Le stored procedure estese del pacchetto di estensione SSMA non sono compatibili con le regole di confronto del server UTF-8 , ad esempio Latin1_General_100_CI_AI_SC_UTF8. Le funzioni generate da SSMA dichiarano i parametri di output di tipo varchar(max), che il driver ODBC interno mappa ai tipi LOB precedenti. Nei server che usano regole di confronto UTF-8, anche il database master utilizza UTF-8, il che provoca il fallimento della chiamata di loopback dalle procedure memorizzate estese. Con ODBC Driver 17, questo errore produce silenziosamente risultati errati. Con ODBC Driver 18 viene visualizzato l'errore : Cannot convert to text/ntext or collate to 'Latin1_General_100_CI_AI_SC_UTF8'. Se il server usa regole di confronto UTF-8, non fare affidamento sulle stored procedure estese del pacchetto di estensione SSMA.

• Il servizio SQL Server Browser deve essere in esecuzione durante l'installazione. Il servizio compila l'elenco delle istanze di SQL Server nella procedura guidata di installazione. È possibile disabilitare il servizio SQL Server Browser dopo l'installazione.

  Se il servizio SQL Server Browser è in esecuzione, ma non viene ancora visualizzato un elenco di istanze in Configurazione, è necessario sbloccare la porta UDP 1434. È possibile usare Windows Firewall per sbloccare temporaneamente la porta oppure disabilitare temporaneamente Windows Firewall. Potrebbe anche essere necessario disabilitare temporaneamente il software antivirus. Assicurarsi di abilitare firewall e software antivirus dopo l'installazione.

Installare il pacchetto di estensione

È possibile installare il pacchetto di estensione in qualsiasi momento prima di eseguire la migrazione dei dati a SQL Server.

Per installare il pacchetto di estensione:

1. Copiare SSMAforOracleExtensionPack_<n>.msi (dove <n> è il numero di build) nel computer che esegue SQL Server.

2. Fai doppio clic sul file MSI per eseguirlo.

3. Nella pagina Iniziale, fare clic su Avanti.

4. Nella pagina dell'Accordo di licenza dell'Utente finale, leggere l'accordo di licenza. Se si è d’accordo, selezionare Accetto il contratto e quindi Avanti.

5. Nella pagina Scegli tipo di installazione, selezionare Tipico.

6. Nella pagina Inizio installazione fare clic su Installa.

7. Nella pagina Completato il primo passaggio di installazione selezionare Avanti.

   Verrà visualizzata una nuova finestra di dialogo. Selezionare il tipo di pacchetto di estensione.

8. Selezionare il tipo di installazione desiderato e quindi selezionare Avanti.

   Importante

   Usare l'opzione remota solo quando si installa il pacchetto di estensione in SQL Server in esecuzione in Linux o quando la destinazione è Istanza gestita di SQL di Azure. Installare sempre il pacchetto di estensione in locale per le installazioni di SQL Server in esecuzione in Windows. database SQL di Azure e Azure Synapse Analytics non supportano il pacchetto di estensione.

   Se si installa il pacchetto di estensione in un'istanza locale SQL Server, è possibile scegliere un'istanza locale di SQL Server in cui si esegue la migrazione degli schemi Oracle. Scegliere un'istanza nell'elenco a discesa e quindi selezionare Avanti.

   L'istanza predefinita ha lo stesso nome del computer. Le istanze denominate sono seguite da una barra rovesciata e dal nome dell'istanza.

9. Nella pagina di connessione selezionare il metodo di autenticazione e quindi selezionare Avanti.

   L'autenticazione di Windows usa le credenziali di Windows per provare ad accedere all'istanza di SQL Server. Se si seleziona Autenticazione server, è necessario immettere un nome di accesso e una password di SQL Server.

10. Il passaggio successivo richiede di impostare la password per una chiave master che crittografa tutti i dati sensibili archiviati nel database del pacchetto di estensione durante la migrazione dei dati sul lato server. Specificare una password complessa e selezionare Avanti.

11. Nella pagina successiva selezionare Install Utilities Database n (Installa database n) e Install Extension Pack libraries (Installa librerie del Pacchetto di estensione), dove n è il numero di versione e quindi selezionare Avanti.

    Il sysdb database viene creato con le tabelle e le stored procedure necessarie per la migrazione dei dati vengono create in questo database (usando il motore di migrazione dei dati sul lato server).

12. Al termine dell'installazione, viene visualizzato un prompt che chiede se si vuole installare Il database delle utilità in un'altra istanza di SQL Server. Selezionare Sì e quindi Avanti. Per uscire dalla procedura guidata, selezionare No e quindi esci.

13. In SQL Server Management Studio o tramite l'utilità sqlcmd eseguire lo script seguente per abilitare CLR:

    EXECUTE sp_configure 'clr enabled', 1;
    GO
    
    RECONFIGURE;
    GO
    

    Se CLR non è abilitato, viene visualizzato l'errore seguente quando SSMA si connette a SQL Server:

    SSMA could not retrieve the extension pack assembly version information. Reinstall the extension pack on the database server.
    

Oggetti di database di SQL Server

Dopo aver installato il pacchetto di estensione, la ssma_oracle.bcp_migration_packages tabella viene visualizzata nel sysdb database.

Ogni volta che si esegue la migrazione dei dati a SQL Server, SSMA crea un'attività di SQL Server Agent. Questi processi sono denominati ssma_oracle data migration package {GUID}ed è possibile visualizzarli nel nodo SQL Server Agent di SQL Server Management Studio nella cartella Processi.

Al database master vengono aggiunte le seguenti stored procedure estese:

• xp_ora2ms_exec2
• xp_ora2ms_exec2_ex
• xp_ora2ms_versioninfo2

Contenuti correlati

• Installare SSMA per il client Oracle
• Eseguire la migrazione di database Oracle a SQL Server
• Ordinamento e supporto Unicode