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 nas seguintes áreas:

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 para 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, é necessário ativar a API Gemini para Google Cloud . Os preços do Gemini são válidos. Para mais informações, consulte Preços do Gemini para Google Cloud .

Para usar os recursos com tecnologia Gemini no Database Migration Service, faça o seguinte:

  1. Ative o Gemini para Google Cloud no seu projeto.

    Ativar a API

  2. Depois de ativar o Gemini para Google Cloud no seu projeto, o assistente de conversão e a correspondência de padrões são ativados automaticamente para todos os espaços de trabalho de conversão no seu projeto. Para usar a conversão automática, é necessário ativá-la em cada espaço de trabalho.

    Ativar ou desativar cada recurso com tecnologia Gemini também depende se você usa um espaço de trabalho de conversão atualizado. Para mais informações sobre como ativar ou desativar cada recurso, consulte as próximas seções nesta página.

Usar a conversão automática do Gemini

Ao converter o esquema de origem, o Database Migration Service usa as regras de conversão determinísticas para criar os equivalentes de sintaxe do PostgreSQL. A conversão automática integra correções com tecnologia do Gemini aos resultados determinísticos para reduzir o número de problemas de conversão e melhorar a qualidade das conversões.

Para usar a conversão automática, faça o seguinte:

  1. Crie um novo espaço de trabalho de conversão. Faça o upgrade imediatamente para usar a experiência simplificada mais recente.
  2. Acesse Espaços de trabalho de conversão e selecione o seu.

    Acesse os espaços de trabalho de conversão

  3. Ative a conversão automática no seu espaço de trabalho.
  4. Converta o código-fonte e o esquema. Clique em Converter origem.

    O Database Migration Service usa automaticamente aprimoramentos com tecnologia Gemini na conversão. Use a visualização em árvore para conferir quais objetos são aumentados com o Gemini:

    Visualização em árvore de conversões com resumo de aprimoramento com tecnologia do Gemini.
    Figura 1. Visualização da árvore do esquema de origem com status de aumento do Gemini. (clique para ampliar)
    Visualização em árvore de conversões com resumo de aprimoramento com tecnologia do Gemini.
  5. Na visualização em árvore, selecione qualquer objeto aprimorado para conferir os detalhes dos aprimoramentos fornecidos pela conversão automática. Se você não gostar das mudanças introduzidas pelo Gemini, clique em Usar código determinista em vez disso para reverter o objeto aos resultados de conversão determinísticos.

    Painel de conversão automática com tecnologia do Gemini com detalhes sobre quais ajustes são implementados no esquema convertido.
    Figura 2. Painel de conversão automática do Gemini, em que você pode inspecionar os detalhes de código e aprimoramentos de esquema. (clique para ampliar)
    Painel de conversão automática com tecnologia do Gemini com detalhes sobre quais ajustes são implementados no esquema convertido.

Ativar a conversão automática

Se você desativou a conversão automática, é possível reativá-la no painel do Gemini:

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

    Acesse os espaços de trabalho de conversão

  2. Clique em pen_spark Gemini.

    O painel lateral do Gemini é aberto.

  3. Marque a caixa de seleção Conversão automática e clique em Salvar configurações.

    Agora, o espaço de trabalho de conversão vai ser convertido automaticamente quando você converter o esquema.

  4. Opcional: na caixa de diálogo Converter objetos de origem com o Gemini?, clique em Converter.

    Seus objetos convertidos não são modificados quando você ativa a conversão automática. Você pode converter seu esquema novamente mais tarde.

Desativar a conversão automática

Para desativar a conversão automática, faça o seguinte:

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

    Acesse os espaços de trabalho de conversão

  2. Clique em pen_spark Gemini.

    O painel lateral do Gemini é aberto.

  3. Desmarque a caixa de seleção Conversão automática e clique em Salvar configurações.

    Agora, o espaço de trabalho de conversão vai usar código determinístico e conversão de esquema ao converter seu esquema.

  4. Opcional: na caixa de diálogo Converter objetos de origem?, clique em Converter.

    Seus objetos convertidos não são modificados quando você desativa a conversão automática. Você pode converter seu esquema novamente mais tarde se quiser reverter os resultados da conversão para usar regras de conversão determinísticas.

Usar o assistente de conversão do Gemini

O assistente de conversão é um conjunto de comandos dedicados que podem ser usados 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 esquema para objetos de banco de dados autodocumentados.

Uma captura de tela que mostra como acessar os comandos do Gemini para explicar a 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.

Ativar o Assistente de conversão

O assistente de conversão é ativado por padrão quando você ativa o Gemini para Google Cloud no seu projeto. Se você desativou o Assistente de conversão, é possível reativá-lo no seu espaço de trabalho. As etapas para ativar o Assistente de conversão são diferentes dependendo se você usa ou não um espaço de trabalho de conversão atualizado.

Espaços de trabalho atualizados

Para ativar o assistente de conversão nos espaços de trabalho de conversão atualizados, faça o seguinte:

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

    Acesse os espaços de trabalho de conversão

  2. Clique em pen_spark Gemini.

    O painel lateral do Gemini é aberto.

  3. Marque a caixa de seleção Assistência de conversão e clique em Salvar configurações.

Espaços de trabalho não atualizados

Para espaços de trabalho mais antigos que não foram atualizados para usar a conversão automática do Gemini, a assistência de conversão é ativada por padrão depois que você ativa o Gemini para seu projeto. Você não precisa realizar outras etapas.

Desativar o Assistente de conversão

As etapas para ativar o assistente de conversão são diferentes dependendo de se você usa ou não um espaço de trabalho de conversão atualizado.

Espaços de trabalho atualizados

Para ativar o Assistente de conversão em espaços de trabalho de conversão atualizados, faça o seguinte:

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

    Acesse os espaços de trabalho de conversão

  2. Clique em pen_spark Gemini.

    O painel lateral do Gemini é aberto.

  3. Marque a caixa de seleção Assistência de conversão e clique em Salvar configurações.

Espaços de trabalho não atualizados

Para espaços de trabalho mais antigos que não foram atualizados para usar a conversão automática do Gemini, a assistência de conversão é ativada por padrão depois que você ativa o Gemini para seu projeto.

Você pode desativar o assistente de conversão se desativar o Gemini para Google Cloud no seu projeto.

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. Use o comando Help me fix object conversion issues para receber uma proposta de mudanças de 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 Inserir sugestão 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 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 > 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 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 > 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

A solicitação Adicionar comentários sobre a finalidade deste objeto gera uma proposta de comentários de código que você pode adicionar 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.

Ativar as sugestões de conversão do Gemini

As sugestões de conversão são ativadas por padrão quando você ativa o Gemini para Google Cloud no seu projeto. Se você desativou esse recurso, é possível ativá-lo novamente no seu espaço de trabalho. As etapas para ativar as sugestões de conversão são diferentes se você usa ou não um espaço de trabalho de conversão atualizado.

Espaços de trabalho atualizados

Para ativar o Assistente de conversão em espaços de trabalho de conversão atualizados, faça o seguinte:

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

    Acesse os espaços de trabalho de conversão

  2. Clique em pen_spark Gemini.

    O painel lateral do Gemini é aberto.

  3. Marque a caixa de seleção Correspondência de padrões e clique em Salvar configurações.

Espaços de trabalho não atualizados

Para espaços de trabalho mais antigos que não foram atualizados para usar a conversão automática do Gemini, as sugestões de conversão são ativadas por padrão depois que você ativa o Gemini para seu projeto. Se você desativou as sugestões de conversão, faça o seguinte para ativá-las novamente:

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

    Acesse os espaços de trabalho de conversão

  2. 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 agora estão ativadas para esse espaço de trabalho de conversão.

Desativar as sugestões de conversão do Gemini

As etapas para ativar o assistente de conversão são diferentes dependendo de se você usa ou não um espaço de trabalho de conversão atualizado.

Espaços de trabalho atualizados

Para ativar as sugestões de conversão em espaços de trabalho de conversão atualizados, faça o seguinte:

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

    Acesse os espaços de trabalho de conversão

  2. Clique em pen_spark Gemini.

    O painel lateral do Gemini é aberto.

  3. Desmarque a caixa de seleção Correspondência de padrão e clique em Salvar configurações.

Espaços de trabalho não atualizados

Para desativar as sugestões de conversão em espaços de trabalho mais antigos que não foram atualizados para usar a conversão automática do Gemini, faça o seguinte:

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

    Acesse os espaços de trabalho de conversão

  2. 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.

Conferir as sugestões de conversão da 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 prompt Help me fix object conversion issues), os modelos do Gemini analisam suas mudanças. Depois que mudanças suficientes são feitas, a integração do Gemini mostra um prompt e sugere 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 os 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 tiverem analisado um número suficiente de correções, a caixa de diálogo Review suggestions from Gemini será exibida.

    Caixa de diálogo de sugestões do Gemini para corrigir problemas.
    Figura 2. Caixa de diálogo de sugestões do Gemini para corrigir problemas. (Clique para ampliar)
    Caixa de diálogo de sugestões do Gemini para corrigir problemas.
  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 ajuda 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.

A seguir