Extension Database Migration Assessment pour Oracle

Remarque

Cette extension sera mis hors service le 15 décembre 2024. Nous cesserons de prendre en charge cet outil pour tous les problèmes qui pourront survenir et nous ne publierons plus de correctifs de bogues ni de mises à jour supplémentaires.

L’extension Database Migration Assessment pour Oracle dans Azure Data Studio vous aide à évaluer une charge de travail Oracle à migrer vers Azure SQL et Azure Database pour PostgreSQL. L’extension identifie une cible Azure SQL ou PostgreSQL appropriée avec des recommandations sur le dimensionnement approprié et des indications sur la complexité de la migration.

Prérequis

• Azure Data Studio version 1.39 ou ultérieure.
• Un Oracle Database exécutant la version 11 g ou ultérieure.
• Les utilisateurs Oracle doivent disposer des privilèges CONNECT et SELECT ANY DICTIONARY.

Installer l’extension Azure Data Studio

Suivez ces étapes pour installer Database Migration Assessment pour l’extension Oracle dans Azure Data Studio.

1. Ouvrez le gestionnaire d’extensions dans Azure Data Studio. Vous pouvez sélectionner l’icône Extensions ou l’option Extensions dans le menu Affichage.

2. Tapez Oracle dans la barre de recherche.

3. Sélectionnez l’extensibilité Évaluation de la migration de base de données pour Oracle et examinez ses informations détaillées.

4. Sélectionnez Installer.

   

Configurer les paramètres d’extension

Vous pouvez configurer plusieurs paramètres d’extension après avoir installé l’extension.

1. Accédez aux extensions et sélectionnez Database Migration Assessment pour Oracle, sélectionnez l’icône de gestion des paramètres, puis sélectionnez Paramètres d’extension.

   

2. Sous les paramètres d’extension, modifiez les paramètres d’extension en fonction des exigences de l’environnement.

   

   Remarque

   Pour évaluer le code Oracle vers PostgreSQL, le chemin du répertoire de base du client Oracle et le chemin d’installation d’Ora2Pg sont des paramètres obligatoires.

Exécuter l’évaluation

Une fois l’extension d’évaluation installée, l’étape suivante consiste à se connecter à votre base de données Oracle, à collecter des informations de métadonnées auprès de votre instance Oracle et à générer un rapport d’évaluation.

1. Accédez à l’icône Connexions dans la barre de menus.

   

2. Dans les Détails de la connexion, renseignez les champs.

   1. Dans le champ Type de connexion, sélectionnez Oracle.
   2. Dans le champ Source de données, tapez le nom et l’instance de votre serveur Oracle.
      1. Vous pouvez également fournir le nom TNS. (Vérifiez que la variable d’environnement ORACLE_HOME est définie et que le fichier <ORACLE_HOME>/network/admin folder se trouve dans TNSNAMES.ORA.)
      2. Pour la base de données autonome du conteneur, vous pouvez soit vous connecter à la base de données racine du conteneur en utilisant l'ID du service CDB, soit utiliser le nom du service de la base de données enfichable pour vous connecter à la base de données enfichable.
   3. Indiquez le nom d’utilisateur de la base de données dans le champ ID d’utilisateur.
   4. Indiquez le mot de passe de la base de données dans le champ Mot de passe.

   

3. Sélectionnez Connecter.

4. À présent, une nouvelle connexion apparaît dans le menu Détails de la connexion.

5. Cliquez avec le bouton droit sur la connexion Oracle, puis sélectionnez Gérer.

   

6. Sélectionnez Évaluation de la migration.

   

7. Sélectionnez Exécuter une nouvelle évaluation.

   

8. Spécifiez les détails de votre évaluation.

   1. Dans le champ Nom de l’évaluation, entrez un titre (par exemple, demo1).
   2. Entrez votre Paramètre d’évaluation.

      1. Entrez la base de données de migration de destination dans le champ Plateforme cible. Actuellement, il prend en charge Azure SQL et PostgreSQL en tant que cibles.

         Remarque

         La cible PostgreSQL est en Aperçu. Cette option cible ne sera plus disponible. Vous devez exporter toutes les évaluations antérieures.

      2. Dans la section Collecte des données de performances, sélectionnez Exécuter la collecte des données de performances sur la base de données Oracle (connecté) ou Ajouter un rapport AWR.

         Il est recommandé d’utiliser l’option « connecté » si vous exécutez cet outil pendant un pic de charge ou avec une charge réaliste. Sinon, fournissez les rapports AWR générés par le passé pour obtenir des recommandations de performances et de dimensionnement.

         Remarque

         L'option d'évaluation du rapport AWR n'est pas activée pour la base de données enfichable.

      3. Dans le champ Facteur d’échelle, entrez la valeur du multiplicateur.

         • Si la référence SKU recommandée doit prendre en compte d’autres pics de charge, le multiplicateur du facteur d’échelle doit être supérieur à 1. Par exemple, un chargement sporadique (« Burst »), une utilisation saisonnière et une planification de capacité future. Quand une charge de travail de schéma Oracle partielle est migrée, le multiplicateur doit être inférieur à 1.

      4. Dans le champ Utilisation en centile, entrez la valeur en centiles pour le dimensionnement de la cible Azure.

         • La valeur en centiles de l’exemple de performance devant être pris en compte pour le dimensionnement de la cible Azure.

   

9. Il existe deux types d'évaluation :

   • Évaluation de la charge de travail. Dans cette évaluation, le module d’évaluation Oracle effectue une découverte légère des objets de schéma et classe la complexité du schéma pour la migration dans différentes catégories avec une estimation générale des heures de conversion. Cette évaluation préalable permet de déterminer la faisabilité de la migration vers la plateforme cible.

   • Évaluation du code. L’évaluation du code évalue en profondeur les objets de schéma Oracle, puis suggère une préparation globale des objets de code avec des types d’objet (« prêt », « révision nécessaire » et « non prêt ») à un niveau granulaire et un nombre d’heures de conversion associé plus précis.

     Notes

     L’extension utilise un convertisseur de schéma open source Ora2Pg pour les évaluations de code.

     Si le client Oracle et/ou Ora2Pg ne sont pas installés sur la même machine qu’Azure Data Studio, installez-les manuellement ou utilisez le script d’installation Ora2Pg disponible sur GitHub.

     Si le client Oracle et Ora2Pg sont installés, vérifiez que le chemin du répertoire de base du client Oracle et le chemin d’installation d’Ora2Pg sont mis à jour dans les paramètres d’extension.

     • Lorsque vous sélectionnez l'évaluation du code pour les scénarios SQL, sélectionnez les schémas auxquels vous souhaitez accéder pour la conversion et la migration d'Oracle vers SQL. Par défaut, tous les schémas éligibles sont sélectionnés pour l'évaluation.

10. Choisissez Exécuter la validation pour exécuter les conditions préalables et les diverses règles de validation liées aux autorisations de sécurité, aux paramètres de configuration, etc. Si la validation échoue, vous devez corriger les erreurs pour continuer.

11. Lorsque la validation est réussie, vous pouvez sélectionner Exécuter l'évaluation.

12. Vous voyez maintenant la nouvelle évaluation dans la section des « Cinq dernières évaluations ».

    

13. Sélectionnez le lien d’évaluation pour afficher la page des détails de l’évaluation. Vous pouvez voir l’état de l’évaluation la plus récente.

    

14. Sélectionnez Actualiser ou attendez la fin de l’évaluation. Par défaut, la page d’état de l’évaluation s’actualise toutes les 15 secondes. L’état vous indique l’un des quatre états : réussite, échec, en cours ou annulé.

Examiner l’évaluation

Une fois l’évaluation terminée, une sortie unifiée utilisant des cartes est générée pour chaque cible Azure SQL : SQL Server sur Machines virtuelles Azure, Azure SQL Database et Azure SQL Managed Instance ou Azure Database pour PostgreSQL – Serveur flexible.

Chaque carte comporte plusieurs sections. La carte indique la faisabilité globale de la migration vers la cible. Vous pouvez explorer différentes charges de travail relevant de différentes catégories de complexité de migration :

• La section de compatibilité des fonctionnalités présente le résultat de l’examen d’évaluation des fonctionnalités.
• La recommandation de référence SKU fournit le dimensionnement approprié de la cible.
• L’évaluation du code fournit la complexité du code des objets de base de données.

Quand vous sélectionnez Afficher les détails du rapport, seul le récapitulatif de l’évaluation s’affiche dans un premier temps.

Si la cible sélectionnée est Azure Database pour PostgreSQL, l’onglet Détails de la base de données ou l’onglet Évaluation du code est visible selon le type d’évaluation sélectionné.

L’onglet Détails de la base de données présente une décomposition par schéma. Il affiche la liste des schémas découverts, la faisabilité de la migration et la durée estimée en heures de la conversion du schéma.

Cette estimation est basée sur un modèle statistique qui s’applique au nombre d’objets, aux lignes de code, aux fonctionnalités activées et à la taille de la base de données. Pour une estimation plus précise de la conversion des codes, utilisez l'évaluation des codes.

Remarque

Les schémas système ou Oracle intégrés suivants sont exclus de l’évaluation de la charge de travail :

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 recommandation en matière de référence SKU fournit les éléments suivants :

• La cible Azure appropriée.

• Le niveau de service.

• Les seuils des métriques sont utilisés pour communiquer la recommandation de référence SKU.

  

La recommandation de référence SKU évalue différentes métriques de performances : processeur, mémoire, IOPS, latence et stockage. En fonction de l’utilisation et des données de configuration, le générateur de recommandations fournit la cible qui convient et le niveau de service approprié. La recommandation en matière de référence SKU est basée sur l'utilisation de l'instance racine du conteneur ou de la base de données enfichable. La sélection du schéma est ignorée et ne s'applique pas au dimensionnement du SKU.

Remarque

Si la fonctionnalité de référentiel de charge de travail automatique (AWR) est activée sur l’instance Oracle, le générateur de recommandations de référence SKU utilise les vues DBA_HIST_ pour collecter les métadonnées de métriques de performances. Sinon, le générateur de recommandations utilise la configuration du serveur et d’autres informations de vues système pour dimensionner la cible Azure SQL.

La compatibilité du code (pour les cibles PostgreSQL uniquement) fournit un récapitulatif des objets de schéma qui peuvent être convertis en cible Azure. Le rapport décompose les objets comme ceci : objets pouvant être convertis automatiquement, objets prêts avec des conditions et objets à corriger et à convertir manuellement.

Le rapport indique le nombre total d’objets et le temps de conversion nécessaire pour migrer le code vers la base de données Azure PostgreSQL. L’image graphique présente une décomposition pour chaque type d’objet de schéma (tables, vues, clusters, etc.). Les actions sont catégorisées comme suit : « Prêt – conversion automatique », « Révision nécessaire » et « Non prêt – nécessite une conversion manuelle ».

Il est possible d’explorer les sections « Non prêt » et « Révision nécessaire » pour voir la liste des tâches de correction et le temps nécessaire pour chaque tâche.

L’évaluation des fonctionnalités présente les fonctionnalités Oracle mappées à la cible de données Azure et le temps nécessaire pour migrer ces fonctionnalités vers la cible Azure.

Vous pouvez télécharger le rapport pour un examen hors connexion en sélectionnant Télécharger des rapports combinés ou Télécharger des rapports individuels.

Vous pouvez aussi annuler une évaluation en cours, supprimer une évaluation et déplacer des évaluations vers un autre répertoire.

Changer le chemin d’évaluation

1. Accédez à la Place de marché des extensions et recherchez Database Migration Assessment for Oracle.
2. Sélectionnez l’icône Gérer, puis Paramètres des extensions.
3. Spécifiez le nouveau chemin de l’évaluation sous Évaluation Oracle : Chemin de l’évaluation.

Dépanner

Journaux d’activité

L’extension stocke les erreurs, les avertissements et d’autres journaux de diagnostic dans le répertoire des journaux par défaut :

• Windows - C:\Users\<username>.dmaoracle\logs\
• Linux – ~/.dmaoracle/logs
• macOS – /Users/<username>/.dmaoracle/logs

Notes

Par défaut, l’extension stocke les sept derniers fichiers journaux.

Pour changer le répertoire des journaux, mettez à jour la propriété LogDirectory dans le fichier de paramètres de l’extension.

Système d’exploitation	Path
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

Pour plus d’informations sur la résolution des problèmes, consultez Résolution des problèmes Database Migration Assessment concernant les erreurs d’extension Oracle.

Problèmes connus et limitations

• Le chemin fourni n’existe pas.

  Raison : Fichiers manquants ou autorisation manquante sur le dossier de l’évaluation.

  Solution possible :

  • L’utilisateur dispose d’autorisations de lecture et d’écriture sur le dossier d’évaluation.
  • Si un fichier ou un dossier est manquant, supprimez l’évaluation et générez-en une nouvelle.

• Exception de délai d’expiration de connexion rencontrée lors de l’interaction avec Oracle.

  Raison : Échec de connexion à l’instance Oracle.

  Solution possible :

  • Vérifiez si les règles de pare-feu bloquent le port d’écoute Oracle.
  • Exécutez tnsping et vérifiez si l’ID de service est résolu.

Contacter Microsoft pour obtenir de l’aide

Si vous avez besoin d’une assistance supplémentaire de la part de Microsoft, contactez @dmasupport. Pour accélérer le traitement de votre demande, vous pouvez attacher les journaux à partir du répertoire de journaul d’activité par défaut.

Contenu connexe

• Extension pour Oracle (Aperçu)
• Extension de migration Azure SQL pour Azure Data Studio
• Kit d'outils de conversion du schéma de la base de données (DSCT)
• Étendre les fonctionnalités d’Azure Data Studio