O Database Migration Service integra o Gemini para Google Cloud aos espaços de trabalho de conversão para ajudar você a acelerar e melhorar o processo de conversão nas seguintes áreas:
-
Melhore os resultados da conversão determinística com a conversão automática com tecnologia do Gemini para usar o poder da IA e reduzir significativamente o número de ajustes manuais necessários no código PostgreSQL.
- Oferecer recursos de explicabilidade de código com o assistente de conversão: um conjunto de comandos dedicados que podem ajudar você a entender melhor a lógica de conversão, propor correções para problemas de conversão ou otimizar o código convertido.
- Verifique o código convertido com as avaliações de qualidade do Gemini. O Gemini pode ajudar a analisar se o código convertido está correto e se tem equivalência funcional com o código-fonte.
-
Agilize a aplicação de 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 aprende conforme você corrige problemas de conversão e sugere mudanças em outros objetos com falha no espaço de trabalho.
Também é possível combinar esse recurso com a explicabilidade de código para uma experiência completa de conversão de objetos de código com tecnologia do 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 assistida de código e esquema com modelos do Gemini, seu código e 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 se aplicam. Para mais informações, consulte Preços do Gemini para Google Cloud .
Antes de começar
Para usar os recursos do Gemini no Database Migration Service, ative o Gemini para o Google Cloud no seu projeto.
Depois de ativar o Gemini para Google Cloud no seu projeto, você pode usar todos os recursos de conversão com tecnologia do Gemini no seu espaço de trabalho.
Funções exigidas
Para receber as permissões necessárias para usar os recursos de conversão
aprimorados pelo Gemini, peça ao administrador para conceder a você o papel de
Administrador do Database Migration (roles/datamigration.admin)
no projeto.
Para mais informações sobre como conceder papéis, consulte Gerenciar acesso na documentação do Identity and Access Management.
Esse papel predefinido contém as permissões necessárias para usar os recursos de conversão aprimorados pelo Gemini. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:
Permissões necessárias
As permissões a seguir são necessárias para realizar migrações heterogêneas do SQL Server com o Database Migration Service:
datamigration.*cloudaicompanion.entitlements.get
Usar a conversão automática do Gemini
Quando você converte 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 deterministas para reduzir o número de problemas de conversão e melhorar a qualidade da conversão.
É possível realizar outras avaliações de qualidade e equivalência funcional para objetos de código aprimorados com correções do Gemini. Para mais informações, consulte Avaliações de qualidade do Gemini.
Para usar a conversão automática, faça o seguinte:
- Crie um novo espaço de trabalho de conversão. Faça upgrade imediatamente para usar a experiência simplificada mais recente.
- Acesse Espaços de trabalho de conversão e selecione seu espaço de trabalho.
- Ative a conversão automática no seu espaço de trabalho.
- Converta o código-fonte e o esquema. Clique em
Converter origem.
O Database Migration Service usa automaticamente melhorias com tecnologia do Gemini na conversão. Use a visualização em árvore para ver quais objetos são aprimorados com o Gemini:
Figura 1. Visualização em árvore do esquema de origem com o status de aumento do Gemini. (clique para ampliar)
Na visualização em árvore, selecione qualquer objeto aumentado para ver os detalhes das melhorias fornecidas pela conversão automática. Se você não gostar das mudanças feitas pelo Gemini, clique em Usar código determinista para reverter o objeto para os resultados da conversão determinista.
Figura 2. Painel de conversão automática com tecnologia do Gemini, em que é possível inspecionar os detalhes das melhorias de código e esquema. (clique para ampliar)
Ativar conversão automática
Se você desativou a conversão automática, é possível ativá-la no painel do Gemini:
- No console do Google Cloud , acesse Espaços de trabalho de conversão e selecione seu espaço de trabalho.
- Clique em pen_spark Gemini.
O painel lateral do Gemini será aberto.
- 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.
- Opcional: na caixa de diálogo Converter objetos de origem com o Gemini?,
clique em Converter.
Os objetos convertidos não são modificados quando você ativa a conversão automática. É possível converter o esquema novamente mais tarde.
Desativar a conversão automática
Para desativar a conversão automática, faça o seguinte:
- No console do Google Cloud , acesse Espaços de trabalho de conversão e selecione seu espaço de trabalho.
- Clique em pen_spark Gemini.
O painel lateral do Gemini será aberto.
- 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 vai usar código determinista e conversão de esquema ao converter seu esquema.
- Opcional: na caixa de diálogo Converter objetos de origem?, clique em
Converter.
Os objetos convertidos não são modificados quando você desativa a conversão automática. É possível converter o esquema novamente mais tarde se você 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 você pode usar 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é mesmo adicionar comentários ao esquema para objetos de banco de dados autodocumentados.
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 ativá-lo novamente no seu espaço de trabalho. Para ativar o assistente de conversão, faça o seguinte:
- No console do Google Cloud , acesse Espaços de trabalho de conversão e selecione seu espaço de trabalho.
- Clique em pen_spark Gemini.
O painel lateral do Gemini será aberto.
- Marque a caixa de seleção Assistência de conversão e clique em Salvar configurações.
Desativar o assistente de conversão
Para desativar o assistente de conversão, faça o seguinte:
- No console do Google Cloud , acesse Espaços de trabalho de conversão e selecione seu espaço de trabalho.
- Clique em pen_spark Gemini.
O painel lateral do Gemini será aberto.
- Marque a caixa de seleção Assistência de conversão e clique em Salvar configurações.
Ajuda para corrigir problemas de conversão de objetos
O mecanismo de conversão de código e esquema baseado em regras pode, às vezes, 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 Ajuda para corrigir problemas de conversão de objetos para receber uma proposta de mudanças no código que podem corrigir o problema de conversão.
Esse comando está disponível apenas para objetos de código editáveis que têm problemas de conversão. Não é possível ver esse comando para outros tipos de objetos no espaço de trabalho de conversão.
Para usar esse comando, faça o seguinte:
No console do Google Cloud , acesse Espaços de trabalho de conversão.
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.
No painel Oracle, selecione um dos objetos Oracle.
Na visualização de detalhes do objeto, selecione
Assistência > Ajuda para corrigir problemas de conversão de objetos.Um painel com os resultados do comando é aberto.
Verifique a tela de diferenças que mostra as melhorias propostas. Se você gostar dos resultados, use o botão Inserir sugestão para atualizar o objeto convertido.
Repita as etapas para cada objeto de código de falha. Conforme 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 falha 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 deste objeto, você recebe 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:
No console do Google Cloud , acesse Espaços de trabalho de conversão.
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.
No painel Oracle, selecione um dos objetos Oracle.
Na visualização de detalhes do objeto, selecione
Assist > Explicação da lógica de conversão deste objeto.Um painel com os resultados do comando é aberto.
Ajuda para otimizar este código
Às vezes, os resultados da conversão de código e esquema baseada em regras podem ser tecnicamente corretos, mas não totalmente otimizados para ambientes do PostgreSQL. Use o comando Ajuda para otimizar este código para receber uma proposta com otimizações de código para seu objeto de banco de dados.
Para usar esse comando, faça o seguinte:
No console do Google Cloud , acesse Espaços de trabalho de conversão.
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.
No painel Oracle, selecione um dos objetos Oracle.
Na visualização de detalhes do objeto, selecione
Assist > Quero ajuda para otimizar este código.Um painel com os resultados do comando é aberto.
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 para explicar a finalidade deste objeto produz 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 esse comando, faça o seguinte:
No console do Google Cloud , acesse Espaços de trabalho de conversão.
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.
No painel Oracle, selecione um dos objetos Oracle.
Na visualização de detalhes do objeto, selecione
Assist > Adicionar comentários para explicar a finalidade deste objeto.Um painel com os resultados do comando é aberto.
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.
Garantir a qualidade da conversão com as avaliações de qualidade do Gemini
O Gemini pode ajudar você a validar o resultado da conversão de código e esquema com avaliações de qualidade. Essas avaliações se concentram em verificar a equivalência funcional do código convertido (ou seja, garantir que o código do PostgreSQL produza os mesmos resultados que o código de origem do SQL Server), mas os relatórios também incluem feedback detalhado sobre a qualidade geral da conversão. Os problemas encontrados no código são gerados como novos problemas de conversão.
É possível configurar avaliações de qualidade automáticas para seu espaço de trabalho ou gerar os relatórios manualmente para objetos selecionados.
Ativar avaliações de qualidade automáticas
É possível configurar seu espaço de trabalho de conversão para executar automaticamente as avaliações de qualidade do Gemini em objetos de código qualificados. Esse recurso também exige que você ative a conversão automática do Gemini.
Para configurar as avaliações de qualidade automáticas, faça o seguinte:
- No console do Google Cloud , acesse Espaços de trabalho de conversão e selecione seu espaço de trabalho.
- Clique em pen_spark Gemini.
O painel lateral do Gemini será aberto.
- Marque a caixa de seleção Avaliação da qualidade da conversão e clique em Salvar configurações.
Agora, o Database Migration Service cria automaticamente relatórios de avaliação de qualidade para os objetos convertidos.
Gerar um relatório manual de avaliação de qualidade
É possível executar uma avaliação de qualidade sob demanda para qualquer objeto de código compatível que tenha sido convertido com o recurso de conversão automática do Gemini.
Para realizar uma avaliação de qualidade manual:
- No console do Google Cloud , acesse Espaços de trabalho de conversão e selecione seu espaço de trabalho.
-
No editor do espaço de trabalho de conversão, use o painel de origem para selecionar um objeto cuja conversão é aprimorada com o Gemini.
Use o filtro
Augmented by Geminipara facilitar a navegação. Para mais informações, consulte Filtrar objetos na visualização do esquema de origem. - No painel Detalhes da conversão, selecione a guia Relatório de avaliação de qualidade e clique em Avaliar a qualidade deste código.
- A avaliação é executada, e os resultados são exibidos na guia Relatório de avaliação de qualidade.
Limitações para avaliações de qualidade
- As avaliações de qualidade do Gemini só são compatíveis com objetos convertidos com o recurso de conversão automática do Gemini.
- Os objetos de esquema não são compatíveis com as avaliações de qualidade.
- A avaliação se concentra principalmente na equivalência funcional e na qualidade geral. Os relatórios não incluem testes de desempenho.
Propagar correções de problemas de conversão com a conversão de código do Gemini
Quando você corrige problemas de conversão no espaço de trabalho, os modelos do Gemini podem aprender com as correções e sugerir mudanças em outros objetos com falha no espaço de trabalho. Assim, você pode propagar as 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 projeto. Se você desativou esse recurso, poderá ativá-lo novamente no seu espaço de trabalho. Para ativar o assistente de conversão, faça o seguinte:
- No console do Google Cloud , acesse Espaços de trabalho de conversão e selecione seu espaço de trabalho.
- Clique em pen_spark Gemini.
O painel lateral do Gemini será aberto.
- Marque a caixa de seleção Correspondência de padrões e clique em Salvar configurações.
Desativar as sugestões de conversão do Gemini
Para desativar as sugestões de conversão, faça o seguinte:
- No console do Google Cloud , acesse Espaços de trabalho de conversão e selecione seu espaço de trabalho.
- Clique em pen_spark Gemini.
O painel lateral do Gemini será aberto.
- Desmarque a caixa de seleção Correspondência de padrões e clique em Salvar configurações.
Ver 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 Ajuda para corrigir problemas de conversão de objetos), os modelos do Gemini analisam as mudanças. Depois que mudanças suficientes forem feitas, a integração do Gemini vai mostrar um comando e sugerir mais edições.
Para acessar as sugestões do Gemini:
No console do Google Cloud , acesse Espaços de trabalho de conversão.
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.
No painel Oracle, selecione o objeto com o SQL gerado que você quer ajustar.
Corrija os problemas de conversão encontrados no objeto e salve as mudanças no código. É possível 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é que possam 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 Analisar sugestões do Gemini vai aparecer.
Figura 2. Caixa de diálogo de correção de problemas do Gemini. (clique para ampliar)
Para ver as sugestões geradas com IA com base nas mudanças que você fez, clique em Analisar sugestões.
Analisar as sugestões de conversão do Gemini
A página Corrigir problemas com o Gemini mostra 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, é possível revisar, mudar, 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 podem ser selecionadas no menu Visualização de ediçã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 Objetos contém uma lista de objetos com problemas e sugestões de ajuste sugeridas pelos modelos do Gemini.
Para analisar as sugestões do Gemini, siga estas etapas:
- Clique em um objeto para mostrar a correção sugerida por IA relacionada.
- Revise e edite o código sugerido pelos modelos do Gemini.
Escolha uma destas opções:
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 Pendente para Aceito.
Para manter a sugestão (incluindo suas edições) sem aplicar as mudanças, mude para outro objeto. O objeto permanece no estado Pendente. É possível 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 foram 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:
- Na página Corrigir problemas com o Gemini, clique na seta para voltar.
Na caixa de diálogo Fechar o Gemini, clique em Fechar.
A sessão atual do Gemini está encerrada. Para voltar à página de sugestões, acesse as sugestões do Gemini novamente.
A seguir
Saiba como trabalhar com espaços de trabalho de conversão.
Saiba como o Gemini usa seus dados.
Siga o exemplo de fluxo de trabalho para corrigir problemas de conversão com a assistência do Gemini.