Migração do Oracle para PostgreSQL

A extensão PostgreSQL para Visual Studio Code fornece um fluxo de trabalho de ponta a ponta para migrar bancos de dados Oracle para PostgreSQL. Um assistente guiado orienta você na conexão com sua fonte Oracle, na seleção de esquemas, na configuração de um modelo do Microsoft Foundry para conversão de DDL assistida por IA e na escolha de um banco de dados temporário do PostgreSQL para validação. Depois que o projeto é criado, um painel rastreia a extração, a conversão, a exportação e a revisão em um único modo de exibição.

Importante

O fluxo de trabalho de migração do Oracle para PostgreSQL está disponível apenas em Visual Studio Code.

Pré-requisitos

Antes de começar, verifique se você tem:

  • Visual Studio Code instalado.
  • A extensão PostgreSQL instalada.
  • Acesso a um banco de dados de origem Oracle com permissões de leitura para extração de esquema.
  • Uma instância do PostgreSQL para ser usada como um banco de dados temporário para validação (por exemplo, um Servidor Flexível do Banco de Dados do Azure para PostgreSQL).
  • Um recurso Microsoft Foundry com um gpt-5.2 modelo implantado. Você precisa da URL do endpoint e de uma chave de API ou de uma conta do Microsoft Entra ID com acesso.

Verificar se o recurso de migrações está habilitado

A pgsql.enableMigrations configuração controla a exibição Migrações (Versão Prévia) e todos os comandos de migração. Essa configuração é habilitada por padrão.

Se a exibição Migrações (Versão Prévia) não aparecer na barra lateral, verifique a configuração:

  1. Abra as configurações do VS Code (Ctrl+, em Windows/Linux, Cmd+, no macOS).
  2. Pesquise por pgsql.enableMigrations.
  3. Confirme se o valor é true.

Criar um projeto de migração

Um projeto de migração é um assistente em quatro etapas que coleta as configurações de origem, de destino e de IA antes de criar o espaço de trabalho do projeto.

Etapa 1: Configuração do projeto

  1. Abra a exibição Migrações (Versão Prévia) na barra lateral.

  2. Selecione o botão + na barra de ferramentas da visualização ou clique com o botão direito do mouse em uma pasta da área de trabalho no Explorer e selecione Criar Projeto de Migração.

    A página Novo projeto de migração do Oracle para o Banco de Dados do Azure para PostgreSQL é exibida, listando o que você precisa:

    • Detalhes da conexão para o banco de dados de origem
    • Nome dos esquemas a serem convertidos
    • URL do ponto de extremidade e chave para um recurso do Microsoft Foundry
    • Nome da conexão para uma instância existente do PostgreSQL

  3. Insira um nome no campo Nome do Project.

  4. Selecione Avançar: Conexão Oracle.

Captura de tela da nova página do projeto de migração com o campo Nome do Projeto.

Etapa 2: Conectar-se ao Oracle

A página Conectar ao Oracle coleta suas credenciais de banco de dados de origem Oracle e permite carregar esquemas.

  1. Preencha os campos de conexão do Oracle:

    Campo Descrição
    Nome do host do Oracle Nome do host ou endereço IP do servidor de banco de dados Oracle.
    Porta Oracle Porta do ouvinte (padrão: 1521).
    Oracle SID ou Nome do Serviço Oracle SID ou nome de serviço para a instância do banco de dados.
    Nome de usuário do Oracle Usuário de banco de dados com acesso de leitura a objetos de esquema.
    Senha do Oracle Senha para o usuário do Oracle.

  2. Selecione Esquemas de Carga para se conectar e recuperar a lista de esquemas disponíveis.

  3. Na lista suspensa Esquemas, selecione um ou mais esquemas para migrar.

  4. Selecione Avançar: Conexão PostgreSQL.

Etapa 3: Escolha um banco de dados temporário do Banco de Dados do Azure para PostgreSQL

Na página Escolher um banco de dados temporário do Banco de Dados do Azure para PostgreSQL, você seleciona a instância do PostgreSQL que o modelo de IA usa para validar os arquivos DDL convertidos.

Note

Use um banco de dados temporário dedicado para validação. A extensão pode executar DDL convertido neste banco de dados durante o processo de conversão.

  1. Na lista suspensa Conexão PostgreSQL, selecione um perfil de conexão existente. Se a conexão necessária não estiver listada, selecione Atualizar Perfis para recarregar perfis disponíveis ou crie uma nova conexão na exibição Conexões e identidade primeiro.
  2. Na lista suspensa PostgreSQL Database, selecione o banco de dados de destino. Selecione Carregar Bancos de Dados se a lista estiver vazia.
  3. Depois de selecionar um banco de dados, a extensão verifica automaticamente se as extensões do PostgreSQL recomendadas estão instaladas. Você também pode selecionar Verificar Extensões para executar a verificação manualmente. Se houver extensões ausentes, a página lista essas extensões e fornece orientações sobre como adicioná-las à lista de permissões e instalá-las por meio da documentação do Servidor Flexível do Banco de Dados do Azure para PostgreSQL.
  4. Selecione Avançar: Configuração do modelo do Microsoft Foundry.

Etapa 4: Configurar o modelo Microsoft Foundry

A página Escolher um modelo de Microsoft foundry configura a implantação do Microsoft Foundry que alimenta o esquema e a conversão de código.

  1. Conclua os campos do modelo de idioma:

    Campo Descrição
    Nome do modelo gpt-5.2.
    ponto de extremidade do Microsoft Foundry URL do ponto de extremidade do recurso do Microsoft Foundry (por exemplo, https://<resource>.openai.azure.com/).
    Método de Autenticação Escolha Chave de API ou Microsoft Entra ID.
    Chave da API do Microsoft Foundry Chave de API para o recurso Microsoft Foundry (mostrado quando o Método de Autenticação é Chave de API).
    Conta do Azure Conta Microsoft com acesso ao recurso (exibida quando o Método de Autenticação é Microsoft Entra ID).
    Tenant Locatário do Azure AD da conta (exibido quando o Método de Autenticação é Microsoft Entra Id).
    Nome da implantação Nome do modelo implantado em seu recurso Microsoft Foundry.

  2. Selecione Testar conexão do Microsoft Foundry para verificar a conectividade.

  3. Selecione Create Migration Project.

Dica

Microsoft Foundry recomenda 500.000 TPM (Tokens por Minuto) para um desempenho de migração ideal.

Executar a migração de esquema

Depois que o projeto for criado, o painel de Migração do Oracle será aberto. O painel exibe cartões de Migração de Esquema e Revisão de Esquema , juntamente com um accordion de Configurações que resume a configuração do projeto.

Extrair e converter esquemas

O card Migração de esquema (Etapa 1) executa a extração, a conversão e a exportação em um pipeline contínuo.

  1. No cartão Schema Migration, selecione Migrar.

    O rótulo do botão é atualizado à medida que o pipeline avança:

    Status Texto do botão
    Extração em execução Extraindo...
    Extração concluída, conversão pendente Retomar a migração
    Conversão em execução Convertendo ...
    Todas as fases concluídas Migração concluída

  2. Monitorar o progresso no cartão expandido:

    • Extração mostra o número de objetos extraídos (por exemplo, "15 de 42 objetos extraídos") e o esquema e o objeto que estão sendo processados no momento.
    • Conversão mostra o número de partes convertidas (por exemplo, "3 de 8 partes convertidas") e a parte que está sendo processada no momento.

  3. Após a conclusão da exportação, selecione Exibir Relatório de Migração para abrir o relatório de migração gerado.

Examinar tarefas de migração

O cartão revisão de esquema (Etapa 2) exibe itens que exigem atenção manual após a conversão. Um seletor de Agrupadas / Tarefas na parte superior da área de revisão permite que você escolha como percorrer a lista.

Visualização agrupada

A exibição Agrupada organiza tarefas de revisão em grupos de accordion recolhíveis por categoria. Use essa exibição quando quiser processar problemas relacionados juntos.

  1. No cartão Revisão de Esquema , selecione Examinar para expandir a superfície de revisão e selecione Agrupado.

  2. Use as guias Pendentes e Resolvidas para alternar entre tarefas que ainda precisam de atenção e tarefas que você já aprovou.

  3. Expanda um grupo para ver seus metadados (esquemas, tipos de objeto, criticidade) e os cartões de tarefas individuais dentro dele.

  4. Use as ações de nível de grupo para processar tarefas em massa:

    Ação Descrição
    Executar tudo Abra todas as tarefas pendentes no grupo no modo agente do Copilot para revisão assistida por IA.
    Resolver tudo Marque todas as tarefas do grupo como resolvidas. Uma caixa de diálogo de confirmação mostra o nome do grupo e a contagem de tarefas antes de prosseguir.
    Redefinir tudo Retorne todas as tarefas resolvidas no grupo para o estado pendente. Disponível na guia Resolvido .
    Exibir em Tarefas Alterne para a visualização plana Tarefas filtrada por este grupo.

  5. Para agir em uma única tarefa dentro do grupo, selecione Executar Tarefa para abri-la no modo de agente Copilot ou selecione Resolver para marcá-la concluída. Selecione Restaurar em uma tarefa concluída para retorná-la ao estado pendente.

Note

Resolva tudo e Redefinir todos são desabilitados quando um grupo contém mais de 800 tarefas.

Exibição de tarefas

A exibição Tarefas mostra todas as tarefas de revisão em uma tabela simples. Use essa exibição quando quiser classificar, filtrar ou pesquisar em todas as tarefas, independentemente do grupo.

  1. Selecione Tarefas no comutador.
  2. Use os menus suspensos de filtro (Status, Criticidade, Tipo de Objeto, Esquema) para restringir a lista de tarefas.
  3. Selecione Executar Tarefa em um item pendente para abri-la no modo de agente Copilot para revisão e correção assistidas por IA.
  4. Depois de corrigir um item, selecione Resolver para marcá-lo concluído.

Dica

Selecione Exibir Logs no painel para inspecionar arquivos de log de extração e conversão para solução de problemas.

Migrar código do aplicativo

Após a migração do esquema, converta o código do aplicativo específico do Oracle (scripts SQL, procedimentos armazenados, arquivos de controle do carregador, scripts de shell ou arquivos Java) em equivalentes compatíveis com PostgreSQL. A migração de aplicativo é um recurso de versão prévia.

Escolher um método de migração

A extensão oferece dois caminhos para a migração de código do aplicativo:

  • Modernização completa do aplicativo — Se a extensão de modernização de aplicativo do GitHub Copilot estiver instalada, selecione Migrar usando a modernização de aplicativo para continuar a migração com notas de código da conversão do esquema. Selecione Exibir notas de codificação para examinar as diretrizes geradas antes de prosseguir.
  • Opção somente para banco de dados — Para converter apenas o código do aplicativo relacionado ao banco de dados nesta extensão, selecione Migrar usando a extensão PostgreSQL.

Converter código do aplicativo dentro da extensão

  1. No cartão Migração de Aplicativos, selecione Migrar dados (ou Selecionar método se for detectada a extensão de modernização de aplicativos).
  2. Na página Converter Aplicativo , selecione Selecionar Aplicativo Oracle para Converter e escolha a pasta que contém o código do aplicativo Oracle.
  3. Selecione uma Conexão PostgreSQL e o Banco de Dados PostgreSQL para o contexto de conversão.
  4. Selecione Carregar Bancos de Dados se a lista de bancos de dados estiver vazia.
  5. Selecione Converter Aplicativo para iniciar a conversão.

Usar ferramentas de Copilot para migração de aplicativos

A extensão registra duas ferramentas de modelo de linguagem Copilot para assistência de migração:

  • Conversor de Código de Aplicação Cliente Oracle (pgsql_migration_oracle_app) — converte o código de aplicação cliente Oracle para equivalentes em PostgreSQL usando modelos de prompts e orientações de codificação da análise de migração de esquema. Aceita os seguintes parâmetros:

    • Pasta do código-fonte do aplicativo (obrigatório) — Local do código a ser convertido.
    • Caminho de localização de notas de codificação (opcional) – caminho para codificar anotações da migração de esquema.
    • Nome do BD postgres (opcional) — nome do banco de dados PostgreSQL para contexto de conversão.
    • Conexão postgres DB (opcional) – nome da conexão para o banco de dados PostgreSQL.

  • Mostrar o Relatório de Migração do Oracle para Postgres (pgsql_migration_show_report) – exibe o relatório de migração gerado pela conversão de esquema. Requer um parâmetro Caminho para o Arquivo de Relatório .

Para obter mais informações sobre como usar Copilot ferramentas, consulte Copilot integração.

Comparar arquivos convertidos

Após a conversão, examine as alterações lado a lado usando os comandos de diferenciação internos.

  1. No Explorer, clique com o botão direito do mouse em um arquivo SQL convertido na pasta oracle ou postgres no projeto de migração e selecione Comparar pares de arquivos de migração DDL.
  2. Para arquivos de código de aplicativo convertidos (.sql, .ctl, .sh, .loadou .java), clique com o botão direito do mouse no arquivo e selecione Comparar Pares de Arquivos de Migração de Aplicativo.

A visualização de comparação lado a lado mostra o código-fonte original do Oracle ao lado da saída convertida para PostgreSQL, para que você possa identificar eventuais artefatos que exijam ajuste manual.

Note

Os arquivos DDL devem seguir a estrutura folder/oracle|postgres/SCHEMA_NAME/DDL-TYPE/filename.sql do comando compare para localizar o par de arquivos correspondente.

Gerenciar projetos de migração

Use a visualização Migrações (Versão Prévia) na barra lateral para gerenciar seus projetos:

Ação Descrição
Projeto de Migração Aberto Abra um projeto de migração existente no painel.
Mostrar no Explorador de Arquivos Mostrar a pasta do projeto no modo de exibição do Explorer.
Delete Remova um projeto de migração. Você será solicitado a confirmar antes da exclusão.
Atualizar Recarregue a lista de projetos de migração no workspace atual.

Conteúdo relacionado

  • Last updated on