Convertir le code et le schéma Oracle avec l'aide de Gemini

Database Migration Service intègre Gemini pour Google Cloud les espaces de travail de conversion afin de vous aider à accélérer et à améliorer le processus de conversion dans les domaines suivants:

  • Améliorez les résultats de la conversion déterministe avec la conversion automatique optimisée par Gemini pour exploiter la puissance de l'IA afin de réduire considérablement le nombre d'ajustements manuels nécessaires dans votre code PostgreSQL.

    Cette fonctionnalité n'est disponible que pour les espaces de travail de conversion mis à niveau. Seuls les espaces de travail nouvellement créés peuvent être mis à niveau. Pour en savoir plus, consultez la section Mettre à niveau un espace de travail de conversion.

  • Fournissez des fonctionnalités d'explicabilité du code avec l' assistant de conversion: un ensemble d'invites dédiées qui peuvent vous aider à mieux comprendre la logique de conversion, à proposer des solutions aux problèmes de conversion ou à optimiser le code converti.
  • Accélérez l'application des correctifs aux problèmes de conversion grâce aux suggestions de conversion de code Gemini: un mécanisme permettant au modèle Gemini d'apprendre à mesure que vous corrigez les problèmes de conversion et de suggérer des modifications à d'autres objets défectueux dans l'espace de travail.

    Vous pouvez également combiner cette fonctionnalité à l'explicabilité du code pour une expérience de conversion d'objets de code complète et de bout en bout, optimisée par Gemini. Pour en savoir plus, consultez Exemple de workflow pour corriger les objets de code présentant des problèmes de conversion.

Votre code et votre schéma SQL sont stockés dans la région où vous créez l'espace de travail de conversion. Si vous utilisez la conversion assistée du code et des schémas avec des modèles Gemini, votre code et vos schémas peuvent être traités dans d'autres régions.

Découvrez comment et quand Gemini pour Google Cloud utilise vos données.

Coûts

Pour utiliser l'assistance Gemini dans les espaces de travail de conversion Database Migration Service, vous devez activer l'API Gemini for Google Cloud . Les tarifs Gemini s'appliquent. Pour en savoir plus, consultez la page Tarifs Gemini pour Google Cloud .

Avant de commencer

Pour utiliser les fonctionnalités Gemini dans Database Migration Service, procédez comme suit:

  1. Activez Gemini pour Google Cloud dans votre projet.

    Activer l'API

  2. Une fois que vous avez activé Gemini pour Google Cloud dans votre projet, l' Assistant de conversion et la recherche de correspondances sont automatiquement activés pour tous les espaces de travail de conversion de votre projet. Pour utiliser la conversion automatique, vous devez l'activer par espace de travail.

    L'activation ou la désactivation de chaque fonctionnalité optimisée par Gemini dépend également de l'utilisation d'un espace de travail de conversion mis à niveau. Pour en savoir plus sur l'activation ou la désactivation de chaque fonctionnalité, consultez les sections suivantes de cette page.

Utiliser la conversion automatique Gemini

Lorsque vous convertissez votre schéma source, Database Migration Service utilise les règles de conversion déterministes pour créer les équivalents de syntaxe PostgreSQL. La conversion automatique intègre des corrections optimisées par Gemini en plus des résultats déterministes pour réduire le nombre de problèmes de conversion et améliorer la qualité des conversions.

Pour utiliser la conversion automatique, procédez comme suit:

  1. Créez un espace de travail de conversion. Veillez à la mettre à niveau immédiatement pour profiter de la dernière expérience simplifiée.
  2. Accédez à Espaces de travail de conversion, puis sélectionnez votre espace de travail.

    Accédez aux espaces de travail de conversion.

  3. Activez la conversion automatique pour votre espace de travail.
  4. Convertissez votre code source et votre schéma. Cliquez sur Convertir la source.

    Database Migration Service utilise automatiquement les améliorations optimisées par Gemini lors de la conversion. Vous pouvez utiliser la vue arborescente pour voir quels objets sont enrichis avec Gemini:

    Vue arborescence des conversions avec un résumé d'augmentation optimisé par Gemini.
    Figure 1. Vue arborescente du schéma source avec l'état de l'augmentation Gemini. (cliquez pour agrandir)
    Vue arborescence des conversions avec un résumé d'augmentation optimisé par Gemini.
  5. Dans la vue arborescente, sélectionnez un objet augmenté pour afficher les détails des améliorations fournies par la conversion automatique. Si vous n'aimez pas les modifications apportées par Gemini, cliquez sur Utiliser plutôt le code déterministe pour rétablir les résultats de conversion déterministe dans l'objet.

    Panneau de conversion automatique Gemini avec des informations sur les ajustements appliqués au schéma converti.
    Figure 2. Panneau de conversion automatique optimisé par Gemini dans lequel vous pouvez inspecter les détails des augmentations de code et de schéma. (cliquez pour agrandir)
    Panneau de conversion automatique Gemini avec des informations sur les ajustements appliqués au schéma converti.

Activer la conversion automatique

Si vous avez précédemment désactivé la conversion automatique, vous pouvez l'activer dans le panneau Gemini:

  1. Dans la console Google Cloud , accédez à Espaces de travail de conversion et sélectionnez votre espace de travail.

    Accédez aux espaces de travail de conversion.

  2. Cliquez sur pen_spark Gemini.

    Le panneau latéral Gemini s'ouvre.

  3. Cochez la case Conversion automatique, puis cliquez sur Enregistrer les paramètres.

    Votre espace de travail de conversion sera désormais converti automatiquement lorsque vous convertirez votre schéma.

  4. Facultatif: Dans la boîte de dialogue Convertir les objets sources avec Gemini ?, cliquez sur Convertir.

    Vos objets convertis ne sont pas modifiés lorsque vous activez la conversion automatique. Vous pourrez convertir à nouveau votre schéma ultérieurement.

Désactiver la conversion automatique

Pour désactiver la conversion automatique, procédez comme suit:

  1. Dans la console Google Cloud , accédez à Espaces de travail de conversion et sélectionnez votre espace de travail.

    Accédez aux espaces de travail de conversion.

  2. Cliquez sur pen_spark Gemini.

    Le panneau latéral Gemini s'ouvre.

  3. Décochez la case Conversion automatique, puis cliquez sur Enregistrer les paramètres.

    Votre espace de travail de conversion utilisera désormais la conversion de code et de schéma déterministe lorsque vous convertirez votre schéma.

  4. Facultatif: Dans la boîte de dialogue Convertir les objets sources ?, cliquez sur Convertir.

    Vos objets convertis ne sont pas modifiés lorsque vous désactivez la conversion automatique. Vous pouvez convertir à nouveau votre schéma ultérieurement si vous souhaitez revenir aux résultats de conversion pour utiliser des règles de conversion déterministes.

Utiliser l'assistant de conversion Gemini

L'assistant de conversion est un ensemble d'invites dédiées que vous pouvez utiliser pour mieux comprendre la logique de conversion des objets, demander des idées sur l'optimisation du code et la résolution de vos problèmes de conversion, ou même ajouter des commentaires à votre schéma pour les objets de base de données auto-documentés.

Capture d'écran montrant comment accéder aux requêtes Gemini pour l'explicabilité de la conversion de code et de schéma
Figure 1. Requêtes de l'assistant de conversion Gemini (cliquez pour agrandir)
Capture d'écran montrant comment accéder aux requêtes Gemini pour l'explicabilité de la conversion de code et de schéma

Activer l'assistant de conversion

L'assistant de conversion est activé par défaut lorsque vous activez Gemini pour Google Cloud dans votre projet. Si vous avez précédemment désactivé l'assistant de conversion, vous pouvez le réactiver dans votre espace de travail. La procédure d'activation de l'assistant de conversion varie selon que vous utilisez un espace de travail de conversion mis à niveau ou non.

Espaces de travail mis à niveau

Pour activer l'assistant de conversion dans les espaces de travail de conversion mis à niveau, procédez comme suit:

  1. Dans la console Google Cloud , accédez à Espaces de travail de conversion et sélectionnez votre espace de travail.

    Accédez aux espaces de travail de conversion.

  2. Cliquez sur pen_spark Gemini.

    Le panneau latéral Gemini s'ouvre.

  3. Cochez la case Assistance pour les conversions, puis cliquez sur Enregistrer les paramètres.

Espaces de travail non mis à niveau

Pour les anciens espaces de travail qui ne sont pas mis à niveau pour utiliser la conversion automatique Gemini, l'assistance à la conversion est activée par défaut une fois que vous avez activé Gemini pour votre projet. Aucune autre étape n'est requise.

Désactiver l'assistant de conversion

Les étapes à suivre pour activer l'assistant de conversion diffèrent selon que vous utilisez ou non un espace de travail de conversion mis à niveau.

Espaces de travail mis à niveau

Pour activer l'assistant de conversion dans les espaces de travail de conversion mis à niveau, procédez comme suit:

  1. Dans la console Google Cloud , accédez à Espaces de travail de conversion et sélectionnez votre espace de travail.

    Accédez aux espaces de travail de conversion.

  2. Cliquez sur pen_spark Gemini.

    Le panneau latéral Gemini s'ouvre.

  3. Cochez la case Assistance pour les conversions, puis cliquez sur Enregistrer les paramètres.

Espaces de travail non mis à niveau

Pour les anciens espaces de travail qui ne sont pas mis à niveau pour utiliser la conversion automatique Gemini, l'assistance à la conversion est activée par défaut une fois que vous avez activé Gemini pour votre projet.

Vous pouvez désactiver l'assistant de conversion si vous désactivez Gemini for Google Cloud dans votre projet.

M'aider à résoudre les problèmes de conversion d'objets

Le moteur de conversion de code et de schéma basé sur des règles peut parfois rencontrer des problèmes lors de la traduction d'objets d'Oracle vers PostgreSQL. Par exemple, certaines fonctions Oracle peuvent ne pas avoir d'équivalents directs dans PostgreSQL. Vous pouvez utiliser l'invite M'aider à résoudre les problèmes de conversion d'objets pour obtenir une proposition de modifications de code pouvant résoudre le problème de conversion.

Cette invite n'est disponible que pour les objets de code modifiables présentant des problèmes de conversion. Vous ne pouvez pas afficher cette invite pour d'autres types d'objets dans l'espace de travail de conversion.

Pour utiliser cette requête, procédez comme suit:

  1. Dans la Google Cloud console, accédez à Espaces de travail de conversion.

    Accéder aux espaces de travail de conversion

  2. Dans la liste des espaces de travail de conversion disponibles, sélectionnez celui avec lequel vous souhaitez travailler.

    L'éditeur de l'espace de travail de conversion s'ouvre.

  3. Dans le panneau Oracle, sélectionnez l'un de vos objets Oracle.

  4. Dans la vue d'informations sur l'objet, sélectionnez Assistant de conversion > M'aider à résoudre les problèmes de conversion d'objets.

    Un volet contenant les résultats de l'invite s'ouvre.

  5. Vérifiez l'écran de comparaison qui affiche les améliorations proposées. Si les résultats vous conviennent, vous pouvez utiliser le bouton Insérer une suggestion pour mettre à jour l'objet converti.

  6. Répétez la procédure pour chaque objet de code défectueux. À mesure que vous appliquez les propositions de code, les modèles Gemini apprennent le modèle et peuvent vous suggérer comment propager les correctifs à tous les objets défectueux de votre espace de travail.

Expliquer la logique de conversion pour cet objet

L'invite Expliquer la logique de conversion de cet objet vous permet d'obtenir une explication détaillée du fonctionnement du code converti, y compris un résumé des bonnes pratiques appliquées au nouveau code.

Pour demander une explication de la logique de conversion des objets, procédez comme suit:

  1. Dans la Google Cloud console, accédez à Espaces de travail de conversion.

    Accéder aux espaces de travail de conversion

  2. Dans la liste des espaces de travail de conversion disponibles, sélectionnez celui avec lequel vous souhaitez travailler.

    L'éditeur de l'espace de travail de conversion s'ouvre.

  3. Dans le panneau Oracle, sélectionnez l'un de vos objets Oracle.

  4. Dans la vue d'informations sur l'objet, sélectionnez Assistant de conversion > Expliquer la logique de conversion pour cet objet.

    Un volet contenant les résultats de l'invite s'ouvre.

M'aider à optimiser ce code

Parfois, les résultats de la conversion du code et du schéma basés sur des règles peuvent être techniquement corrects, mais pas entièrement optimisés pour les environnements PostgreSQL. Vous pouvez utiliser l'invite M'aider à optimiser ce code pour obtenir une proposition d'optimisation du code pour votre objet de base de données.

Pour utiliser cette requête, procédez comme suit:

  1. Dans la Google Cloud console, accédez à Espaces de travail de conversion.

    Accéder aux espaces de travail de conversion

  2. Dans la liste des espaces de travail de conversion disponibles, sélectionnez celui avec lequel vous souhaitez travailler.

    L'éditeur de l'espace de travail de conversion s'ouvre.

  3. Dans le panneau Oracle, sélectionnez l'un de vos objets Oracle.

  4. Dans la vue d'informations sur l'objet, sélectionnez Assistant de conversion > M'aider à optimiser ce code.

    Un volet contenant les résultats de l'invite s'ouvre.

  5. Dans le panneau des résultats, lisez l'explication, examinez le code et assurez-vous que la proposition correspond à ce dont vous avez besoin. Si les résultats vous conviennent, vous pouvez utiliser le bouton Insérer une suggestion pour mettre à jour l'objet converti.

Ajouter des commentaires pour expliquer le but de cet objet

L'invite Ajouter des commentaires pour expliquer le but de cet objet génère une proposition de commentaires de code que vous pouvez ajouter à votre objet de base de données pour un schéma auto-documenté.

Pour utiliser cette requête, procédez comme suit:

  1. Dans la Google Cloud console, accédez à Espaces de travail de conversion.

    Accéder aux espaces de travail de conversion

  2. Dans la liste des espaces de travail de conversion disponibles, sélectionnez celui avec lequel vous souhaitez travailler.

    L'éditeur de l'espace de travail de conversion s'ouvre.

  3. Dans le panneau Oracle, sélectionnez l'un de vos objets Oracle.

  4. Dans la vue d'informations de l'objet, sélectionnez Assistant de conversion > Ajouter des commentaires pour expliquer le but de cet objet.

    Un volet contenant les résultats de l'invite s'ouvre.

  5. Dans le panneau des résultats, lisez l'explication, examinez le code et assurez-vous que la proposition correspond à ce dont vous avez besoin. Si les résultats vous conviennent, vous pouvez utiliser le bouton Insérer une suggestion pour mettre à jour l'objet converti.

Propager les corrections des problèmes de conversion avec la conversion de code Gemini

Lorsque vous corrigez des problèmes de conversion dans votre espace de travail, les modèles Gemini peuvent tirer des enseignements de vos corrections et suggérer des modifications à apporter à d'autres objets défectueux de l'espace de travail. Vous pouvez ainsi propager vos corrections à plusieurs objets sans avoir à effectuer toutes les modifications manuellement.

Activer les suggestions de conversions Gemini

Les suggestions de conversion sont activées par défaut lorsque vous activez Gemini pour Google Cloud dans votre projet. Si vous l'avez précédemment désactivée, vous pouvez la réactiver dans votre espace de travail. La procédure d'activation des suggestions de conversion diffère selon que vous utilisez ou non un espace de travail de conversion mis à niveau.

Espaces de travail mis à niveau

Pour activer l'assistant de conversion dans les espaces de travail de conversion mis à niveau, procédez comme suit:

  1. Dans la console Google Cloud , accédez à Espaces de travail de conversion et sélectionnez votre espace de travail.

    Accédez aux espaces de travail de conversion.

  2. Cliquez sur pen_spark Gemini.

    Le panneau latéral Gemini s'ouvre.

  3. Cochez la case Correspondance avec un modèle, puis cliquez sur Enregistrer les paramètres.

Espaces de travail non mis à niveau

Pour les anciens espaces de travail qui ne sont pas mis à niveau pour utiliser la conversion automatique Gemini, les suggestions de conversion sont activées par défaut une fois que vous avez activé Gemini pour votre projet. Si vous avez précédemment désactivé les suggestions de conversion, procédez comme suit pour les réactiver:

  1. Dans la console Google Cloud , accédez à Espaces de travail de conversion et sélectionnez votre espace de travail.

    Accédez aux espaces de travail de conversion.

  2. Dans la barre des tâches, cliquez sur pen_spark Gemini, puis sélectionnez Suggestion de code.

    Les suggestions de conversion de code Gemini sont désormais activées pour cet espace de travail de conversion.

Désactiver les suggestions de conversions Gemini

Les étapes à suivre pour activer l'assistant de conversion diffèrent selon que vous utilisez ou non un espace de travail de conversion mis à niveau.

Espaces de travail mis à niveau

Pour activer les suggestions de conversion dans les espaces de travail de conversion mis à niveau, procédez comme suit:

  1. Dans la console Google Cloud , accédez à Espaces de travail de conversion et sélectionnez votre espace de travail.

    Accédez aux espaces de travail de conversion.

  2. Cliquez sur pen_spark Gemini.

    Le panneau latéral Gemini s'ouvre.

  3. Décochez la case Correspondance avec un modèle, puis cliquez sur Enregistrer les paramètres.

Espaces de travail non mis à niveau

Pour désactiver les suggestions de conversion pour les anciens espaces de travail qui ne sont pas mis à niveau pour utiliser la conversion automatique Gemini, procédez comme suit:

  1. Dans la console Google Cloud , accédez à Espaces de travail de conversion et sélectionnez votre espace de travail.

    Accédez aux espaces de travail de conversion.

  2. Dans la barre des tâches, cliquez sur pen_spark Gemini, puis sélectionnez Suggestion de code.

    Les suggestions de conversion de code Gemini sont désormais désactivées pour cet espace de travail de conversion.

Afficher les suggestions de conversion Gemini dans Database Migration Service

Lorsque vous corrigez des problèmes d'objets (en modifiant le code de l'objet SQL ou en appliquant le code proposé par l'invite M'aider à résoudre les problèmes de conversion d'objets), les modèles Gemini analysent vos modifications. Une fois suffisamment de modifications apportées, l'intégration Gemini affiche une invite et suggère d'autres modifications.

Pour accéder aux suggestions de Gemini:

  1. Dans la Google Cloud console, accédez à Espaces de travail de conversion.

    Accéder aux espaces de travail de conversion

  2. Dans la liste des espaces de travail de conversion disponibles, sélectionnez celui avec lequel vous souhaitez travailler.

    L'éditeur de l'espace de travail de conversion s'ouvre.

  3. Dans le panneau Oracle, sélectionnez l'objet dont vous souhaitez ajuster le code SQL généré.

  4. Résolvez les problèmes de conversion que vous rencontrez avec l'objet et enregistrez les modifications de code. Vous pouvez modifier le code manuellement ou utiliser l'invite M'aider à résoudre les problèmes de conversion d'objets.

    Les modèles Gemini analysent vos corrections les plus récentes jusqu'à ce qu'ils puissent suggérer des mises à jour similaires pour d'autres objets présentant des problèmes de conversion. Lorsque les modèles Gemini ont analysé suffisamment de vos corrections, la boîte de dialogue Examiner les suggestions de Gemini s'affiche.

    Boîte de dialogue de correction des problèmes Gemini.
    Figure 2. Boîte de dialogue de correction des problèmes Gemini. (cliquez pour agrandir)
    Boîte de dialogue de correction des problèmes Gemini.
  5. Pour afficher les suggestions générées par IA en fonction des modifications que vous avez apportées, cliquez sur Examiner les suggestions.

Examiner les suggestions de conversion Gemini

La page Corriger les problèmes avec Gemini affiche les suggestions générées par les modèles Gemini en fonction des modifications de code que vous avez apportées. Ces suggestions contiennent des modifications similaires que vous pouvez appliquer à d'autres objets. Pour chaque suggestion, vous pouvez l'examiner, la modifier, l'accepter ou l'ignorer.

La page Corriger les problèmes avec Gemini affiche trois variantes du code source d'un objet, que vous pouvez sélectionner dans le menu Vue de modification:

  • Code source d'origine (lecture seule)
  • Code source de la destination (brouillon) (lecture seule)
  • Code source de destination généré avec l'aide de Gemini (modifiable)

Le volet Objects (Objets) contient une liste des objets présentant des problèmes et les solutions suggérées par les modèles Gemini.

Pour examiner les suggestions de Gemini, procédez comme suit:

  1. Cliquez sur un objet pour afficher la solution suggérée par l'IA.
  2. Examinez et modifiez le code suggéré par les modèles Gemini.
  3. Effectuez l'une des opérations suivantes :

    • Pour accepter la suggestion (y compris vos modifications), cliquez sur Accepter le code. Les modifications sont appliquées à l'objet dans l'espace de travail de conversion, et l'état de l'objet dans la liste des objets passe de En attente à Accepté.

    • Pour conserver la suggestion (y compris vos modifications) sans appliquer les modifications, passez à un autre objet. L'objet reste à l'état En attente. Vous pouvez modifier le code et accepter ou ignorer la suggestion plus tard.

    • Pour ignorer les suggestions en attente ou acceptées (et rétablir vos modifications), cliquez sur Ignorer le code. L'état de l'objet dans la liste des objets passe de En attente à Ignoré. Vos modifications sont annulées. Vous pourrez modifier le code et l'appliquer plus tard.

Pour fermer les suggestions Gemini et supprimer toutes les modifications que vous n'avez pas appliquées, procédez comme suit:

  1. Sur la page Corriger les problèmes liés à Gemini, cliquez sur la flèche de retour.
  2. Dans la boîte de dialogue Close Gemini (Fermer Gemini), cliquez sur Close (Fermer).

    La session Gemini en cours est fermée. Pour revenir à la page des suggestions, accédez à nouveau aux suggestions Gemini.

Étape suivante