Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Utilisez Modernize CLI pour évaluer le code d’application dépendant d’Oracle et créer un plan pour le convertir en PostgreSQL. Le flux de travail prend en charge les applications Java et .NET, à l’aide de définitions de base de données exportées et sources d’application facultatives au lieu d’une connexion à une base de données cible active.
Important
La migration d’applications Oracle vers PostgreSQL dans Modernize CLI est en préversion publique. Ce flux de travail modifie le code de l’application ; il ne migre pas les serveurs de base de données ni les données client, ni ne déploie l’infrastructure cloud, ni n’établit la préparation de la production. Utilisez l’exécution locale pour le flux de travail dans cet article.
Scénarios pris en charge
L’évaluation identifie les dépendances Oracle actives dans les fournisseurs de l’application, la configuration, SQL, les mappages ORM, les séquences et les appels de routine. Les compétences de conversion spécifiques à la langue traitent de :
| Application | Exemples de portée de la conversion |
|---|---|
| Java | Mappages Oracle JDBC, mappages JPA/Hibernate, SQL, séquences, contrats de routine, tests et empaquetage de pilotes. |
| .NET | Oracle.DataAccess et Oracle.ManagedDataAccess, ADO.NET, Dapper, EF/EF Core mappings, SQL, routine contracts, Npgsql, tests et sorties de publication. |
Le flux de travail ne s’applique pas aux applications uniquement PostgreSQL, aux migrations à partir de sources non Oracle ou à l’évaluation de serveur de base de données. Le flux de travail cible les dépendances Oracle utilisées par le code ou la configuration de l’application. Les références Oracle trouvées uniquement dans la documentation ou une bibliothèque Oracle inutilisée ne sont pas suffisantes pour identifier une cible de migration.
Ce flux de travail source prend en charge les applications Java et .NET et peut utiliser des exportations DDL PostgreSQL facultatives pour informer la conversion. Elle ne nécessite pas de connexion de base de données active ou de temps d'arrêt de l'application, et n'ajoute pas automatiquement Azure identité managée ou modifie la stratégie d'authentification de votre application. L’expérience de migration Java Oracle-à-PostgreSQL distincte fournit une tâche de migration Java qui met à jour les clients de base de données pour l’authentification d’identité managée et convertit SQL, éventuellement à l’aide de notes de codage générées lors de la conversion de schéma de base de données.
Prerequisites
- Modernize CLI et ses prérequis d’authentification GitHub.
- Une copie locale d’une application Java ou .NET dépendante d’Oracle.
-
Node.js 22 ou version ultérieure installé en tant que
nodesur votrePATH. Cette exigence concerne les helpers de migration ; Le runtime groupé de l’interface CLI de modernisation ne le remplace pas. Aucun package d’exécution npm n’est requis. - Pour la conversion, le JDK et les outils de génération de l'application, ou ses .NET SDK et outils de génération.
- Pour la validation du runtime PostgreSQL, un moteur Docker en cours d’exécution qui peut exécuter des conteneurs PostgreSQL locaux jetables.
- Ligne de base d’application ayant fait l’objet d’un commit sur une branche Git attachée avant la conversion de la source.
L’évaluation ne génère ni ne teste l’application, n’exécute pas Docker, ne se connecte pas à une base de données et ne modifie pas la source de l’application. Préparer les dépendances avant l’exécution ; l’évaluation n’installe pas les outils ni ne s’authentifie de manière interactive.
Fournir des définitions de base de données facultatives
Vous pouvez évaluer et convertir à partir du seul code de l’application. Pour fournir des contrats de schéma cible, ajoutez ce fichier facultatif dans le référentiel d’applications à l’adresse .github\modernize\oracle-postgres.jsonsuivante :
{
"postgres-ddl-folder": "database\\postgres",
"options": ["tests"]
}
Fusionnez ces paramètres avec n’importe quelle configuration existante plutôt que de la remplacer.
| Setting | Purpose |
|---|---|
postgres-ddl-folder |
Exportation DDL PostgreSQL en lecture seule, sous forme de fichiers par objet ou de vidages de schéma uniquement. |
oracle-ddl-folder |
Définitions Oracle d’origine facultatives distinctes pour préserver le comportement de la source. |
oracle-schema |
Sélecteur de schéma Oracle exact lorsqu’un dossier Oracle DDL est fourni. |
options |
Actions de conversion pour activer explicitement, comme décrit dans le tableau suivant. |
| Option | Purpose |
|---|---|
tests |
Active la prise en charge de la baseline, la génération de test et la réparation des tests rompus. |
Les actions de conversion doivent être explicitement activées. Les actions omises restent désactivées.
Tous les paramètres et le fichier de configuration lui-même sont facultatifs. Les chemins relatifs sont résolus à partir de la racine de l’application. Omettez un paramètre DDL pour une opération en code uniquement ; un dossier manquant, vide ou non valide explicitement fourni constitue une erreur, et non un recours à une évaluation en code uniquement.
Utilisez des dossiers d’exportation UTF-8 dédiés, contenant uniquement le schéma. N’incluez pas les données client, les liens du système de fichiers ou les inclusions exécutables du client SQL. Les extensions de fichier PostgreSQL prises en charge sont .sql, .ddl, .psql, .fnc, .pgsql, .prc, .vw et .trg. Les notes Text et Markdown sont ignorées. L’identité d’objet provient des déclarations DDL, et non des noms de fichiers.
Les instantanés DDL décrivent les contrats exportés, et non le contenu ou les privilèges actuels d’une base de données en service. L’absence d’un objet dans une exportation ne prouve pas son absence de la base de données active. Examinez explicitement les surcharges de routine ambiguës et les constructions non prises en charge.
N’ajoutez pas d’informations d’identification ni de profils de connexion dynamique à cette configuration. Les écritures et options cibles persistantes telles que create-persistent-ddl celles-ci test-target-writes ne sont pas prises en charge. Les chemins DDL sont des paramètres de référentiel, et non de nouveaux modernize assess indicateurs de ligne de commande.
Évaluer la préparation des applications
L’analyse complète est requise pour la compétence d’évaluation de base de données supplémentaire. Le paramètre Problème par défaut ne l’exécute pas.
Mode interactif (TUI)
À partir de votre répertoire d’application, exécutez l’agent de modernisation :
modernizeSélectionnez Évaluer dans le menu principal.
Sélectionnez Dossier actuel pour évaluer votre application ou entrée manuelle pour entrer un chemin d’accès d’application local.
Sélectionnez les domaines d’évaluation pertinents pour votre application et passez à la configuration de l’évaluation.
Sous Couverture générale/Analyse, sélectionnez Analyse complète, puis Continuer.
Sélectionnez Évaluer localement.
Entrez un chemin de sortie ou acceptez la valeur par défaut, puis démarrez l’évaluation.
L’interface CLI utilise les éléments probants du dépôt pour sélectionner l’évaluation de l’application Oracle-to-PostgreSQL quand elle s’applique. Pour plus d’informations sur les écrans interactifs, consultez l’évaluation Batch : mode interactif.
Mode non interactif
Créez un fichier de configuration d’évaluation, par exemple C:\configs\database-assessment.yml, avec le paramètre suivant :
analysisCoverage: full
Fusionnez ce paramètre avec une configuration existante plutôt que de remplacer d’autres paramètres d’évaluation. Transmettez le fichier comme --assess-config indiqué dans la commande suivante, en remplaçant la source, la configuration et les chemins de sortie par vos propres :
modernize assess `
--source C:\src\oracle-app `
--assess-config C:\configs\database-assessment.yml `
--output-path C:\reports\oracle-app `
--format markdown `
--delegate local `
--no-tty `
--prompt 'Assess Oracle-to-PostgreSQL application-code migration readiness.'
Sinon, sur Windows, mettez à jour un fichier au niveau assessment-config.yaml de l’utilisateur existant en %USERPROFILE%\.modernize\assessment-config.yaml définissant analysisCoverage: full. Si vous utilisez ce fichier, omettez --assess-config de la commande. Un chemin explicite --assess-config est prioritaire sur le fichier au niveau de l’utilisateur.
Note
L’élément facultatif --prompt décrit votre objectif ou votre portée pour des compétences supplémentaires d’évaluation des bases de données. Elle ne modifie pas l’analyse IA intégrée à Modernize CLI. Utilisez la configuration du référentiel pour les chemins DDL et les options de conversion ; l’invite ne configure pas ces paramètres.
Vous pouvez omettre --prompt. Une fois l’analyse complète activée, l’interface CLI utilise les éléments de preuve du référentiel pour sélectionner l’évaluation d’application Oracle-to-PostgreSQL le cas échéant. L’évaluation évalue la préparation de la migration ; elle ne convertit pas le code d’application. La conversion s’exécute séparément pendant l’exécution du plan.
Passer en revue le rapport d’évaluation
Ouvrez le rapport d’application généré et consultez Oracle to PostgreSQL App Readiness. Le rapport externe est publié dans le répertoire du rapport du référentiel actuel externals\oracle-to-postgresql-app-assessment sous la forme d’un rapport autonome index.md ou index.html.
L’évaluation effectue une inspection statique limitée en lecture seule. Un rapport terminé signifie que la génération de rapports est terminée, et non que la conversion d’application ou la validation à l’exécution a réussi.
- Si l’évaluation ne trouve pas d’utilisation active de l’application Oracle, le flux de travail ignore l’évaluation plutôt que de générer un rapport de migration.
- Si l’évaluation est incomplète, passez en revue les limitations d’étendue signalées avant la planification de la conversion.
- Si vous fournissez un DDL non valide, corrigez-le et réexécutez plutôt que de supposer un résultat contenant uniquement du code.
L’évaluation ne crée pas automatiquement de tâches de conversion. Créez et passez ensuite en revue un plan de modernisation.
Créer un plan de conversion
Commencez par un échantillon jetable, validé par commit, ou une branche de test. Utilisez une demande qui distingue la validation locale isolée de l’accès interdit aux bases de données des clients :
$request = @'
Migrate this Oracle-dependent Java application to PostgreSQL using the offline
application adapter and the optional repository DDL and test configuration.
Allow disposable task-owned local PostgreSQL Docker containers for validation
of real application JDBC and ORM paths with synthetic data and cleanup.
Do not access customer or production databases, deploy cloud infrastructure,
change authentication policy, or perform unrelated framework upgrades.
'@
modernize plan create $request `
--source C:\src\oracle-app `
--language java `
--plan-name oracle-postgres `
--assess-file-path C:\reports\oracle-app\reports\report-<id>\index.md `
--delegate local `
--no-tty
Remplacez la valeur --assess-file-path par le chemin d’accès réel du rapport d’évaluation d’application généré lors de votre exécution d’évaluation, y compris les répertoires du référentiel et du rapport versionné. Ne copiez pas l’espace réservé <id> littéralement.
Pour plus d’options de planification, consultez Moderniser la référence de commande CLI : plan create.
Pour une application .NET, modifiez la requête pour décrire l’application .NET et ses chemins d’accès ADO.NET ou ORM, puis utilisez --language dotnet.
Avant l’exécution, passez en revue le plan et la liste des tâches générés :
- Pour Java, vérifiez que la tâche de conversion utilise
migration-oracle-to-postgresql-app-java. - Pour .NET, vérifiez qu’elle utilise
migration-oracle-to-postgresql-app-dotnet. - Conservez la conversion dans les limites prévues de l’application et préservez les fournisseurs non concernés ainsi que le comportement public.
- Autoriser la validation locale de PostgreSQL avec Docker, propre à une tâche. N’imposez pas de restriction fictive uniquement ou ne confondez pas les conteneurs de test locaux avec le déploiement cloud.
- Passez en revue les exigences de base, de build, de test, d’empaquetage et de nettoyage.
La compétence Java migration-oracle-to-postgresql existante est un flux de travail différent. Ne le substituez pas à l’adaptateur d’application hors connexion.
Exécuter et valider
Après avoir examiné le plan, exécutez :
modernize plan execute `
--source C:\src\oracle-app `
--language java `
--plan-name oracle-postgres `
--delegate local `
--no-tty
Utiliser --language dotnet pour le plan de .NET. Modernize CLI gère l’ordre des tâches, la progression, les branches et les commits.
La conversion utilise des éléments de l’application pour mettre à jour les fournisseurs de services, la configuration, SQL, les mappages, les contrats de routine et le packaging dans le périmètre examiné. Elle n’effectue pas de modifications non liées de l’architecture, du framework ou de l’authentification.
La validation du runtime utilise des chemins d’accès réels aux bases de données de l’application sur des conteneurs PostgreSQL jetables propres à la tâche, avec des données synthétiques, des assertions et un nettoyage. La compilation et les simulations seules ne prouvent pas la compatibilité PostgreSQL.
Si Docker n’est pas disponible, la validation dépendante reste incomplète. Le flux de travail n’installe pas Docker ni démarre Docker Desktop par défaut. Le démarrage d’un Docker Desktop installé nécessite l’option explicite start-docker-desktop dans la configuration du référentiel.
Interpréter les résultats de conversion
Passez en revue les éléments de preuve de la tâche dans le dossier de travail du plan situé dans oracle-postgres\<task-id>, y compris conversion-report.md et conversion-state.json. Vérifiez les fichiers modifiés, la recherche de dispositions, les résultats de test natifs, l’empaquetage, le nettoyage des appareils Docker et les actions restantes.
| Résultat | Sens |
|---|---|
RUNTIME_VALIDATION_NEEDED |
Le meilleur résultat de conversion hors connexion. Les vérifications de validation de la cible client et de préparation à la production sont toujours requises, même quand les tests Docker isolés réussissent. |
PARTIAL |
Le comportement requis est différé ou la validation requise a échoué ou n’a pas pu s’exécuter. Ne traitez pas ce résultat comme une migration terminée. |
Aucun des deux résultats ne signifie que c’est prêt pour la productionREADY. Validez le schéma spécifique au déploiement, les privilèges, l’authentification, les charges de travail représentatives et le comportement opérationnel dans votre propre environnement contrôlé avant le déploiement de production. La migration des données de base de données et le provisionnement d’un service cible sont des activités distinctes.