Converter o código e o esquema do Oracle com a assistência do Gemini

O Database Migration Service integra o Gemini para Google Cloud aos espaços de trabalho de conversão para ajudar a acelerar e melhorar o processo de conversão em duas áreas:

  • Forneça recursos de explicabilidade do código com o assistente de conversão: um conjunto de comandos dedicados que podem ajudar a entender melhor a lógica de conversão, propor correções para problemas de conversão ou otimizar o código convertido.

  • Aplique correções para problemas de conversão com as sugestões de conversão de código do Gemini: um mecanismo em que o modelo do Gemini pode aprender à medida que você corrige problemas de conversão e sugere mudanças em outros objetos com falhas no espaço de trabalho.

Também é possível combinar as duas abordagens para uma experiência completa de conversão de objeto de código assistida pelo Gemini. Para mais informações, consulte Exemplo de fluxo de trabalho para corrigir objetos de código com problemas de conversão.

O código e o esquema SQL são armazenados na região em que você cria o espaço de trabalho de conversão. Se você usar a conversão de código e esquema assistida com modelos Gemini, o código e os esquemas poderão ser processados em outras regiões.

Saiba como e quando o Gemini do Google Cloud usa seus dados.

Custos

Para usar a assistência do Gemini nos espaços de trabalho de conversão do Database Migration Service, ative o Gemini para a API do Google Cloud . Os preços do Gemini são válidos. Para mais informações, consulte Preços do Gemini para Google Cloud .

Antes de começar

Para usar a assistência do Gemini em espaços de trabalho de conversão do Database Migration Service, ative o Gemini para Google Cloud no seu projeto.

Ativar a API

Depois de ativar o Gemini para Google Cloud no seu projeto, os recursos do Gemini são ativados para todos os seus espaços de trabalho de conversão. Depois, você pode desativar as sugestões em um espaço de trabalho específico.

Usar o assistente de conversão do Gemini

O assistente de conversão é um conjunto de solicitações dedicadas que podem ser usadas para entender melhor a lógica de conversão de objetos, pedir ideias sobre como otimizar o código e corrigir problemas de conversão ou até adicionar comentários ao seu esquema para objetos de banco de dados autodocumentados.

Uma captura de tela que mostra como acessar os comandos do Gemini
      para a explicabilidade da conversão de código e esquema.
Figura 1. Comandos do assistente de conversão do Gemini. (Clique para ampliar)
Uma captura de tela que mostra como acessar os comandos do Gemini para explicar a conversão de código e esquema.

Ajuda para corrigir problemas de conversão de objetos

O mecanismo de conversão de código e esquema baseado em regras pode encontrar problemas ao traduzir objetos do Oracle para o PostgreSQL. Por exemplo, algumas funções do Oracle podem não ter equivalentes diretos no PostgreSQL. Você pode usar o comando Help me fix object conversion issues para receber uma proposta de mudanças no código que podem corrigir o problema de conversão.

Essa solicitação está disponível apenas para objetos de código editáveis com problemas de conversão. Não é possível visualizar esse comando para outros tipos de objetos no espaço de trabalho de conversão.

Para usar essa solicitação, faça o seguinte:

  1. No console do Google Cloud , acesse Espaços de trabalho de conversão.

    Acessar os espaços de trabalho de conversão

  2. Na lista de espaços de trabalho de conversão disponíveis, selecione o espaço de trabalho de conversão com que você quer trabalhar.

    O editor do espaço de trabalho de conversão é aberto.

  3. No painel Oracle, selecione um dos seus objetos do Oracle.

  4. Na visualização de detalhes do objeto, selecione Assistente de conversão > Ajuda para corrigir problemas de conversão de objetos.

    Um painel com os resultados da solicitação é aberto.

  5. Verifique a tela de diferença que mostra as melhorias propostas. Se você gostar dos resultados, use o botão Insert suggestion para atualizar o objeto convertido.

  6. Repita as etapas para cada objeto de código com falha. À medida que você aplica as propostas de código, os modelos do Gemini aprendem o padrão e podem oferecer sugestões sobre como propagar as correções para todos os objetos com falhas no seu espaço de trabalho.

Explicação da lógica de conversão deste objeto

Com o comando Explicar a lógica de conversão para este objeto, você pode receber uma explicação detalhada do que o código convertido faz, incluindo um resumo das práticas recomendadas aplicadas no novo código.

Para solicitar uma explicação da lógica de conversão de objetos, faça o seguinte:

  1. No console do Google Cloud , acesse Espaços de trabalho de conversão.

    Acessar os espaços de trabalho de conversão

  2. Na lista de espaços de trabalho de conversão disponíveis, selecione o espaço de trabalho de conversão com que você quer trabalhar.

    O editor do espaço de trabalho de conversão é aberto.

  3. No painel Oracle, selecione um dos seus objetos do Oracle.

  4. Na visualização de detalhes do objeto, selecione Assistente de conversão > Explicar a lógica de conversão deste objeto.

    Um painel com os resultados da solicitação é aberto.

Ajuda para otimizar este código

Às vezes, os resultados da conversão de código e esquema com base em regras podem ser tecnicamente corretos, mas não totalmente otimizados para ambientes PostgreSQL. Use o comando Help me optimize this code para receber uma proposta com otimizações de código para seu objeto de banco de dados.

Para usar essa solicitação, faça o seguinte:

  1. No console do Google Cloud , acesse Espaços de trabalho de conversão.

    Acessar os espaços de trabalho de conversão

  2. Na lista de espaços de trabalho de conversão disponíveis, selecione o espaço de trabalho de conversão com que você quer trabalhar.

    O editor do espaço de trabalho de conversão é aberto.

  3. No painel Oracle, selecione um dos seus objetos do Oracle.

  4. Na visualização de detalhes do objeto, selecione Assistente de conversão > Ajude a otimizar este código.

    Um painel com os resultados da solicitação é aberto.

  5. No painel de resultados, leia a explicação, revise o código e verifique se a proposta está de acordo com o que você precisa. Se você gostar dos resultados, use o botão Inserir sugestão para atualizar o objeto convertido.

Adição de comentários sobre a finalidade deste objeto

O comando Adicionar comentários sobre a finalidade deste objeto gera uma proposta de comentários de código que podem ser adicionados ao objeto do banco de dados para o esquema de autodocumentação.

Para usar essa solicitação, faça o seguinte:

  1. No console do Google Cloud , acesse Espaços de trabalho de conversão.

    Acessar os espaços de trabalho de conversão

  2. Na lista de espaços de trabalho de conversão disponíveis, selecione o espaço de trabalho de conversão com o qual você quer trabalhar.

    O editor do espaço de trabalho de conversão é aberto.

  3. No painel Oracle, selecione um dos seus objetos do Oracle.

  4. Na visualização de detalhes do objeto, selecione Assistente de conversão > Adicionar comentários para explicar a finalidade deste objeto.

    Um painel com os resultados da solicitação é aberto.

  5. No painel de resultados, leia a explicação, revise o código e verifique se a proposta está de acordo com o que você precisa. Se você gostar dos resultados, use o botão Inserir sugestão para atualizar o objeto convertido.

Propague correções de problemas de conversão com a conversão de código do Gemini

Quando você corrige problemas de conversão no seu espaço de trabalho, os modelos do Gemini podem aprender com as correções e sugerir mudanças em outros objetos com falhas no espaço de trabalho. Assim, você pode propagar suas correções para vários objetos sem fazer todas as edições manualmente.

Conferir as sugestões de conversão do Gemini no Database Migration Service

Quando você corrige problemas de objetos (editando o código do objeto SQL ou aplicando o código proposto pelo comando Help me fix object conversion issues), os modelos do Gemini analisam suas mudanças. Depois que mudanças suficientes forem feitas, a integração do Gemini vai mostrar um aviso e sugerir outras edições.

Para acessar as sugestões do Gemini:

  1. No console do Google Cloud , acesse Espaços de trabalho de conversão.

    Acessar os espaços de trabalho de conversão

  2. Na lista de espaços de trabalho de conversão disponíveis, selecione o espaço de trabalho de conversão com que você quer trabalhar.

    O editor do espaço de trabalho de conversão é aberto.

  3. No painel Oracle, selecione o objeto cujo SQL gerado você quer ajustar.

  4. Corrija problemas de conversão encontrados com o objeto e salve as mudanças de código. Você pode editar o código manualmente ou usar o comando Ajuda para corrigir problemas de conversão de objetos.

    Os modelos do Gemini analisam as correções mais recentes até poderem sugerir atualizações semelhantes para outros objetos com problemas de conversão. Quando os modelos do Gemini analisarem um número suficiente de correções, a caixa de diálogo Review suggestions from Gemini será exibida.

    Caixa de diálogo de correção de problemas do Gemini.
    Figura 2. Caixa de diálogo de correção de problemas do Gemini. (Clique para ampliar)
    Caixa de diálogo de correção de problemas do Gemini.
  5. Para conferir as sugestões geradas por IA com base nas mudanças feitas, clique em Analisar sugestões.

Analisar as sugestões de conversão do Gemini

A página Corrigir problemas com o Gemini mostra as sugestões geradas pelos modelos do Gemini com base nas mudanças de código que você fez. Essas sugestões contêm mudanças semelhantes que podem ser aplicadas a outros objetos. Para cada sugestão, você pode revisar, mudar, aceitar ou ignorar a sugestão.

A página Corrigir problemas com o Gemini mostra três variantes do código-fonte de um objeto, que podem ser selecionadas no menu Editar visualização:

  • Código-fonte original (somente leitura)
  • Código-fonte de destino do rascunho (somente leitura)
  • Código-fonte de destino gerado com a assistência do Gemini (editável)

O painel Objects contém uma lista de objetos com problemas e correções sugeridas pelos modelos do Gemini.

Para analisar as sugestões do Gemini, siga estas etapas:

  1. Clique em um objeto para mostrar a correção sugerida pela IA.
  2. Revise e edite o código sugerido pelos modelos do Gemini.
  3. Escolha uma destas opções:

    • Para aceitar a sugestão (incluindo suas edições), clique em Aceitar código. As mudanças são aplicadas ao objeto no espaço de trabalho de conversão, e o estado do objeto na lista de objetos muda de Pendente para Aceito.

    • Para manter a sugestão (incluindo suas edições) sem aplicar as mudanças, mude para um objeto diferente. O objeto permanece no estado Pendente. Você pode editar o código e aceitar ou ignorar a sugestão mais tarde.

    • Para ignorar sugestões pendentes ou aceitas (e reverter suas edições), clique em Ignorar código. O estado do objeto na lista de objetos muda de Pendente para Ignorado. Suas mudanças são revertidas. Você pode editar o código e aplicá-lo mais tarde.

Para fechar as sugestões do Gemini e descartar todas as mudanças que você não aplicou, siga estas etapas:

  1. Na página Corrigir problemas com o Gemini, clique na seta de volta.
  2. Na caixa de diálogo Close Gemini, clique em Close.

    A sessão atual do Gemini está fechada. Para voltar à página de sugestões, acesse as sugestões do Gemini novamente.

Desativar as sugestões de conversão do Gemini

Por padrão, as sugestões de conversão do Gemini são ativadas para seus espaços de trabalho de conversão depois que você ativa o Gemini para seu projeto. É possível desativar as sugestões do Gemini em um espaço de trabalho de conversão específico. Para desativar as sugestões de correção de código do Gemini, siga estas etapas:

  1. No console do Google Cloud , acesse Espaços de trabalho de conversão.

    Acessar os espaços de trabalho de conversão

  2. Na lista de espaços de trabalho de conversão disponíveis, selecione o espaço de trabalho de conversão com que você quer trabalhar.

    O editor do espaço de trabalho de conversão é aberto.

  3. Na barra de tarefas, clique em pen_spark Gemini e selecione Sugestão de código.

As sugestões de conversão de código do Gemini foram desativadas para este espaço de trabalho de conversão.

A seguir