Converta código e esquema Oracle com assistência Gemini

O Database Migration Service integra o Gemini para Google Cloud nos espaços de trabalho de conversão para ajudá-lo a acelerar e melhorar o processo de conversão nas seguintes áreas:

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

Saiba como e quando Gêmeos para Google Cloud usa seus dados .

Custos

Para usar a assistência do Gemini em espaços de trabalho de conversão do Database Migration Service, você precisa ativar o Gemini para Google Cloud API. O preço para Gêmeos se aplica. Para obter mais informações, consulte Gêmeos para Google Cloud preços .

Antes de começar

Para usar recursos do Gemini no Database Migration Service, faça o seguinte:

  1. Habilite o Gemini para Google Cloud em seu projeto.

    Habilite 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 , você precisa habilitá-la por espaço de trabalho.

    A ativação ou desativação de cada recurso do Gemini também depende de você usar um espaço de trabalho de conversão atualizado . Para obter mais informações sobre como ativar ou desativar cada recurso, consulte as próximas seções desta página.

Use a conversão automática do Gemini

Ao converter seu 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 baseadas no Gemini além dos resultados determinísticos para reduzir o número de problemas de conversão e melhorar a qualidade da conversão.

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

  1. Crie um novo espaço de trabalho de conversão . Certifique-se de atualizá-lo imediatamente para usar a experiência simplificada mais recente.
  2. Vá para Espaços de trabalho de conversão e selecione seu espaço de trabalho.

    Vá para espaços de trabalho de conversão

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

    O Database Migration Service emprega automaticamente melhorias do Gemini na conversão. Você pode usar a visualização em árvore para ver quais objetos são aumentados com o Gemini:

    Visualização em árvore de conversão com resumo de aumento desenvolvido pelo Gemini.
    Figura 1. Visualização em árvore do esquema de origem com status de aumento do Gemini. (clique para ampliar)
    Visualização em árvore de conversão com resumo de aumento desenvolvido pelo Gemini.
  5. Na visualização em árvore, selecione qualquer objeto aumentado para visualizar os detalhes dos aprimoramentos fornecidos pela conversão automática. Se você não gostar das alterações introduzidas pelo Gemini, clique em Usar código determinístico para reverter o objeto para os resultados da conversão determinística.

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

Ativar conversão automática

Se você desativou a conversão automática anteriormente, poderá ativá-la no painel Gemini:

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

    Vá para espaços de trabalho de conversão

  2. Clique em pen_spark Gêmeos .

    O painel lateral do Gemini é aberto.

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

    Seu espaço de trabalho de conversão agora será convertido automaticamente quando você converter seu esquema.

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

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

Desativar conversão automática

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

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

    Vá para espaços de trabalho de conversão

  2. Clique em pen_spark Gêmeos .

    O painel lateral do Gemini é aberto.

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

    Seu espaço de trabalho de conversão agora usará código determinístico e conversão de esquema quando você converter seu esquema.

  4. Opcional: Na seção Converter objetos de origem? caixa de diálogo, clique em Converter .

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

Use o assistente de conversão Gemini

O assistente de conversão é um conjunto de prompts dedicados que você pode usar para obter uma melhor compreensão da lógica de conversão de objetos, pedir ideias sobre como otimizar o código e solucionar seus problemas de conversão ou até mesmo adicionar comentários ao seu esquema para autodocumentar objetos de banco de dados.

Uma captura de tela que mostra como acessar os prompts do Gemini       para explicabilidade de conversão de código e esquema.
Figura 1. Solicitações do assistente de conversão Gemini. (clique para ampliar)
Uma captura de tela que mostra como acessar os prompts do Gemini       para explicabilidade de conversão de código e esquema.

Ativar assistente de conversão

O assistente de conversão é ativado por padrão quando você ativa o Gemini para Google Cloud em seu projeto. Se você desativou anteriormente o assistente de conversão, poderá ativá-lo novamente em 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 Google Cloud console, acesse Espaços de trabalho de conversão e selecione seu espaço de trabalho.

    Vá para espaços de trabalho de conversão

  2. Clique em pen_spark Gêmeos .

    O painel lateral do Gemini é aberto.

  3. Marque a caixa de seleção Assistência à 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 à conversão é habilitada por padrão depois que você habilita o Gemini para o seu projeto . Você não precisa realizar nenhuma etapa adicional.

Desativar assistente de conversão

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 em espaços de trabalho de conversão atualizados, faça o seguinte:

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

    Vá para espaços de trabalho de conversão

  2. Clique em pen_spark Gêmeos .

    O painel lateral do Gemini é aberto.

  3. Marque a caixa de seleção Assistência à 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 à conversão é habilitada por padrão depois que você habilita o Gemini para o seu projeto .

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

Ajude-me a corrigir problemas de conversão de objetos

O mecanismo de conversão de esquema e código baseado em regras às vezes pode encontrar problemas ao traduzir objetos do Oracle para PostgreSQL. Por exemplo, certas funções do Oracle podem não ter equivalentes diretos no PostgreSQL. Você pode usar o prompt Ajude-me a corrigir problemas de conversão de objetos para obter uma proposta de alterações de código que podem corrigir o problema de conversão.

Este prompt está disponível apenas para objetos de código editáveis ​​que apresentam problemas de conversão. Você não pode visualizar esse prompt para outros tipos de objetos no espaço de trabalho de conversão.

Para usar esse prompt, faça o seguinte:

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

    Vá para espaços de trabalho de conversão

  2. Na lista de áreas de trabalho de conversão disponíveis, selecione a área de trabalho de conversão com a qual deseja trabalhar.

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

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

  4. Na visualização de detalhes do objeto, selecione Assistente de conversão > Ajude-me a corrigir problemas de conversão de objetos .

    Um painel com resultados imediatos é aberto.

  5. Verifique a tela de comparação que mostra as melhorias propostas. Se gostar dos resultados, você pode usar o botão Inserir sugestão para atualizar o objeto convertido.

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

Explique a lógica de conversão para este objeto

Com o prompt Explique a lógica de conversão para este objeto , você pode obter uma explicação passo a passo 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 do objeto, faça o seguinte:

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

    Vá para espaços de trabalho de conversão

  2. Na lista de áreas de trabalho de conversão disponíveis, selecione a área de trabalho de conversão com a qual deseja trabalhar.

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

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

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

    Um painel com resultados imediatos é aberto.

Ajude-me a otimizar este código

Às vezes, os resultados do código baseado em regras e da conversão de esquema podem ser tecnicamente corretos, mas não totalmente otimizados para ambientes PostgreSQL. Você pode usar o prompt Ajude-me a otimizar este código para obter uma proposta com otimizações de código para seu objeto de banco de dados.

Para usar esse prompt, faça o seguinte:

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

    Vá para espaços de trabalho de conversão

  2. Na lista de áreas de trabalho de conversão disponíveis, selecione a área de trabalho de conversão com a qual deseja trabalhar.

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

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

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

    Um painel com resultados imediatos é 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 gostar dos resultados, você pode usar o botão Inserir sugestão para atualizar o objeto convertido.

Adicione comentários para explicar a finalidade deste objeto

O prompt Adicionar comentários para explicar a finalidade deste objeto produz uma proposta de comentários de código que você pode adicionar ao seu objeto de banco de dados para esquema autodocumentado.

Para usar esse prompt, faça o seguinte:

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

    Vá para espaços de trabalho de conversão

  2. Na lista de áreas de trabalho de conversão disponíveis, selecione a área de trabalho de conversão com a qual deseja trabalhar.

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

  3. No painel Oracle , selecione um dos seus objetos 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 resultados imediatos é 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 gostar dos resultados, você pode usar o botão Inserir sugestão para atualizar o objeto convertido.

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

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

Ativar 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 em seu projeto. Se você desativou esse recurso anteriormente, poderá ativá-lo novamente em seu espaço de trabalho. As etapas para ativar as sugestões 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 em espaços de trabalho de conversão atualizados, faça o seguinte:

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

    Vá para espaços de trabalho de conversão

  2. Clique em pen_spark Gêmeos .

    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 habilitadas por padrão depois que você habilita o Gemini para o seu projeto . Se você desativou anteriormente as sugestões de conversão, faça o seguinte para ativá-las novamente:

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

    Vá para 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 Gemini agora estão habilitadas para este espaço de trabalho de conversão.

Desativar sugestões de conversão do Gemini

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 sugestões de conversão em espaços de trabalho de conversão atualizados, faça o seguinte:

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

    Vá para espaços de trabalho de conversão

  2. Clique em pen_spark Gêmeos .

    O painel lateral do Gemini é aberto.

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

Espaços de trabalho não atualizados

Para desativar sugestões de conversão para 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 Google Cloud console, acesse Espaços de trabalho de conversão e selecione seu espaço de trabalho.

    Vá para 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 Gemini agora estão desativadas para este espaço de trabalho de conversão.

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

Quando você corrige problemas de objeto (editando o código do objeto SQL ou aplicando o código proposto pelo prompt Ajude-me a corrigir problemas de conversão de objeto ), os modelos Gemini analisam suas alterações. Depois que alterações suficientes forem feitas, a integração do Gemini exibe um prompt e sugere novas edições.

Para acessar as sugestões do Gêmeos:

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

    Vá para espaços de trabalho de conversão

  2. Na lista de áreas de trabalho de conversão disponíveis, selecione a área de trabalho de conversão com a qual deseja trabalhar.

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

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

  4. Corrija problemas de conversão encontrados no objeto e salve as alterações de código. Você pode editar o código manualmente ou usar o prompt Ajude-me a corrigir problemas de conversão de objetos .

    Os modelos Gemini analisam suas correções mais recentes até sugerir atualizações semelhantes para outros objetos com problemas de conversão. Quando os modelos Gemini tiverem analisado um número suficiente de suas correções, a caixa de diálogo Revisar sugestões do 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 visualizar sugestões geradas por IA com base nas alterações feitas, clique em Revisar sugestões .

Revise as sugestões de conversão do Gemini

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

A página Corrigir problemas com o Gemini exibe três variantes do código-fonte de um objeto, que você pode selecionar no menu Editar visualização :

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

O painel Objetos contém uma lista de objetos que apresentam problemas e correções sugeridas pelos modelos Gemini.

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

  1. Clique em um objeto para exibir a correção sugerida pela IA relacionada.
  2. Revise e edite o código sugerido pelos modelos Gemini.
  3. Faça um dos seguintes:

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

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

    • 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 Pending para Ignored . Suas alterações foram revertidas. Você pode editar o código e aplicá-lo mais tarde.

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

  1. Na página Corrigir problemas com o Gemini , clique na seta para trás.
  2. Na caixa de diálogo Fechar Gemini , clique em Fechar .

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

O que vem a seguir