SSMA-onderdelen installeren op SQL Server (OracleToSQL)

Naast het installeren van SQL Server Migration Assistant (SSMA), moet u ook onderdelen installeren op de computer waarop SQL Server wordt uitgevoerd. Deze onderdelen omvatten het SSMA-extensiepakket, dat ondersteuning biedt voor gegevensmigratie en Oracle-providers om server-naar-serverconnectiviteit mogelijk te maken.

SSMA voor Oracle-extensiepakket

Het SSMA-extensiepakket implementeert uitgebreide opgeslagen procedures en voegt de sysdb database toe aan het opgegeven exemplaar van SQL Server. Uitgebreide opgeslagen procedures bieden functionaliteit die nodig is om functies en gedrag van Oracle te emuleren, terwijl de sysdb database de tabellen en opgeslagen procedures bevat die nodig zijn om de gegevens te migreren.

Wanneer u gegevens migreert naar SQL Server, maakt SSMA ook SQL Server Agent-taken wanneer de gegevensmigratie-engine aan de serverzijde wordt gebruikt voor het migreren van de gegevens.

Vereiste voorwaarden

Voordat u de SSMA voor Oracle-serveronderdelen op SQL Server installeert, moet u ervoor zorgen dat het systeem voldoet aan de volgende vereisten:

• Windows 11 en latere versies, of Windows Server 2022 en latere versies.

• De .NET Framework-versie 4.7.2 of een nieuwere versie. Download .NET Framework.

• Er is een SQL Server-exemplaar geïnstalleerd.

• De OLE DB-provider voor Oracle (als u OLE DB gebruikt) en connectiviteit met de Oracle-database die u wilt migreren. U kunt providers installeren vanaf de Oracle-productmedia of de Oracle-website.

  Belangrijk

  Uitgebreide opgeslagen procedures voor het SSMA-extensiepakket zijn niet compatibel met UTF-8-serversorteringen (bijvoorbeeld Latin1_General_100_CI_AI_SC_UTF8). De door SSMA gegenereerde functies declareren uitvoerparameters als varchar(max), die door het interne ODBC-stuurprogramma worden toegewezen aan verouderde LOB-typen. Op servers die een UTF-8-sortering gebruiken, gebruikt de master database ook UTF-8, waardoor de loopback-aanroep van de uitgebreide opgeslagen procedures mislukt. Met ODBC-stuurprogramma 17 leidt dit stilzwijgend tot onjuiste resultaten. Met ODBC-stuurprogramma 18 krijgt u de volgende foutmelding: Cannot convert to text/ntext or collate to 'Latin1_General_100_CI_AI_SC_UTF8'. Als uw server gebruikmaakt van een UTF-8-sortering, vertrouwt u niet op de uitgebreide opgeslagen procedures van het SSMA-extensiepakket.

• De SQL Server Browser-service moet worden uitgevoerd tijdens de installatie. De service vult in de Setup-wizard een lijst van de SQL Server-instanties in. U kunt de SQL Server Browser-service uitschakelen na de installatie.

  Als de SQL Server Browser-service wordt uitgevoerd, maar u nog steeds geen lijst met exemplaren ziet in Setup, moet u UDP-poort 1434 deblokkeren. U kunt Windows Firewall gebruiken om de poort tijdelijk te deblokkeren of u kunt Windows Firewall tijdelijk uitschakelen. Mogelijk moet u ook tijdelijk antivirussoftware uitschakelen. Zorg ervoor dat u firewalls en antivirussoftware inschakelt na de installatie.

Het extensiepakket installeren

U kunt het extensiepakket op elk gewenst moment installeren voordat u gegevens naar SQL Server migreert.

Het extensiepakket installeren:

1. Kopieer SSMAforOracleExtensionPack_<n>.msi (waar <n> is het buildnummer) naar de computer waarop SQL Server wordt uitgevoerd.

2. Dubbelklik op de MSI om deze uit te voeren.

3. Selecteer Volgende op de welkomstpagina.

4. Lees de gebruiksovereenkomst op de End-User License Agreement pagina. Als u akkoord gaat, selecteert u ik ga akkoord met de overeenkomsten selecteert u vervolgens Volgende.

5. Op de pagina Type installatie kiezen, selecteer Standaard.

6. Selecteer op de pagina Gereed om te installeren Installeren.

7. Selecteer Volgende op de pagina Voltooide eerste stap van de installatie.

   Er wordt een nieuw dialoogvenster weergegeven. Selecteer het type uitbreidingspakket.

8. Selecteer het gewenste installatietype en selecteer vervolgens Volgende.

   Belangrijk

   Gebruik de externe optie alleen wanneer u het extensiepakket installeert op SQL Server wordt uitgevoerd in Linux of wanneer u zich op Azure SQL Managed Instance richt. Installeer het extensiepakket altijd lokaal voor SQL Server installaties die worden uitgevoerd op Windows. Azure SQL Database en Azure Synapse Analytics bieden geen ondersteuning voor het extensiepakket.

   Als u het extensiepakket installeert op een lokaal SQL Server exemplaar, kunt u een lokaal exemplaar van SQL Server kiezen waarnaar u Oracle-schema's migreert. Kies een instantie in de vervolgkeuzelijst en selecteer vervolgens Volgende.

   Het standaardexemplaar heeft dezelfde naam als de computer. Benoemde exemplaren worden gevolgd door een backslash en de naam van het exemplaar.

9. Selecteer op de verbindingspagina de verificatiemethode en selecteer vervolgens Volgende.

   Windows-verificatie gebruikt uw Windows-referenties om u aan te melden bij het exemplaar van SQL Server. Als u Serververificatie selecteert, moet u een SQL Server-aanmeldingsnaam en -wachtwoord invoeren.

10. Voor de volgende stap moet u het wachtwoord instellen voor een hoofdsleutel waarmee gevoelige gegevens worden versleuteld die zijn opgeslagen in de extensiepakketdatabase tijdens gegevensmigratie aan de serverzijde. Geef een sterk wachtwoord op en selecteer Volgende.

11. Op de volgende pagina selecteert u Install Utilities Database n en Install Extension Pack-bibliotheken, waarbij n het versienummer is en selecteert u Volgende.

    De sysdb database wordt gemaakt met de tabellen en opgeslagen procedures die vereist zijn voor gegevensmigratie, worden gemaakt in deze database (met behulp van de gegevensmigratie-engine aan de serverzijde).

12. Wanneer de installatie is voltooid, wordt er een prompt weergegeven waarin wordt gevraagd of u Utilities Database wilt installeren op een ander exemplaar van SQL Server. Selecteer Ja en selecteer vervolgens Volgende. Als u de wizard wilt afsluiten, selecteert u Nee en selecteert u Vervolgens Afsluiten.

13. Voer in SQL Server Management Studio of met behulp van het sqlcmd hulpprogramma het volgende script uit om CLR in te schakelen:

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

    Als CLR niet is ingeschakeld, wordt de volgende fout weergegeven wanneer SSMA verbinding maakt met SQL Server:

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

SQL Server-databaseobjecten

Nadat u het extensiepakket hebt geïnstalleerd, wordt de ssma_oracle.bcp_migration_packages tabel weergegeven in de sysdb database.

Telkens wanneer u gegevens naar SQL Server migreert, maakt SSMA een SQL Server Agent-taak. Deze taken heten ssma_oracle data migration package {GUID}, en u kunt ze zien onder het knooppunt SQL Server Agent van SQL Server Management Studio in de map Jobs.

De volgende uitgebreide opgeslagen procedures worden toegevoegd aan de master database:

• xp_ora2ms_exec2
• xp_ora2ms_exec2_ex
• xp_ora2ms_versioninfo2

Verwante inhoud

• SSMA installeren voor Oracle-client
• Oracle-databases migreren naar SQL Server
• Ondersteuning voor sortering en Unicode