Installera SSMA-komponenter på SQL Server (OracleToSQL)

Förutom att installera SQL Server Migration Assistant (SSMA) måste du även installera komponenter på datorn som kör SQL Server. Dessa komponenter inkluderar SSMA-tilläggspaketet, som stöder datamigrering, och Oracle-leverantörer för att aktivera server-till-server-anslutning.

SSMA för Oracle-tilläggspaket

SSMA-tilläggspaketet distribuerar utökade lagrade procedurer och lägger sysdb till databasen i den angivna instansen av SQL Server. Utökade lagrade procedurer ger funktioner som krävs för att emulera funktioner och beteende för Oracle, medan sysdb databasen innehåller de tabeller och lagrade procedurer som krävs för att migrera data.

När du migrerar data till SQL Server skapar SSMA dessutom SQL Server Agent-jobb när datamigreringsmotorn på serversidan används för att migrera data.

Förutsättningar

Innan du installerar SSMA för Oracle-serverkomponenter på SQL Server kontrollerar du att systemet uppfyller följande krav:

• Windows 11 och senare versioner, eller Windows Server 2022 och senare versioner.

• .NET Framework version 4.7.2 eller senare. Ladda ned .NET Framework.

• En SQL Server-instans är installerad.

• OLE DB-providern för Oracle (om du använder OLE DB) och anslutningen till Oracle-databasen som du vill migrera. Du kan installera leverantörer från Oracle-produktmediet eller Oracles webbplats.

  Viktigt!

  Utökade lagrade procedurer för SSMA-tilläggspaketet är inte kompatibla med UTF-8-serversortering (till exempel Latin1_General_100_CI_AI_SC_UTF8). De SSMA-genererade funktionerna deklarerar utdataparametrar som varchar(max), som den interna ODBC-drivrutinen mappar till äldre LOB-typer. På servrar som använder en UTF-8-sortering master använder databasen även UTF-8, vilket gör att loopback-anropet från de utökade lagrade procedurerna misslyckas. Med ODBC Driver 17 leder det här felet till felaktiga resultat utan varning. Med ODBC Driver 18 får du felet: Cannot convert to text/ntext or collate to 'Latin1_General_100_CI_AI_SC_UTF8'. Om servern använder en UTF-8-sortering ska du inte förlita dig på utökade lagrade procedurer för SSMA-tilläggspaketet.

• SQL Server Browser-tjänsten måste köras under installationen. Tjänsten fyller i en lista över instanserna av SQL Server i installationsguiden. Du kan inaktivera SQL Server Browser-tjänsten efter installationen.

  Om SQL Server Browser-tjänsten körs, men du fortfarande inte ser någon lista över instanser i installationsprogrammet, måste du avblockera UDP-port 1434. Du kan använda Windows-brandväggen för att tillfälligt avblockera porten, eller så kan du tillfälligt inaktivera Windows-brandväggen. Du kan också tillfälligt behöva inaktivera antivirusprogram. Se till att aktivera brandväggar och antivirusprogram efter installationen.

Installera tilläggspaketet

Du kan installera tilläggspaketet när som helst innan du migrerar data till SQL Server.

Så här installerar du tilläggspaketet:

1. Kopiera SSMAforOracleExtensionPack_<n>.msi (där <n> är versionsnumret) till datorn som kör SQL Server.

2. Dubbelklicka på MSI för att köra den.

3. På sidan Välkommen väljer du Nästa.

4. På sidan End-User licensavtal läser du licensavtalet. Om du godkänner väljer du jag godkänner avtaletoch väljer sedan Nästa.

5. På sidan Välj installationstyp väljer du Typisk.

6. På sidan Redo att installera väljer du Installera.

7. På sidan Slutfört det första installationssteget väljer du Nästa.

   En ny dialogruta visas. Välj typ av tilläggspaket.

8. Välj önskad installationstyp och välj sedan Nästa.

   Viktigt!

   Använd endast fjärralternativet när du installerar tilläggspaketet på SQL Server körs på Linux eller när du riktar in dig på Azure SQL Managed Instance. Installera alltid tilläggspaketet lokalt för SQL Server installationer som körs på Windows. Azure SQL Database och Azure Synapse Analytics stöder inte tilläggspaketet.

   Om du installerar tilläggspaketet på en lokal SQL Server instans kan du välja en lokal instans av SQL Server som du migrerar Oracle-scheman till. Välj en instans i listrutan och välj sedan Nästa.

   Standardinstansen har samma namn som datorn. Namngivna instanser följs av ett omvänt snedstreck och instansnamnet.

9. På anslutningssidan väljer du autentiseringsmetoden och väljer sedan Nästa.

   Windows-autentisering använder dina Windows-autentiseringsuppgifter för att försöka logga in på instansen av SQL Server. Om du väljer Serverautentisering måste du ange ett SQL Server-inloggningsnamn och lösenord.

10. Nästa steg kräver att du anger lösenordet för en huvudnyckel som krypterar känsliga data som lagras i tilläggspaketdatabasen under datamigreringen på serversidan. Ange ett starkt lösenord och välj Nästa.

11. På nästa sida väljer du Installera Utilities Database n och Installera tilläggspaketbibliotek, där n är versionsnumret, och väljer sedan Nästa.

    Databasen sysdb skapas med tabellerna och lagrade procedurer som krävs för datamigrering skapas i den här databasen (med hjälp av datamigreringsmotorn på serversidan).

12. När installationen är klar visas en fråga som frågar om du vill installera Utilities Database på en annan instans av SQL Server. Välj Ja och välj sedan Nästa. Avsluta guiden genom att välja Nej och sedan Avsluta.

13. I SQL Server Management Studio eller med hjälp sqlcmd av verktyget kör du följande skript för att aktivera CLR:

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

    Om CLR inte är aktiverat får du följande fel när SSMA ansluter till SQL Server:

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

SQL Server-databasobjekt

När du har installerat tilläggspaketet ssma_oracle.bcp_migration_packages visas tabellen i sysdb databasen.

Varje gång du migrerar data till SQL Server skapar SSMA ett SQL Server Agent-jobb. De här jobben heter ssma_oracle data migration package {GUID}och du kan se dem i noden SQL Server Agent i SQL Server Management Studio i mappen Jobb.

Följande utökade lagrade procedurer läggs till i master databasen:

• xp_ora2ms_exec2
• xp_ora2ms_exec2_ex
• xp_ora2ms_versioninfo2

Relaterat innehåll

• Installera SSMA för Oracle-klienten
• Migrera Oracle-databaser till SQL Server
• Stöd för sortering och Unicode