Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
A extensão PostgreSQL para Visual Studio Code fornece um fluxo de trabalho de ponta a ponta para migrar bases de dados Oracle para PostgreSQL. Um assistente guiado guia-o na ligação à sua fonte Oracle, seleção de esquemas, configuração de um modelo Microsoft Foundry para conversão DDL assistida por IA e escolha de uma base de dados scratch PostgreSQL para validação. Após a criação do projeto, um painel acompanha a extração, conversão, exportação e revisão numa única visualização.
Importante
O fluxo de trabalho de migração do Oracle para PostgreSQL está disponível apenas no Visual Studio Code.
Pré-requisitos
Antes de começar, certifique-se de que tem:
- Visual Studio Code instalado.
- A extensão PostgreSQL instalada.
- Acesso a uma base de dados fonte Oracle com permissões de leitura para extração de esquemas.
- Uma instância do PostgreSQL para utilizar como base de dados de validação de teste (por exemplo, um Base de Dados do Azure para PostgreSQL – Flexible Server).
- Um recurso do Microsoft Foundry com um modelo
gpt-5.2implementado. Precisas do URL do endpoint e de uma chave API ou de uma conta Microsoft Entra ID com acesso.
Verificar se a funcionalidade de migrações está ativada
A pgsql.enableMigrations definição controla a vista de Migrações (Pré-visualização) e todos os comandos de migração. Esta definição está ativada por predefinição.
Se a vista de Migrações (Pré-visualização) não aparecer na barra lateral, verifique a definição:
- Abra as definições do VS Code (Ctrl+, no Windows/Linux, Cmd+, no macOS).
- Procure por
pgsql.enableMigrations. - Confirme que o valor é
true.
Criar um projeto de migração
Um projeto de migração é um assistente de quatro etapas que recolhe a sua configuração de código-fonte, destino e IA antes de criar o espaço de trabalho do projeto.
Passo 1: Configuração do Project
Abra a vista de Migrações (Pré-visualização) na barra lateral.
Selecione o botão + na barra de ferramentas da vista ou clique com o botão direito do rato numa pasta do espaço de trabalho no Explorador e selecione Criar Projeto de Migração.
A página do projeto de migração do New Oracle to Base de Dados do Azure para PostgreSQL abre-se, listando o que precisa:
- Detalhes de ligação para a base de dados de origem
- Nome do(s) esquema(s) a converter
- URL e chave do endpoint de um recurso do Microsoft Foundry
- Nome de ligação para uma instância PostgreSQL existente
Insira um nome no campo Project Name.
Selecione Próximo: Conexão Oracle.
Passo 2: Liga-te à Oracle
A página Ligar à Oracle recolhe as credenciais da base de dados de origem da Oracle e permite-lhe carregar esquemas.
Preencha os campos de ligação Oracle:
Campo Description Nome de Host Oracle Nome do host ou endereço IP do servidor de base de dados Oracle. Porta Oracle Porta do ouvinte (predefinida: 1521).Oracle SID ou Nome do Serviço Oracle SID ou nome de serviço para a instância da base de dados. Nome de utilizador Oracle Utilizador de base de dados com acesso de leitura a objetos de esquema. Palavra-passe Oracle Palavra-passe para o utilizador da Oracle. Selecione Carregar Esquemas para ligar e recuperar a lista de esquemas disponíveis.
Na lista suspensa Esquemas, selecione um ou mais esquemas para migrar.
Selecionar Próximo: Conexão PostgreSQL.
Passo 3: Escolha uma base de dados temporária do Base de Dados do Azure para PostgreSQL
A página Escolher uma base de dados temporária do Base de Dados do Azure para PostgreSQL permite selecionar a instância do Base de Dados do Azure para PostgreSQL que o modelo de IA utiliza para validar os ficheiros DDL convertidos.
Observação
Utilize uma base de dados temporária dedicada para validação. A extensão pode executar DDL convertido contra esta base de dados durante o processo de conversão.
- Na lista pendente Ligação PostgreSQL, selecione um perfil de ligação existente. Se a ligação que precisas não estiver listada, seleciona Atualizar Perfis para recarregar os perfis disponíveis, ou cria uma nova ligação na vista de Ligações e identidade primeiro.
- Na lista pendente Base de Dados PostgreSQL, selecione a base de dados de destino. Selecione Carregar Bases de Dados se a lista estiver vazia.
- Depois de selecionar uma base de dados, a extensão verifica automaticamente que as extensões PostgreSQL recomendadas estão instaladas. Também pode selecionar Verificar Extensões para executar a verificação manualmente. Se faltar alguma extensão, a página lista-a e fornece orientações sobre como a adicionar à lista de permissões e instalá-la na documentação do Servidor Flexível do Base de Dados do Azure para PostgreSQL.
- Selecionar Próximo: Configuração do Modelo Microsoft Foundry.
Passo 4: Configurar o modelo Microsoft Foundry
A página Escolher um Modelo do Microsoft Foundry configura a implantação do Microsoft Foundry que suporta a conversão de esquemas e código.
Complete os campos do modelo de linguagem:
Campo Description Nome do modelo gpt-5.2.Microsoft Foundry Endpoint URL do endpoint do recurso do Microsoft Foundry (por exemplo, https://<resource>.openai.azure.com/).Método de Autenticação Escolha API Key ou Microsoft Entra Id. Chave de API do Microsoft Foundry Chave API para o recurso Microsoft Foundry (mostrada quando o Método de Autenticação é Chave API). Azure Account Conta Microsoft com acesso ao recurso (apresentado quando método de autenticação é Microsoft Entra Id). Inquilino Tenant Azure AD para a conta (mostrado quando o Método de Autenticação é Microsoft Entra Id). Nome da implantação Nome do modelo implementado no seu recurso Microsoft Foundry. Selecione Testar Ligação Microsoft Foundry para verificar a conectividade.
Selecione Criar Projeto de Migração.
Gorjeta
A Microsoft Foundry recomenda 500.000 TPM (Tokens por Minuto) para um desempenho ótimo na migração.
Executar migração de esquemas
Após a criação do projeto, abre-se o painel de Migração da Oracle . O painel mostra cartões de Migração e Revisão de Esquemas , juntamente com um acordeão de Definições que resume a configuração do seu projeto.
Extrair e converter esquemas
O cartão de Migração de Esquema (Passo 1) executa extração, conversão e exportação como um pipeline contínuo.
No cartão de Migração de Esquema , selecione Migrar.
O texto do botão é atualizado à medida que o processamento avança:
Situação Rótulo do botão Extração em execução A extrair ... Extração concluída, conversão pendente Retomar migração Conversão em execução Converter ... Todas as fases concluídas Migração Completa Acompanhe o progresso no cartão expandido:
- A extração mostra a contagem de objetos extraídos (por exemplo, "15 de 42 objetos extraídos") e o esquema atual e o objeto em processamento.
- Conversão mostra o número de blocos convertidos (por exemplo, "3 de 8 blocos convertidos") e o bloco atualmente em processamento.
Após a exportação concluída, selecione Ver Relatório de Migração para abrir o relatório de migração gerado.
Rever tarefas de migração
O cartão de Revisão de Esquemas (Passo 2) mostra itens que requerem atenção manual após a conversão. Um seletor Tarefas agrupadas / no topo da área de revisão permite-lhe escolher como percorrer a lista.
Visão agrupada
A vista agrupada organiza as tarefas de revisão em grupos de acordeões dobráveis por categoria. Use esta perspetiva quando quiser processar questões relacionadas em conjunto.
No cartão de Revisão de Esquemas , selecione Rever para expandir a superfície de revisão e depois selecione Agrupado.
Utilize os separadores Pendente e Resolvido para alternar entre tarefas que ainda precisam de atenção e tarefas que já aprovou.
Expanda um grupo para ver os seus metadados (esquemas, tipos de objetos, criticidade) e os cartões de tarefas individuais dentro dele.
Use as ações ao nível do grupo para processar tarefas em massa:
Ação Description Executar tudo Abra todas as tarefas pendentes do grupo no Modo Agente Copilot para revisão assistida por IA. Resolver tudo Marque todas as tarefas do grupo como resolvidas. Um diálogo de confirmação mostra o nome do grupo e o número de tarefas antes de avançar. Reiniciar tudo Coloque todas as tarefas resolvidas no grupo no estado pendente. Disponível no separador Resolvido . Ver em Tasks Mudar para a vista simples de Tarefas filtrada por este grupo. Para agir numa única tarefa dentro do grupo, selecione Executar Tarefa para a abrir no Modo Agente Copilot, ou selecione Resolver para a marcar como concluída. Selecione Reiniciar numa tarefa resolvida para a devolver ao estado pendente.
Observação
Resolver tudo e Reiniciar todos são desativados quando um grupo contém mais de 800 tarefas.
Vista de tarefas
A vista de Tarefas mostra todas as tarefas de revisão numa tabela plana. Use esta vista quando quiser ordenar, filtrar ou pesquisar em todas as tarefas, independentemente do grupo.
- Selecione Tarefas no seletor.
- Use os menus suspensos do filtro (Estado, Criticidade, Tipo de Objeto, Esquema) para restringir a lista de tarefas.
- Selecione Executar Tarefa num item pendente para o abrir no Modo Agente Copilot para revisão e correção assistida por IA.
- Depois de corrigir um item, selecione Resolver para o marcar como concluído.
Gorjeta
Selecione Ver Registos no painel para inspecionar os ficheiros de extração e conversão para resolução de problemas.
Migrar código da aplicação
Após a migração do esquema, converta código de aplicação específico da Oracle (scripts SQL, procedimentos armazenados, ficheiros de controlo de carregadores, scripts shell ou ficheiros Java) para equivalentes compatíveis com PostgreSQL. A migração de aplicações é uma funcionalidade de Pré-visualização.
Escolha um método de migração
A extensão oferece dois caminhos para migração de código de aplicação:
- Modernização completa da aplicação — Se a extensão de modernização da aplicação GitHub aplicação Copilot estiver instalada, selecione Migrar usando a modernização da aplicação para continuar a migração com notas de codificação a partir da conversão de esquema. Selecione Ver notas de codificação para rever as orientações geradas antes de prosseguir.
- Opção apenas para base de dados — Para converter apenas código de aplicação relacionado com base de dados dentro desta extensão, selecione Migrar usando a extensão PostgreSQL.
Converter o código da aplicação dentro da extensão
- No cartão de Migração de Aplicações , selecione Migrar Dados (ou Selecionar Método se for detetada a extensão de modernização da aplicação).
- Na página Converter Aplicação , selecione Selecionar Aplicação Oracle para Converter e escolha a pasta que contém o código da aplicação Oracle.
- Selecione uma Ligação PostgreSQL e uma Base de Dados PostgreSQL para contexto de conversão.
- Selecione Carregar Bases de Dados se a lista da base de dados estiver vazia.
- Selecione Converter Aplicação para iniciar a conversão.
Use as ferramentas Copilot para migração de aplicações
A extensão regista duas ferramentas de modelos de linguagem Copilot para assistência à migração:
Oracle Client Code Application Converter (
pgsql_migration_oracle_app) — Converte o código da aplicação cliente Oracle para equivalentes em PostgreSQL, usando modelos de prompt e orientações de programação com base na análise da migração de esquemas. Aceita os seguintes parâmetros:- Pasta de Base de Código da Aplicação (obrigatória) — Localização do código a converter.
- Caminho de Localização das Notas de Codificação (opcional) — Caminho para as notas de codificação a partir da migração do esquema.
- Nome da base de dados Postgres (opcional) — Nome da base de dados PostgreSQL para contexto de conversão.
- Postgres DB Connection (opcional) — Nome da ligação para a base de dados PostgreSQL.
Mostrar Relatório de Migração Oracle para Postgres (
pgsql_migration_show_report) — Mostra o relatório de migração gerado pela conversão de esquema. Requer um parâmetro Path to Report File .
Para mais informações sobre o uso das ferramentas do Copilot, consulte integração com o Copilot.
Comparar ficheiros convertidos
Após a conversão, reveja as alterações lado a lado usando os comandos de diferença incorporados.
- No Explorer, clique com o botão direito num ficheiro SQL convertido na
oraclepasta oupostgresno projeto de migração e selecione Comparar Pares de Ficheiros de Migração DDL. - Para ficheiros de código de aplicação convertidos (
.sql,.ctl,.sh,.loadou.java), clique com o botão direito do rato no ficheiro e selecione Comparar pares de ficheiros de migração da aplicação.
A vista de diferenças lado a lado mostra o código-fonte original do Oracle juntamente com o resultado convertido para PostgreSQL, para que possa identificar quaisquer artefactos que exijam ajuste manual.
Observação
Os ficheiros DDL devem seguir a estrutura folder/oracle|postgres/SCHEMA_NAME/DDL-TYPE/filename.sql do comando compare para localizar o par de ficheiros correspondente.
Gerir projetos de migração
Use a vista de Migrações (Pré-visualização) na barra lateral para gerir os seus projetos:
| Ação | Description |
|---|---|
| Open Migration Project | Abra um projeto de migração existente no painel de controlo. |
| Mostrar no Explorador | Mostra a pasta do projeto na vista do Explorador. |
| Delete | Remover um projeto de migração. É-lhe pedido que confirme antes da eliminação. |
| Atualizar | Recarregue a lista de projetos de migração no espaço de trabalho atual. |