Installer des composants SSMA sur SQL Server (OracleToSQL)

Outre l’installation de Assistant Migration SQL Server (SSMA), vous devez également installer des composants sur l’ordinateur qui s’exécute SQL Server. Ces composants incluent le pack d’extension SSMA, qui prend en charge la migration des données et les fournisseurs Oracle pour activer la connectivité serveur à serveur.

Pack d’extensions SSMA pour Oracle

Le pack d’extension SSMA déploie des procédures stockées étendues et ajoute la sysdb base de données à l’instance spécifiée de SQL Server. Les procédures stockées étendues fournissent des fonctionnalités requises pour émuler les fonctionnalités et le comportement d’Oracle, tandis que la sysdb base de données contient les tables et les procédures stockées requises pour migrer les données.

En outre, lorsque vous migrez des données vers SQL Server, SSMA crée des travaux SQL Server Agent lorsque le moteur de migration de données côté serveur est utilisé pour migrer les données.

Prerequisites

Avant d’installer les composants de serveur SSMA pour Oracle sur SQL Server, assurez-vous que le système répond aux exigences suivantes :

• Windows 11 et versions ultérieures, ou Windows Server 2022 et versions ultérieures.

• .NET Framework version 4.7.2 ou ultérieure. Téléchargez .NET Framework.

• Une instance SQL Server est installée.

• Fournisseur OLE DB pour Oracle (si vous utilisez OLE DB) et connectivité à la base de données Oracle que vous souhaitez migrer. Vous pouvez installer des fournisseurs à partir du support de produit Oracle ou du site Web Oracle.

  Important

  Les procédures stockées étendues du pack d’extension SSMA ne sont pas compatibles avec les classements de serveur UTF-8 (par exemple). Latin1_General_100_CI_AI_SC_UTF8 Les fonctions générées par SSMA déclarent des paramètres de sortie en tant que varchar(max), que le pilote ODBC interne mappe aux types LOB hérités. Sur les serveurs qui utilisent une collation UTF-8, la base de données master utilise également UTF-8, ce qui entraîne l’échec de l’appel loopback à partir des procédures stockées étendues. Avec ODBC Driver 17, cette défaillance produit des résultats incorrects en mode silencieux. Avec ODBC Driver 18, vous recevez l’erreur : Cannot convert to text/ntext or collate to 'Latin1_General_100_CI_AI_SC_UTF8'. Si votre serveur utilise un classement UTF-8, ne vous fiez pas aux procédures stockées étendues du pack d’extension SSMA.

• Le service SQL Server Browser doit s’exécuter pendant l’installation. Le service renseigne la liste des instances de SQL Server dans l’assistant d’installation. Vous pouvez désactiver le service SQL Server Browser après l’installation.

  Si le service SQL Server Browser est en cours d’exécution, mais que vous ne voyez toujours pas la liste des instances dans le programme d’installation, vous devez débloquer le port UDP 1434. Vous pouvez utiliser le Pare-feu Windows pour débloquer temporairement le port, ou désactiver temporairement le Pare-feu Windows. Vous devrez peut-être également désactiver temporairement les logiciels antivirus. Veillez à activer les pare-feu et les logiciels antivirus après l’installation.

Installer le pack d’extensions

Vous pouvez installer le pack d’extensions à tout moment avant de migrer des données vers SQL Server.

Pour installer le pack d’extensions :

1. Copiez SSMAforOracleExtensionPack_<n>.msi (où <n> se trouve le numéro de build) sur l’ordinateur exécutant SQL Server.

2. Double-cliquez sur le fichier MSI pour l’exécuter.

3. Sur la page d’accueil, sélectionnez Suivant.

4. Sur la page Accord de licence de l'utilisateur final, lisez le contrat de licence. Si vous acceptez, sélectionnez J’accepte le contrat, puis sélectionnez Suivant.

5. Dans la page Choisir le type de configuration , sélectionnez Classique.

6. Dans la page Prêt pour l'installation , sélectionnez Installer.

7. Dans la page Terminer la première étape de l’installation , sélectionnez Suivant.

   Une nouvelle boîte de dialogue s’affiche. Sélectionnez le type de pack d’extension.

8. Sélectionnez le type d’installation souhaité, puis sélectionnez Suivant.

   Important

   Utilisez l’option distante uniquement lors de l’installation du pack d’extensions sur SQL Server s’exécutant sur Linux ou lors du ciblage de Azure SQL Managed Instance. Installez toujours le pack d’extensions localement pour les installations SQL Server s’exécutant sur Windows. Azure SQL Database et Azure Synapse Analytics ne prennent pas en charge le pack d'extension.

   Si vous installez le pack d’extensions sur une instance de SQL Server locale, vous pouvez choisir une instance locale de SQL Server vers laquelle vous migrez des schémas Oracle. Choisissez une instance dans la liste déroulante, puis sélectionnez Suivant.

   L’instance par défaut porte le même nom que l’ordinateur. Les instances nommées sont suivies d’un backslash et du nom de l’instance.

9. Dans la page de connexion, sélectionnez la méthode d’authentification, puis sélectionnez Suivant.

   L’authentification Windows utilise vos informations d’identification Windows pour essayer de se connecter à l’instance de SQL Server. Si vous sélectionnez Authentification du serveur, vous devez entrer un nom de connexion et un mot de passe SQL Server.

10. L’étape suivante vous oblige à définir le mot de passe d’une clé principale qui chiffre les données sensibles stockées dans la base de données du pack d’extensions pendant la migration des données côté serveur. Fournissez un mot de passe fort, puis sélectionnez Suivant.

11. Dans la page suivante, sélectionnez Installer la base de données utilitaires n et installez les bibliothèques de pack d’extension, où n est le numéro de version, puis sélectionnez Suivant.

    La sysdb base de données est créée avec les tables et les procédures stockées requises pour la migration des données sont créées dans cette base de données (à l’aide du moteur de migration de données côté serveur).

12. Une fois l’installation terminée, une invite s’affiche pour demander si vous souhaitez installer Utilities Database sur une autre instance de SQL Server. Sélectionnez Oui, puis sélectionnez Suivant. Pour quitter l’assistant, sélectionnez Non, puis sélectionnez Quitter.

13. Dans SQL Server Management Studio ou à l’aide de l’utilitaire sqlcmd , exécutez le script suivant pour activer CLR :

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

    Si CLR n'est pas activé, vous recevez l'erreur suivante lorsque SSMA se connecte à SQL Server :

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

Objets de base de données SQL Server

Après avoir installé le pack d’extensions, la ssma_oracle.bcp_migration_packages table apparaît dans la sysdb base de données.

Chaque fois que vous migrez des données vers SQL Server, SSMA crée un travail SQL Server Agent. Ces travaux sont nommés ssma_oracle data migration package {GUID}et vous pouvez les voir dans le nœud SQL Server Agent de SQL Server Management Studio dans le dossier Travaux.

Les procédures stockées étendues suivantes sont ajoutées à la master base de données :

• xp_ora2ms_exec2
• xp_ora2ms_exec2_ex
• xp_ora2ms_versioninfo2

Contenu connexe

• Installer SSMA pour le client Oracle
• Migrer des bases de données Oracle vers SQL Server
• Prise en charge d’Unicode et des classements