Convertire il codice e lo schema Oracle con l'assistenza di Gemini

Database Migration Service integra Gemini per Google Cloud le workspace di conversione per aiutarti ad accelerare e migliorare il processo di conversione nelle seguenti aree:

Il codice e lo schema SQL vengono archiviati nella regione in cui crei l'area di lavoro di conversione. Se utilizzi la conversione assistita di codice e schemi con i modelli Gemini, il codice e gli schemi potrebbero essere elaborati in altre regioni.

Scopri come e quando Gemini per Google Cloud utilizza i tuoi dati.

Costi

Per utilizzare l'assistenza di Gemini nelle aree di lavoro di conversione di Database Migration Service, devi abilitare l'API Gemini for Google Cloud . Vengono applicati i prezzi di Gemini. Per ulteriori informazioni, consulta i prezzi di Gemini per Google Cloud .

Prima di iniziare

Per utilizzare le funzionalità basate su Gemini in Database Migration Service:

  1. Abilita Gemini per Google Cloud nel tuo progetto.

    Abilita l'API

  2. Dopo aver attivato Gemini per Google Cloud nel tuo progetto, l'assistente alla conversione e la corrispondenza dei pattern vengono attivati automaticamente per tutte le aree di lavoro di conversione del progetto. Per utilizzare la conversione automatica, devi attivarla su base singola unità di lavoro.

    L'attivazione o la disattivazione di ogni funzionalità basata su Gemini dipende anche dall'utilizzo di un' area di lavoro di conversione di cui è stato eseguito l'upgrade. Per ulteriori informazioni su come attivare o disattivare ciascuna funzionalità, consulta le sezioni successive di questa pagina.

Utilizzare la conversione automatica di Gemini

Quando converti lo schema di origine, Database Migration Service utilizza le regole di conversione deterministica per creare gli equivalenti della sintassi PostgreSQL. La conversione automatica integra le correzioni basate su Gemini oltre ai risultati deterministici per ridurre il numero di problemi di conversione e migliorare la qualità delle conversioni.

Per utilizzare la conversione automatica:

  1. Crea una nuova area di lavoro di conversione. Assicurati di eseguire immediatamente l'upgrade per utilizzare l'esperienza semplificata più recente.
  2. Vai ad Aree di lavoro della conversione e seleziona la tua area di lavoro.

    Vai ad Aree di lavoro della conversione

  3. Abilita la conversione automatica per il tuo spazio di lavoro.
  4. Converti lo schema e il codice sorgente. Fai clic su Converti origine.

    Database Migration Service utilizza automaticamente i miglioramenti basati su Gemini nella conversione. Puoi utilizzare la visualizzazione ad albero per vedere quali oggetti sono aumentati con Gemini:

    Visualizzazione dell'albero delle conversioni con riepilogo dell'aumento basato su Gemini.
    Figura 1. Visualizzazione ad albero dello schema di origine con lo stato dell'aumento di Gemini. (fai clic per ingrandire)
    Visualizzazione dell'albero delle conversioni con riepilogo dell'aumento basato su Gemini.
  5. Nella visualizzazione ad albero, seleziona un oggetto aumentato per visualizzare i dettagli degli miglioramenti forniti dalla conversione automatica. Se non ti piacciono le modifiche introdotte da Gemini, fai clic su Utilizza invece il codice deterministico per ripristinare nell'oggetto i risultati di conversione deterministici.

    Riquadro della conversione automatica basata su Gemini con i dettagli relativi agli aggiustamenti implementati nello schema convertito.
    Figura 2. Riquadro di conversione automatica basato su Gemini in cui puoi esaminare i dettagli degli ampliamenti di codice e schema. (fai clic per ingrandire)
    Riquadro della conversione automatica basata su Gemini con i dettagli relativi agli aggiustamenti implementati nello schema convertito.

Attivare la conversione automatica

Se in precedenza hai disattivato la conversione automatica, puoi attivarla nel riquadro di Gemini:

  1. Nella Google Cloud console, vai ad Aree di lavoro della conversione e seleziona la tua area di lavoro.

    Vai ad Aree di lavoro della conversione

  2. Fai clic su pen_spark Gemini.

    Si apre il riquadro laterale di Gemini.

  3. Seleziona la casella di controllo Conversione automatica e fai clic su Salva impostazioni.

    Ora la tua area di lavoro di conversione eseguirà la conversione automatica quando converti lo schema.

  4. (Facoltativo) Nella finestra di dialogo Convertire gli oggetti di origine con Gemini?, fai clic su Converti.

    Gli oggetti convertiti non vengono modificati quando attivi la conversione automatica. Puoi convertire di nuovo lo schema in un secondo momento.

Disattivare la conversione automatica

Per disattivare la conversione automatica:

  1. Nella Google Cloud console, vai ad Aree di lavoro della conversione e seleziona la tua area di lavoro.

    Vai ad Aree di lavoro della conversione

  2. Fai clic su pen_spark Gemini.

    Si apre il riquadro laterale di Gemini.

  3. Deseleziona la casella di controllo Conversione automatica e fai clic su Salva impostazioni.

    Ora la tua area di lavoro di conversione utilizzerà la conversione deterministica di codice e schema quando converti lo schema.

  4. (Facoltativo) Nella finestra di dialogo Convertire gli oggetti di origine?, fai clic su Converti.

    Gli oggetti convertiti non vengono modificati quando disattivi la conversione automatica. Puoi convertire di nuovo lo schema in un secondo momento se vuoi ripristinare i risultati di conversione per utilizzare regole di conversione deterministiche.

Utilizzare l'assistente alla conversione di Gemini

L'assistente alla conversione è un insieme di prompt dedicati che puoi utilizzare per comprendere meglio la logica di conversione degli oggetti, chiedere idee su come ottimizzare il codice e risolvere i problemi di conversione o persino aggiungere commenti allo schema per gli oggetti del database autodocumentanti.

Uno screenshot che mostra come accedere ai prompt di Gemini per la spiegabilità della conversione di codice e schema.
Figura 1. Prompt dell'assistente alle conversioni di Gemini. (fai clic per ingrandire)
Uno screenshot che mostra come accedere ai prompt di Gemini per la spiegabilità della conversione di codice e schema.

Attivare l'assistente per le conversioni

L'assistente per le conversioni è attivo per impostazione predefinita quando attivi Gemini per Google Cloud nel tuo progetto. Se in precedenza hai disattivato l'assistente alla conversione, puoi riattivarlo nella tua area di lavoro. I passaggi per attivare l'assistente alla conversione sono diversi a seconda che tu utilizzi o meno uno spazio di lavoro per le conversioni di cui è stato eseguito l'upgrade.

Aree di lavoro di cui è stato eseguito l'upgrade

Per attivare l'assistente per le conversioni negli spazi di lavoro per le conversioni di cui è stato eseguito l'upgrade: segui questi passaggi:

  1. Nella Google Cloud console, vai ad Aree di lavoro della conversione e seleziona la tua area di lavoro.

    Vai ad Aree di lavoro della conversione

  2. Fai clic su pen_spark Gemini.

    Si apre il riquadro laterale di Gemini.

  3. Seleziona la casella di controllo Assistenza per le conversioni e fai clic su Salva impostazioni.

Spazi di lavoro di cui non è stato eseguito l'upgrade

Per gli spazi di lavoro precedenti di cui non è stato eseguito l'upgrade per utilizzare la conversione automatica di Gemini, l'assistenza alla conversione è attivata per impostazione predefinita dopo aver attivato Gemini per il progetto. Non sono necessari ulteriori passaggi.

Disattivare l'assistente per le conversioni

I passaggi per attivare l'assistente alle conversioni sono diversi a seconda che tu utilizzi o meno un'area di lavoro di conversione di cui è stato eseguito l'upgrade.

Aree di lavoro di cui è stato eseguito l'upgrade

Per attivare l'assistente per le conversioni negli spazi di lavoro per le conversioni di cui è stato eseguito l'upgrade: segui questi passaggi:

  1. Nella Google Cloud console, vai ad Aree di lavoro della conversione e seleziona la tua area di lavoro.

    Vai ad Aree di lavoro della conversione

  2. Fai clic su pen_spark Gemini.

    Si apre il riquadro laterale di Gemini.

  3. Seleziona la casella di controllo Assistenza per le conversioni e fai clic su Salva impostazioni.

Spazi di lavoro di cui non è stato eseguito l'upgrade

Per gli spazi di lavoro precedenti di cui non è stato eseguito l'upgrade per utilizzare la conversione automatica di Gemini, l'assistenza alla conversione è attivata per impostazione predefinita dopo aver attivato Gemini per il progetto.

Puoi disattivare l'assistente alle conversioni se disattivi Gemini per Google Cloud nel tuo progetto.

Aiutami a correggere i problemi di conversione degli oggetti

A volte il motore di conversione di codice e schema basato su regole potrebbe riscontrare problemi durante la traduzione degli oggetti da Oracle a PostgreSQL. Ad esempio, alcune funzioni di Oracle potrebbero non avere equivalenti diretti in PostgreSQL. Puoi utilizzare il prompt Aiutami a correggere i problemi di conversione degli oggetti per ricevere una proposta di modifiche al codice che possono risolvere il problema di conversione.

Questo prompt è disponibile solo per gli oggetti di codice modificabili che presentano problemi di conversione. Non puoi visualizzare questa richiesta per altri tipi di oggetti nell'area di lavoro della conversione.

Per utilizzare questo prompt:

  1. Nella Google Cloud console, vai a Aree di lavoro della conversione.

    Vai ad Aree di lavoro della conversione

  2. Nell'elenco degli spazi di lavoro della conversione disponibili, seleziona quello con cui vuoi lavorare.

    Viene visualizzato l'editor dello spazio di lavoro della conversione.

  3. Nel riquadro Oracle, seleziona uno dei tuoi oggetti Oracle.

  4. Nella visualizzazione dei dettagli dell'oggetto, seleziona Assistente alla conversione > Aiutami a correggere i problemi di conversione degli oggetti.

    Viene visualizzato un riquadro con i risultati del prompt.

  5. Verifica la schermata della differenza che mostra i miglioramenti proposti. Se i risultati ti piacciono, puoi utilizzare il pulsante Inserisci suggerimento per aggiornare l'oggetto convertito.

  6. Ripeti i passaggi per ogni oggetto di codice con errori. Man mano che applichi le proposte di codice, i modelli di Gemini apprendono il pattern e possono offrire suggerimenti su come propagare le correzioni a tutti gli oggetti con errori nello spazio di lavoro.

Spiega la logica di conversione per questo oggetto

Con il prompt Spiega la logica di conversione per questo oggetto, puoi ricevere una spiegazione passo passo del funzionamento del codice convertito, incluso un riepilogo delle best practice applicate nel nuovo codice.

Per richiedere una spiegazione della logica di conversione degli oggetti:

  1. Nella Google Cloud console, vai a Aree di lavoro della conversione.

    Vai ad Aree di lavoro della conversione

  2. Nell'elenco degli spazi di lavoro della conversione disponibili, seleziona quello con cui vuoi lavorare.

    Viene visualizzato l'editor dello spazio di lavoro della conversione.

  3. Nel riquadro Oracle, seleziona uno dei tuoi oggetti Oracle.

  4. Nella visualizzazione dei dettagli dell'oggetto, seleziona Assistente alla conversione > Spiega la logica di conversione per questo oggetto.

    Viene visualizzato un riquadro con i risultati del prompt.

Aiutami a ottimizzare questo codice

A volte i risultati della conversione di codice e schema basati su regole possono essere tecnicamente corretti, ma non completamente ottimizzati per gli ambienti PostgreSQL. Puoi utilizzare il prompt Aiutami a ottimizzare questo codice per ricevere una proposta con ottimizzazioni del codice per l'oggetto database.

Per utilizzare questo prompt:

  1. Nella Google Cloud console, vai a Aree di lavoro della conversione.

    Vai ad Aree di lavoro della conversione

  2. Nell'elenco degli spazi di lavoro della conversione disponibili, seleziona quello con cui vuoi lavorare.

    Viene visualizzato l'editor dello spazio di lavoro della conversione.

  3. Nel riquadro Oracle, seleziona uno dei tuoi oggetti Oracle.

  4. Nella visualizzazione dei dettagli dell'oggetto, seleziona Assistente per le conversioni > Aiutami a ottimizzare questo codice.

    Viene visualizzato un riquadro con i risultati del prompt.

  5. Nel riquadro dei risultati, leggi la spiegazione, esamina il codice e assicurati che la proposta sia in linea con le tue esigenze. Se i risultati ti soddisfano, puoi utilizzare il pulsante Inserisci suggerimento per aggiornare l'oggetto convertito.

Aggiungi commenti per spiegare lo scopo di questo oggetto

Il prompt Aggiungi commenti per spiegare lo scopo di questo oggetto genera una proposta di commenti al codice che puoi aggiungere all'oggetto del database per lo schema autodocumentante.

Per utilizzare questo prompt:

  1. Nella Google Cloud console, vai a Aree di lavoro della conversione.

    Vai ad Aree di lavoro della conversione

  2. Nell'elenco degli spazi di lavoro della conversione disponibili, seleziona quello con cui vuoi lavorare.

    Viene visualizzato l'editor dello spazio di lavoro della conversione.

  3. Nel riquadro Oracle, seleziona uno dei tuoi oggetti Oracle.

  4. Nella visualizzazione dei dettagli dell'oggetto, seleziona Assistente alla conversione > Aggiungi commenti per spiegare lo scopo di questo oggetto.

    Viene visualizzato un riquadro con i risultati del prompt.

  5. Nel riquadro dei risultati, leggi la spiegazione, esamina il codice e assicurati che la proposta sia in linea con le tue esigenze. Se i risultati ti soddisfano, puoi utilizzare il pulsante Inserisci suggerimento per aggiornare l'oggetto convertito.

Propagare le correzioni dei problemi di conversione con la conversione del codice Gemini

Quando risolvi i problemi di conversione nella tua area di lavoro, i modelli Gemini possono imparare dalle correzioni e suggerire modifiche ad altri oggetti con errori nell'area di lavoro. In questo modo puoi propagare le correzioni a più oggetti senza dover apportare tutte le modifiche manualmente.

Attivare i suggerimenti per le conversioni di Gemini

I suggerimenti di conversione sono attivati per impostazione predefinita quando attivi Gemini per Google Cloud nel tuo progetto. Se in precedenza hai disattivato questa funzionalità, puoi riattivarla nella tua area di lavoro. I passaggi per attivare i suggerimenti di conversione sono diversi a seconda che tu utilizzi o meno uno spazio di lavoro per le conversioni di cui è stato eseguito l'upgrade.

Aree di lavoro di cui è stato eseguito l'upgrade

Per attivare l'assistente per le conversioni negli spazi di lavoro per le conversioni di cui è stato eseguito l'upgrade: segui questi passaggi:

  1. Nella Google Cloud console, vai ad Aree di lavoro della conversione e seleziona la tua area di lavoro.

    Vai ad Aree di lavoro della conversione

  2. Fai clic su pen_spark Gemini.

    Si apre il riquadro laterale di Gemini.

  3. Seleziona la casella di controllo Corrispondenza pattern e fai clic su Salva impostazioni.

Spazi di lavoro di cui non è stato eseguito l'upgrade

Per gli spazi di lavoro precedenti di cui non è stato eseguito l'upgrade per utilizzare la conversione automatica di Gemini, i suggerimenti di conversione sono attivati per impostazione predefinita dopo che hai attivato Gemini per il tuo progetto. Se in precedenza hai disattivato i suggerimenti di conversione, segui questa procedura per riattivarli:

  1. Nella Google Cloud console, vai ad Aree di lavoro della conversione e seleziona la tua area di lavoro.

    Vai ad Aree di lavoro della conversione

  2. Nella barra delle app, fai clic su pen_spark Gemini e seleziona Suggerimento codice.

    I suggerimenti di conversione del codice Gemini sono ora abilitati per questo spazio di lavoro di conversione.

Disattivare i suggerimenti di conversione di Gemini

I passaggi per attivare l'assistente alle conversioni sono diversi a seconda che tu utilizzi o meno un'area di lavoro di conversione di cui è stato eseguito l'upgrade.

Aree di lavoro di cui è stato eseguito l'upgrade

Per attivare i suggerimenti di conversione negli spazi di lavoro di conversione di cui è stato eseguito l'upgrade:

  1. Nella Google Cloud console, vai ad Aree di lavoro della conversione e seleziona la tua area di lavoro.

    Vai ad Aree di lavoro della conversione

  2. Fai clic su pen_spark Gemini.

    Si apre il riquadro laterale di Gemini.

  3. Deseleziona la casella di controllo Corrispondenza pattern e fai clic su Salva impostazioni.

Spazi di lavoro di cui non è stato eseguito l'upgrade

Per disattivare i suggerimenti di conversione per le aree di lavoro precedenti di cui non è stato eseguito l'upgrade per utilizzare la conversione automatica di Gemini:

  1. Nella Google Cloud console, vai ad Aree di lavoro della conversione e seleziona la tua area di lavoro.

    Vai ad Aree di lavoro della conversione

  2. Nella barra delle app, fai clic su pen_spark Gemini e seleziona Suggerimento codice.

    I suggerimenti di conversione del codice Gemini sono ora disabilitati per questo spazio di lavoro di conversione.

Visualizzare i suggerimenti di conversione di Gemini in Database Migration Service

Quando risolvi i problemi relativi agli oggetti (modificando il codice dell'oggetto SQL o applicando il codice proposto dal prompt Aiutami a correggere i problemi di conversione degli oggetti), i modelli Gemini analizzano le modifiche. Dopo aver apportato modifiche sufficienti, l'integrazione di Gemini visualizza un prompt e suggerisce ulteriori modifiche.

Per accedere ai suggerimenti di Gemini:

  1. Nella Google Cloud console, vai a Aree di lavoro della conversione.

    Vai ad Aree di lavoro della conversione

  2. Nell'elenco degli spazi di lavoro della conversione disponibili, seleziona quello con cui vuoi lavorare.

    Viene visualizzato l'editor dello spazio di lavoro della conversione.

  3. Nel riquadro Oracle, seleziona l'oggetto di cui vuoi modificare il codice SQL generato.

  4. Risolvi i problemi di conversione riscontrati con l'oggetto e salva le modifiche al codice. Puoi modificare il codice manualmente o utilizzare il prompt Aiutami a correggere i problemi di conversione degli oggetti.

    I modelli Gemini analizzano le correzioni più recenti finché non possono suggerire aggiornamenti simili ad altri oggetti con problemi di conversione. Quando i modelli Gemini hanno analizzato un numero sufficiente di correzioni, viene visualizzata la finestra di dialogo Esaminare i suggerimenti di Gemini.

    Finestra di dialogo per la risoluzione dei problemi di Gemini.
    Figura 2. Finestra di dialogo per la risoluzione dei problemi di Gemini. (fai clic per ingrandire)
    Finestra di dialogo per la risoluzione dei problemi di Gemini.
  5. Per visualizzare i suggerimenti creati con l'IA in base alle modifiche apportate, fai clic su Esamina suggerimenti.

Esamina i suggerimenti di conversione di Gemini

La pagina Risolvi i problemi con Gemini mostra i suggerimenti generati dai modelli Gemini in base alle modifiche al codice apportate. Questi suggerimenti contengono modifiche simili che puoi applicare ad altri oggetti. Per ogni suggerimento, puoi esaminarlo, modificarlo, accettarlo o ignorarlo.

La pagina Risolvere i problemi relativi a Gemini mostra tre varianti del codice sorgente di un oggetto, che puoi selezionare nel menu Visualizza modifica:

  • Codice sorgente originale (sola lettura)
  • Codice sorgente della bozza di destinazione (sola lettura)
  • Codice sorgente di destinazione generato con l'assistenza di Gemini (modificabile)

Il riquadro Oggetti contiene un elenco di oggetti con problemi e correzioni suggerite dai modelli Gemini.

Per esaminare i suggerimenti di Gemini:

  1. Fai clic su un oggetto per visualizzare la correzione suggerita dall'IA correlata.
  2. Esamina e modifica il codice suggerito dai modelli Gemini.
  3. Esegui una di queste operazioni:

    • Per accettare il suggerimento (incluse le modifiche), fai clic su Accetta codice. Le modifiche vengono applicate all'oggetto nello spazio di lavoro per le conversioni e lo stato dell'oggetto nell'elenco degli oggetti passa da Pending (In attesa) a Accepted (Accettato).

    • Per mantenere il suggerimento (incluse le modifiche) senza applicare le modifiche, passa a un altro oggetto. L'oggetto rimane nello stato Pending. Puoi modificare il codice e accettare o ignorare il suggerimento in un secondo momento.

    • Per ignorare i suggerimenti in attesa o accettati (e annullare le modifiche), fai clic su Ignora codice. Lo stato dell'oggetto nell'elenco degli oggetti passa da Pending a Ignored. Le modifiche sono state annullate. Puoi modificare il codice e applicarlo in un secondo momento.

Per chiudere i suggerimenti di Gemini e annullare tutte le modifiche che non hai applicato, segui questi passaggi:

  1. Nella pagina Risolvi i problemi con Gemini, fai clic sulla Freccia indietro.
  2. Nella finestra di dialogo Chiudi Gemini, fai clic su Chiudi.

    La sessione Gemini corrente è chiusa. Per tornare alla pagina dei suggerimenti, accedi di nuovo ai suggerimenti di Gemini.

Passaggi successivi