Tutorial: Conversão de aplicações Oracle para o Servidor Flexível do Base de Dados do Azure para PostgreSQL (Preview)

Este tutorial orienta-o na conversão do código da aplicação cliente Oracle para Base 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.

Abrange a configuração do seu ambiente, a importação da base de código da sua aplicação, a execução do processo de conversão e a revisão do código gerado compatível com PostgreSQL. Antes de começar, certifique-se de que concluiu um projeto de conversão de esquema para obter resultados ótimos.

Aqui está o que pode esperar durante a conversão:

Configuração do Ambiente: Configurar GitHub Copilot Modo Agente com o modelo de IA apropriado
Importação de base de código: Organize o código da sua aplicação na estrutura do projeto de migração
Processamento de IA: O GitHub Copilot processa e converte o código da aplicação usando o contexto da base de dados
Execução de tarefas TODO: Geração automatizada de listas 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 ficheiros: Ferramentas de diff integradas para rever o código original e o convertido

Pré-requisitos

Esta secção descreve os pré-requisitos para usar a funcionalidade de conversão de aplicações Oracle to Base de Dados do Azure para PostgreSQL no Visual Studio Code antes de iniciar uma conversão.

Requisitos do sistema

Requisito	Especificação
Versão do Visual Studio Code	1.95.2 ou superior
Subscrição do GitHub Copilot	Pro+, Negócios, Empresas

Suporte de sistema operativo

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

Requisitos do modelo de IA

Precisa de um dos seguintes modelos de IA configurados no GitHub Copilot Agent Mode:

Model	Versão
Claude	Soneto 4.6 ou Opus 4.6 ou superior

Antes de iniciar a conversão de aplicações, defina o seu Modelo de Modo Agente GitHub Copilot para Claude Sonnet 4.6 ou Claude Opus 4.6 ou superior para obter resultados ótimos na transformação de código.

Suporte a versões PostgreSQL

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

Recomendação de conversão de esquemas

Embora não seja obrigatório realizar uma conversão de esquema de base de dados antes, é fortemente recomendado concluir primeiro a migração do esquema. Se já converteu o seu esquema Oracle para PostgreSQL, o processo de conversão da aplicação fornece um contexto mais preciso e resultados de transformação de código de maior qualidade através de:

Notas de Codificação: Artefactos de metadados gerados durante a conversão de esquema (ver O que são Notas de Codificação? abaixo)
Contexto da base de dados: Acesso direto a objetos de esquema convertidos
Mapeamentos de tipos de dados: Compreensão precisa das transformações de tipos

Outros pré-requisitos

Conectividade à base de dados com a sua instância Base de Dados do Azure para PostgreSQL
Acesso ao mercado de extensões Visual Studio Code e aos serviços do GitHub Copilot

O que são as Notas de Programação?

As Notas de Codificação são artefactos de metadados gerados automaticamente durante a fase de conversão de esquema. Eles capturam detalhes chave de transformação e insights da sua conversão de esquema Oracle-para-PostgreSQL, que o processo utiliza posteriormente para melhorar a conversão do código da aplicação.

As Notas de Codificação podem incluir informações como:

Mapeamentos de tipos de dados e alterações estruturais
Detalhes de conversão para sequências, identidades e tipos compostos
Ajustes em implementações de data/hora ou intervalo
Referências a tabelas com restrições de integridade referencial
Resumos de pacotes complexos da Oracle, 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 de aplicações, o modelo de IA utiliza estas notas como sinais contextuais para produzir código compatível com PostgreSQL mais preciso e semanticamente alinhado.

Processo de conversão de aplicações

Esta secção percorre todo o fluxo de trabalho de conversão de aplicações: configure o seu ambiente, importe a sua base de código, execute a conversão, reveja o relatório gerado e compare alterações nos ficheiros.

Passo 1: Configura o teu ambiente

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

É necessário usar Claude Sonnet 4.6 ou Claude Opus 4.6 para obter resultados ótimos de conversão de aplicações. Modelos inferiores podem produzir conversões menos precisas.

Passo 2: Abra o seu projeto de migração

Abra o espaço de trabalho que contém o seu projeto de conversão de esquema.
Navegue até à estrutura de pastas do projeto de migração:
```
.github/postgres-migration/project_name/
```
Verifique se a estrutura do projeto inclui as pastas e ficheiros necessários da conversão de esquemas.

Passo 3: Copie a sua base de código para o projeto de migração

Localize a application_code pasta no seu projeto:

.github/postgres-migration/project_name/application_code/

Copia a pasta de código-base que queres migrar para a application_code pasta dentro da pasta do teu projeto.
Organize os ficheiros de forma lógica para facilitar a conversão sistemática.

Guarde o código original da sua aplicação num local separado como backup. Só copie os ficheiros que quer converter para a estrutura do projeto de migração.

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

No painel de Migração da extensão PostgreSQL, selecione Migrar Aplicação para iniciar o assistente de conversão de aplicações.
No formulário que carrega, selecione a pasta que copiou para a raiz do seu espaço de trabalho.
Escolha a base de dados que tenha o contexto para a sua aplicação:
- A base de dados PostgreSQL onde implementaste o teu DDL convertido, ou
- A base de dados PostgreSQL onde já existe o esquema da tua aplicação
Selecione Converter Aplicação.

Esta ação inicia os seguintes processos:

Invoca um prompt personalizado composto e uma ferramenta no Modo Agente
Gera uma lista de tarefas que o Modo Agente passa a trabalhar em
Liga-se e lê a sua base de dados para obter um contexto melhorado
Converte sistematicamente ficheiros de código de aplicação

Passo 5: Monitorizar o progresso da conversão

Observe a interface do GitHub Copilot Agent Mode enquanto processa ficheiros.
O agente trabalha sistematicamente na lista de tarefas gerada.
Revise quaisquer sugestões ou perguntas do agente que possam exigir contributos.
Permita que o processo de conversão seja concluído totalmente antes de rever os resultados.

Passo 6: Conversão Java melhorada com a extensão GitHub Copilot App Modernization (opcional)

Se estiver a trabalhar com código Java: Pode melhorar o seu processo de conversão instalando a Extensão de Modernização de Aplicações GitHub Copilot antes de iniciar a conversão.

Compilação automática de testes

As duas extensões VS Code comunicam entre si para proporcionar uma integração fluida. Ao converter código Java, a Extensão de Modernização de Aplicações realiza automaticamente uma compilação de teste do seu código convertido para identificar quaisquer erros de sintaxe ou problemas de compilação logo no início do processo.

Geração automática de testes unitários

Com base na sua base de código convertida, a Extensão de Modernização de Aplicações gera automaticamente testes unitários para ajudar a validar se a sua aplicação convertida se comporta corretamente. Esta integração aproveita as capacidades da Extensão de Modernização de Aplicações para:

Analisa as tuas classes e métodos Java convertidos
Gerar casos de teste apropriados para caminhos críticos de código
Crie dispositivos de teste que funcionem com as suas ligações à base de dados PostgreSQL

A instalação da Extensão de Modernização de Aplicações GitHub Copilot é altamente recomendada para projetos de migração Java, pois acelera significativamente a validação e melhora a qualidade da conversão através de verificações automatizadas de compilação e geração de testes.

Passo 7: Rever o relatório de conversão de código

Quando a conversão da aplicação termina no Modo Agente, gera automaticamente e abre um relatório abrangente.
O relatório apresenta resultados detalhados e os próximos passos recomendados para a sua conversão.

Para orientações abrangentes sobre relatórios: Consulte os relatórios gerados pela conversão do aplicativo Oracle para Bases de Dados PostgreSQL no Azure (Pré-visualização) para obter informações detalhadas sobre como interpretar os seus resultados de conversão, compreender o estado dos ficheiros e planear a sua estratégia de validação.

Passo 8: Compare alterações de código usando a funcionalidade de diferença de ficheiro

Clique com o botão direito num ficheiro convertido (por exemplo, um .java ficheiro) e selecione Comparar Pares de Ficheiros de Migração de Aplicações.
Isto abre uma vista lado a lado dos ficheiros originais e convertidos.
Use isto para validar transformações críticas antes de testar.

Estratégia eficaz de comparação de ficheiros: Consulte os relatórios de conversão de aplicações do Oracle para a Base de Dados do Azure para PostgreSQL (Pré-visualização) para orientações sobre como priorizar quais ficheiros rever primeiro e focar os seus esforços de validação.

Passo 9: Validar o código convertido da aplicação

Passos essenciais de validação:

Configura um ambiente de teste não produtivo com o teu esquema PostgreSQL convertido
Testar a conectividade da base de dados com as novas strings de ligação PostgreSQL
Executar fluxos de trabalho críticos de negócio para verificar o comportamento da aplicação
Validar os resultados das consultas SQL em relação aos resultados esperados da Oracle
Endereços das áreas sinalizadas identificadas no relatório de conversão

Importante

Os sistemas de IA podem, por vezes, cometer erros. Para evitar regressões funcionais, problemas de segurança ou problemas de acesso a dados, valide de forma independente todo o código convertido da aplicação antes de o implementar em produção.

Abordagem de validação sistemática: Use os frameworks de validação no Melhores práticas para converter código de aplicação Oracle para Base de Dados do Azure para PostgreSQL (Pré-visualização) para priorizar testes com base na complexidade da sua integração Oracle e nos resultados do relatório de conversão.

Passos pós-conversão

Após concluir a conversão da aplicação:

Execute testes unitários: Execute o conjunto de testes da sua aplicação contra o código convertido.
Testes de integração: Teste a aplicação com a sua base de dados PostgreSQL.
Testes de desempenho: Validar que o desempenho da consulta cumpre os requisitos.
Revisão de código: Peça aos membros da equipa para reverem o código convertido para garantir a sua precisão.
Atualização da documentação: Atualize qualquer documentação que faça referência a funcionalidades específicas da Oracle.

Estratégias abrangentes de validação: Consulte Melhores práticas para converter código de aplicação Oracle para Base de Dados do Azure para PostgreSQL (Pré-visualização) para estruturas detalhadas de validação, prioridades de teste e abordagens de coordenação de equipas com base na sua complexidade de conversão.

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

Comentários

Esta página foi útil?

Última atualização a 2026-06-08