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

Database Migration Service integra Gemini per Google Cloud nelle aree di lavoro della conversione per aiutarti ad accelerare e migliorare il processo di conversione nei seguenti ambiti:

• Migliora i risultati della conversione deterministica con la conversione automatica basata su Gemini per sfruttare la potenza dell'AI e ridurre significativamente il numero di aggiustamenti manuali necessari nel codice PostgreSQL.

  Questa funzionalità è supportata solo per gli spazi di lavoro per le conversioni di cui è stato eseguito l'upgrade. È possibile eseguire l'upgrade solo degli spazi di lavoro appena creati. Per saperne di più, vedi Eseguire l'upgrade di un workspace della conversione.

• Fornisci funzionalità di spiegazione del codice con l' assistente alla conversione: un insieme di prompt dedicati che possono aiutarti a comprendere meglio la logica di conversione, proporre correzioni per i problemi di conversione o ottimizzare il codice convertito.

• Accelera l'applicazione delle correzioni per i problemi di conversione con i suggerimenti per la conversione del codice di Gemini: un meccanismo in cui il modello Gemini può imparare mentre correggi i problemi di conversione e suggerire modifiche ad altri oggetti difettosi nello spazio di lavoro.

  Puoi anche combinare questa funzionalità con la spiegazione del codice per un'esperienza di conversione completa e end-to-end degli oggetti di codice basata su Gemini. Per saperne di più, vedi Flusso di lavoro di esempio per la correzione di oggetti di codice con problemi di conversione.

Il codice SQL e lo schema vengono archiviati nella regione in cui crei l'area di lavoro di conversione. Se utilizzi la conversione assistita di codice e schema 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 Gemini per l'API. Google Cloud Vengono applicati i prezzi di Gemini. Per ulteriori informazioni, consulta la sezione Prezzi di Gemini per Google Cloud .

Prima di iniziare

Per utilizzare le funzionalità basate su Gemini in Database Migration Service, svolgi le seguenti operazioni:

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 tutti gli spazi di lavoro di conversione nel tuo progetto. Per utilizzare la conversione automatica, devi attivarla per ogni spazio di lavoro.

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

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per utilizzare le funzionalità di conversione avanzate con Gemini, chiedi all'amministratore di concederti il ruolo Database Migration Admin (roles/datamigration.admin) nel progetto.

Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso nella documentazione di Identity and Access Management.

Questo ruolo predefinito contiene le autorizzazioni necessarie per utilizzare le funzionalità di conversione avanzate con Gemini. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Utilizzare la conversione automatica di Gemini

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

Per utilizzare la conversione automatica:

1. Crea un nuovo workspace di conversione. Assicurati di eseguire immediatamente l'upgrade per utilizzare l'ultima esperienza semplificata.
2. Vai a Workspace della conversione e seleziona il tuo workspace.

   Vai alle aree di lavoro della conversione

3. Attiva la conversione automatica per il tuo spazio di lavoro.
4. Converti il codice sorgente e lo schema. Fai clic su move_down 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 ottimizzati con Gemini:

   

5. Nella visualizzazione ad albero, seleziona un oggetto aumentato per visualizzare i dettagli dei miglioramenti forniti dalla conversione automatica. Se le modifiche introdotte da Gemini non ti piacciono, fai clic su Usa codice deterministico per ripristinare i risultati della conversione deterministica dell'oggetto.

   

Attivare la conversione automatica

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

1. Nella console Google Cloud , vai a Workspace della conversione e seleziona il tuo workspace.

   Vai alle 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.

   L'area di lavoro di conversione ora 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 nuovamente lo schema in un secondo momento.

Disattivare la conversione automatica

Per disattivare la conversione automatica:

1. Nella console Google Cloud , vai a Workspace della conversione e seleziona il tuo workspace.

   Vai alle 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.

   L'area di lavoro di conversione ora utilizza 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. Se vuoi ripristinare i risultati della conversione per utilizzare regole di conversione deterministiche, puoi convertire nuovamente lo schema in un secondo momento.

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 documentare automaticamente gli oggetti di database.

Attivare l'assistente per le conversioni

L'assistente alla conversione è abilitato per impostazione predefinita quando attivi Gemini per Google Cloud nel tuo progetto. Se in precedenza hai disattivato l'assistente alla conversione, puoi riattivarlo nel tuo spazio di lavoro. I passaggi per attivare l'assistente alla conversione variano a seconda che tu utilizzi o meno un workspace di conversione aggiornato.

Disattivare l'assistente alle conversioni

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

Aiutami a correggere i problemi di conversione degli oggetti

Il motore di conversione di codice e schema basato su regole a volte potrebbe riscontrare problemi durante la conversione di oggetti da Oracle a PostgreSQL. Ad esempio, alcune funzioni 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 questo prompt per altri tipi di oggetti nel workspace della conversione.

Per utilizzare questo prompt:

1. Nella console Google Cloud , vai a Workspace della conversione.

   Vai alle aree di lavoro di conversione

2. Dall'elenco degli spazi di lavoro della conversione disponibili, seleziona quello che vuoi utilizzare.

   Si apre l'editor del workspace della conversione.

3. Nel riquadro Oracle, seleziona uno degli oggetti Oracle.

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

   Si apre un riquadro con i risultati del prompt.

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

6. Ripeti i passaggi per ogni oggetto codice difettoso. Man mano che applichi le proposte di codice, i modelli Gemini imparano il pattern e possono offrire suggerimenti su come propagare le correzioni a tutti gli oggetti difettosi nel tuo spazio di lavoro.

Spiega la logica di conversione per questo oggetto

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

Per richiedere una spiegazione della logica di conversione degli oggetti:

1. Nella console Google Cloud , vai a Workspace della conversione.

   Vai alle aree di lavoro di conversione

2. Dall'elenco degli spazi di lavoro della conversione disponibili, seleziona quello che vuoi utilizzare.

   Si apre l'editor del workspace della conversione.

3. Nel riquadro Oracle, seleziona uno degli oggetti Oracle.

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

   Si apre un riquadro con i risultati del prompt.

Aiutami a ottimizzare questo codice

A volte i risultati della conversione di codice e schema basata 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 le ottimizzazioni del codice per l'oggetto del database.

Per utilizzare questo prompt:

1. Nella console Google Cloud , vai a Workspace della conversione.

   Vai alle aree di lavoro di conversione

2. Dall'elenco degli spazi di lavoro della conversione disponibili, seleziona quello che vuoi utilizzare.

   Si apre l'editor del workspace della conversione.

3. Nel riquadro Oracle, seleziona uno degli oggetti Oracle.

4. Nella visualizzazione dei dettagli dell'oggetto, seleziona Assistente alla conversione > Aiutami a ottimizzare questo codice.

   Si apre 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 per i commenti al codice che puoi aggiungere all'oggetto del database per lo schema di autodocumentazione.

Per utilizzare questo prompt:

1. Nella console Google Cloud , vai a Workspace della conversione.

   Vai alle aree di lavoro di conversione

2. Dall'elenco degli spazi di lavoro della conversione disponibili, seleziona quello che vuoi utilizzare.

   Si apre l'editor del workspace della conversione.

3. Nel riquadro Oracle, seleziona uno degli oggetti Oracle.

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

   Si apre 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 correggi i problemi di conversione nel tuo workspace, i modelli Gemini possono imparare dalle tue correzioni e suggerire modifiche ad altri oggetti difettosi nel workspace. In questo modo puoi propagare le correzioni a più oggetti senza apportare manualmente tutte le modifiche.

Abilitare i suggerimenti per le conversioni di Gemini

I suggerimenti per le conversioni sono attivi per impostazione predefinita quando abiliti 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 per le conversioni variano a seconda che tu utilizzi o meno un'area di lavoro di conversione aggiornata.

Disattivare i suggerimenti per la conversione di Gemini

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

Visualizzare i suggerimenti di conversione di Gemini in Database Migration Service

Quando correggi i problemi degli 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 un numero sufficiente di modifiche, l'integrazione di Gemini mostra un prompt e suggerisce ulteriori modifiche.

Per accedere ai suggerimenti di Gemini:

1. Nella console Google Cloud , vai a Workspace della conversione.

   Vai alle aree di lavoro di conversione

2. Dall'elenco degli spazi di lavoro della conversione disponibili, seleziona quello che vuoi utilizzare.

   Si apre l'editor del workspace della conversione.

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

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

   I modelli Gemini analizzano le correzioni più recenti finché non riescono a 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 Esamina i suggerimenti di Gemini.

   

5. Per visualizzare i suggerimenti creati con l'AI in base alle modifiche apportate, fai clic su Rivedi suggerimenti.

Esaminare i suggerimenti per la conversione di Gemini

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

La pagina Risolvi i problemi con Gemini mostra tre varianti del codice sorgente di un oggetto, che puoi selezionare nel menu Visualizzazione di modifica:

• Codice sorgente originale (sola lettura)
• Codice sorgente della destinazione bozza (sola lettura)
• Codice sorgente della destinazione generato con l'aiuto 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 correlata suggerita dall'AI.
2. Rivedi 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 di conversione e lo stato dell'oggetto nell'elenco degli oggetti cambia da In attesa ad Accettato.

   • Per mantenere il suggerimento (incluse le modifiche) senza applicare le modifiche, passa a un altro oggetto. L'oggetto rimane nello stato In attesa. 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 In attesa a Ignorato. Le modifiche vengono 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 di Gemini corrente è chiusa. Per tornare alla pagina dei suggerimenti, accedi di nuovo ai suggerimenti di Gemini.

Passaggi successivi

• Scopri come utilizzare i workspace della conversione.

• Leggi la panoramica di Gemini per Google Cloud .

• Scopri in che modo Gemini utilizza i tuoi dati.

• Segui il flusso di lavoro di esempio per risolvere i problemi di conversione con l'aiuto di Gemini.