Tutorial: conversão de aplicativo do Oracle para o Banco de Dados do Azure para PostgreSQL – Servidor Flexível (Prévia)

Este tutorial orienta você pela conversão do código do aplicativo cliente Oracle em Banco de Dados do Azure para PostgreSQL usando a extensão Visual Studio Code PostgreSQL com GitHub Copilot Agent Mode para automatizar e validar a transformação de código.

Ele aborda a configuração do ambiente, a importação da base de código do aplicativo, a execução do processo de conversão e a revisão do código compatível com PostgreSQL gerado. Antes de começar, verifique se você concluiu um projeto de conversão de esquema para obter resultados ideais.

Veja o que você pode esperar durante a conversão:

  • Configuração do ambiente: Configure o GitHub Copilot Agent Mode com o modelo de IA apropriado
  • Importação do Codebase: organizar o código do aplicativo na estrutura do projeto de migração
  • Processamento de IA: O GitHub Copilot processa e converte o código de aplicação usando o contexto do banco de dados
  • Execução da tarefa TODO: geração automatizada de lista de tarefas e conversão sistemática
  • Geração de relatório: relatório de conversão abrangente com resultados e recomendações
  • Comparação de arquivos: ferramentas de comparação integradas para analisar o código original em relação ao código convertido

Pré-requisitos

Esta seção descreve os pré-requisitos para usar o recurso de conversão de aplicativos do Oracle para o Banco de Dados do Azure para PostgreSQL no Visual Studio Code antes de começar a conversão.

Requisitos do sistema

Requirement Especificação
Versão do Visual Studio Code 1,95,2 ou superior
Assinatura do GitHub Copilot Pro+, Business, Enterprise

Suporte ao sistema operacional

Platform Architecture
Windows x64 e ARM64
Linux x64 e ARM64
macOS x64 (Intel) e ARM64 (Apple Silicon)

Requisitos do modelo de IA

Você precisa de um dos seguintes modelos de IA configurados no modo de agente GitHub Copilot:

Modelo Version
Claude Sonnet 4.6 ou Opus 4.6 ou superior

Antes de iniciar a conversão do aplicativo, defina o modelo de modo do agente GitHub Copilot para Claude Sonnet 4.6 ou Claude Opus 4.6 ou superior para obter resultados ideais de transformação de código.

Suporte à versão do PostgreSQL

Banco de Dados de Destino Version
Servidor Flexível de Banco de Dados Azure para PostgreSQL PostgreSQL versão 15 ou superior
Azure HorizonDB PostgreSQL versão 17 ou superior

Recomendação de conversão de esquema

Embora não seja necessário executar uma conversão de esquema de banco de dados com antecedência, concluir uma migração de esquema primeiro é altamente recomendável. Se você já tiver convertido seu esquema Oracle em PostgreSQL, o processo de conversão de aplicativo fornecerá resultados mais precisos de contexto e de transformação de código de maior qualidade por meio de:

  • Notas de codificação: artefatos de metadados gerados durante a conversão de esquema (veja o que são notas de codificação? abaixo)
  • Contexto do banco de dados: acesso direto a objetos de esquema convertidos
  • Mapeamentos de tipo de dados: compreensão precisa das transformações de tipo

Outros pré-requisitos

  • Conectividade ao seu banco de dados na instância do Banco de Dados do Azure para PostgreSQL
  • Acesso ao Visual Studio Code marketplace de extensões e serviços de GitHub Copilot

O que são Notas de Codificação?

Notas de codificação são artefatos de metadados gerados automaticamente durante a fase de conversão de esquema. Eles capturam os principais detalhes de transformação e insights da conversão de esquema Oracle para PostgreSQL que o processo usa posteriormente para aprimorar a conversão de código do aplicativo.

As notas de codificação podem incluir informações como:

  • Mapeamentos de tipo de dados e alterações estruturais
  • Detalhes de conversão para sequências, identidades e tipos de composição
  • Ajustes nas implementações de data/hora ou intervalo
  • Referências a tabelas com restrições de integridade referencial
  • Resumos de pacotes Oracle complexos, incluindo assinaturas de procedimentos e funções
  • Dicas adicionais geradas por IA para melhorar a precisão da tradução de código

Durante a conversão do aplicativo, o modelo de IA usa essas anotações como sinais contextuais para produzir um código mais preciso e semanticamente alinhado compatível com PostgreSQL.

Processo de conversão de aplicativo

Esta seção percorre o fluxo de trabalho de conversão de aplicativo completo: configure seu ambiente, importe sua base de código, execute a conversão, examine o relatório gerado e compare as alterações de arquivo.

Etapa 1: Configurar seu ambiente

  • Abra Visual Studio Code com a extensão PostgreSQL instalada.
  • Abra a interface de chat GitHub Copilot.
  • Selecione Claude Sonnet 4.6 ou Claude Opus 4.6 para o modelo.

Captura de tela da seleção do modelo.

Usar o Claude Sonnet 4.6 ou Claude Opus 4.6 é necessário para obter resultados ideais de conversão de aplicativo. Modelos inferiores podem produzir conversões menos precisas.

Etapa 2: Abrir seu projeto de migração

  • Abra o workspace que contém o projeto de conversão de esquema.

  • Navegue até a estrutura da pasta do projeto de migração:

    .github/postgres-migration/project_name/

  • Verifique se a estrutura do projeto inclui as pastas e arquivos necessários da conversão de esquema.

Etapa 3: Copiar sua base de código para o projeto de migração

  • Localize a application_code pasta em seu projeto:

    .github/postgres-migration/project_name/application_code/

  • Copie a pasta codebase que você deseja migrar para a pasta dentro da application_code pasta do projeto.

  • Organize arquivos logicamente para facilitar a conversão sistemática.

Captura de tela da pasta de código do aplicativo dentro do projeto.

Mantenha o código do aplicativo original em um local separado como um backup. Copie apenas os arquivos que você deseja converter na estrutura do projeto de migração.

Etapa 4: Iniciar a migração de código do cliente

  • No painel migração da extensão PostgreSQL, selecione Migrar Aplicativo para iniciar o assistente de conversão de aplicativo.
  • No formulário que carrega, selecione a pasta que você copiou para a raiz do seu espaço de trabalho.
  • Escolha o banco de dados que tem o contexto para seu aplicativo:
    • O banco de dados PostgreSQL em que você implantou sua DDL convertida ou
    • O banco de dados PostgreSQL em que o esquema do aplicativo já existe
  • Selecione Converter Aplicativo. Captura de tela do Aplicativo Convert.

Esta ação inicia os seguintes processos:

  • Invoca um prompt de composição personalizado e uma ferramenta de modo de agente
  • Gera uma lista de tarefas pendentes em que o Modo de Agente continua trabalhando
  • Conecta-se e lê seu banco de dados para um contexto aprimorado
  • Converte sistematicamente arquivos de código do aplicativo

Etapa 5: Monitorar o progresso da conversão

  • Assista à interface do GitHub Copilot no Modo de Agente enquanto processa arquivos.
  • O agente trabalha através da lista TODO gerada de forma sistemática.
  • Analise os prompts ou perguntas do agente que possam exigir resposta.
  • Permita que o processo de conversão seja concluído completamente antes de examinar os resultados.

Etapa 6: Conversão aprimorada do Java com a extensão de Modernização de Aplicativos do GitHub Copilot (opcional)

Se estiver trabalhando com código Java: você pode aprimorar o processo de conversão instalando a Extensão de Modernização de Aplicativos do GitHub Copilot antes de iniciar a conversão.

Compilação automática de teste

As duas extensões do VS Code se comunicam entre si para fornecer integração perfeita. Ao converter Java código, a Extensão de Modernização de Aplicativo executa automaticamente uma compilação de teste do código convertido para identificar erros de sintaxe ou problemas de compilação no início do processo.

Geração automática de testes de unidade

Com base na base de código convertida, a Extensão de Modernização de Aplicativo gera automaticamente testes de unidade para ajudar a validar se o aplicativo convertido se comporta corretamente. Essa integração aproveita os recursos da Extensão de Modernização de Aplicativo para:

  • Analisar suas classes e métodos de Java convertidos
  • Gerar casos de teste apropriados para caminhos de código críticos
  • Criar dispositivos de teste que funcionam com suas conexões de banco de dados PostgreSQL

A instalação da Extensão de Modernização de Aplicativo do GitHub Copilot é altamente recomendada para projetos de migração Java, pois acelera significativamente a validação e melhora a qualidade da conversão por meio de verificações de compilação automatizadas e geração de teste.

Etapa 7: Examinar o relatório de conversão de código

  • Quando a conversão do aplicativo é concluída no Modo do Agente, ela gera e abre automaticamente um relatório abrangente.
  • O relatório fornece resultados detalhados e as próximas etapas recomendadas para sua conversão. Captura de tela do relatório de conversão.

Para obter orientações completas sobre o relatório: consulte Relatórios gerados pela conversão do aplicativo Oracle para o Banco de Dados do Azure para PostgreSQL (versão preliminar) para obter informações detalhadas sobre como interpretar os resultados da conversão, entender os status dos arquivos e planejar sua estratégia de validação.

Etapa 8: Comparar alterações de código usando o recurso de diferenciação de arquivo

  • Clique com o botão direito do mouse em um arquivo convertido (por exemplo, um .java arquivo) e selecione Comparar Pares de Arquivos de Migração de Aplicativo.
  • Isso abre uma exibição lado a lado de arquivos originais e convertidos.
  • Use isso para validar transformações críticas antes do teste.

Estrategia eficaz de comparação de arquivos: consulte os relatórios gerados de conversão de aplicativo do Oracle para Banco de Dados do Azure para PostgreSQL (versão prévia) para obter orientação sobre como priorizar quais arquivos examinar primeiro e como concentrar seus esforços de validação.

Etapa 9: Validar o código do aplicativo convertido

Etapas de validação essenciais:

  • Configurar um ambiente de teste de não produção com o esquema PostgreSQL convertido
  • Testar a conectividade do banco de dados com as novas cadeias de conexão do PostgreSQL
  • Executar fluxos de trabalho de negócios críticos para verificar o comportamento do aplicativo
  • Validar os resultados da consulta SQL em relação aos resultados esperados da Oracle
  • Abordar as áreas sinalizadas identificadas no relatório de conversão

Importante

Os sistemas de IA ocasionalmente podem cometer erros. Para evitar regressões funcionais, problemas de segurança ou problemas de acesso a dados, valide independentemente todo o código do aplicativo convertido antes de implantar em produção.

Abordagem de validação sistemática: use as estruturas de validação em Práticas recomendadas para converter o código do aplicativo Oracle para o Banco de Dados do Azure para PostgreSQL (versão preliminar) para priorizar os testes com base na complexidade da integração do Oracle e nos resultados do relatório de conversão.

Etapas pós-conversão

Depois de concluir a conversão do aplicativo:

  • Executar testes de unidade: execute o conjunto de testes do aplicativo em relação ao código convertido.
  • Teste de integração: teste o aplicativo com o banco de dados PostgreSQL.
  • Teste de desempenho: valide se o desempenho da consulta atende aos requisitos.
  • Revisão de código: fazer com que os membros da equipe examinem o código convertido para obter precisão.
  • Atualização da documentação: atualize qualquer documentação que faça referência a recursos específicos do Oracle.

Estratégias abrangentes de validação: consulte Práticas recomendadas para converter o código de aplicativos Oracle para o Banco de Dados do Azure para PostgreSQL (Versão prévia) para obter frameworks detalhados de validação, prioridades de teste e abordagens de coordenação de equipe com base na complexidade da sua conversão.

Para obter mais informações sobre a extensão Visual Studio Code, visite a extensão PostgreSQL para Visual Studio Code

Conteúdo relacionado

  • Última atualização em