Tutorial: conversão de esquemas do Oracle para o Base de Dados do Azure para PostgreSQL flexible server

Este tutorial orienta-o na conversão de esquemas de bases de dados Oracle para Base de Dados do Azure para PostgreSQL, utilizando a extensão Visual Studio Code PostgreSQL com o Microsoft Foundry para gerar e rever definições PostgreSQL.

Abrange a ligação à sua origem Oracle e ao destino Base de Dados do Azure para PostgreSQL, a configuração do Microsoft Foundry, a execução do assistente de migração e a revisão dos artefactos PostgreSQL gerados. Antes de começar, certifique-se de que tem acesso à rede e credenciais tanto para servidores como para uma implementação do Microsoft Foundry.

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

• Descoberta de esquemas: A ferramenta analisa os seus objetos de esquema Oracle.
• AI processing: O Microsoft Foundry processa e converte objetos compatíveis.
• Verificações com base de dados temporária: A ferramenta tenta compilação e verificações estáticas disponíveis. A validação funcional, de dados e de aplicação mantém-se separada.
• Revisão de objetos: Utilize o Conversion Object Explorer para inspecionar resultados e refinar as definições Geradas do PostgreSQL.
• Geração de saída: Os objetos convertidos com sucesso são guardados como ficheiros PostgreSQL.

Pré-requisitos

Esta secção descreve os pré-requisitos para usar a funcionalidade de conversão de esquema Oracle to Azure Database para PostgreSQL no Visual Studio Code antes de iniciar uma conversão.

Requisitos do sistema

Suporte de sistema operativo

Requisitos do Base de Dados do Azure para PostgreSQL de destino

Requisitos do modelo de IA

Precisa de configurar um dos seguintes componentes de IA:

Configuração de implementação do Microsoft Foundry

No Microsoft Foundry, crie uma implementação que utilize o modelo gpt-5.2. O nome da implementação é aquele que escolheu quando criou a implantação; Não tem de corresponder ao nome do modelo.

O endpoint é o URL do seu recurso do Microsoft Foundry. Os recursos do Microsoft Foundry expõem vários nomes de host equivalentes; qualquer um dos seguintes formatos é válido:

• https://{your-resource}.services.ai.azure.com
• https://{your-resource}.openai.azure.com
• https://{your-resource}.cognitiveservices.azure.com

Substitua {your-resource} pelo nome do seu recurso Microsoft Foundry (por exemplo, oracletopg). Se precisar de chamar diretamente uma rota de inferência, o caminho de pré-visualização atual é /openai/responses?api-version=2025-04-01-preview.

Para mais informações sobre formatos de endpoints e rotas de inferência, veja Endpoints for Microsoft Foundry Models.

Privilégios obrigatórios para a base de dados

Antes de executar a conversão de esquema, verifique o acesso aos metadados de origem e as permissões da base de dados temporária junto dos administradores da base de dados. A conta Oracle precisa de acesso a metadados de esquemas e vistas de dicionário, não a dados de linhas de aplicação. A conta PostgreSQL deve ser capaz de dropar e recriar esquemas correspondentes e criar objetos para validação. Use uma conta dedicada sempre que possível e siga o princípio do menor privilégio.

Privilégios Originais da Oracle

São exigidos os seguintes privilégios mínimos na base de dados Oracle de origem:

Privilégios de base de dados temporária

Configure o acesso seguinte na base de dados temporária selecionada. O nível CREATE de base de dados não concede permissão para eliminar um esquema pertencente a outra função.

Requisitos de rede

• Conectividade de saída: Pontos finais do Microsoft Foundry.
• Conectividade da base de dados: Tanto a base de dados Oracle de origem como o servidor flexível do Base de Dados do Azure para PostgreSQL.
• Acesso HTTPS: Visual Studio Code Extensions Marketplace e serviços GitHub Copilot.
• Acesso ao repositório do GitHub: https://github.com/microsoft/pgsql-tools/.

Oracle Instant Client (para modo cliente pesado)

A ferramenta de conversão de esquema liga-se à Oracle usando o modo thin client por defeito, que não requer software adicional. Se o seu ambiente exigir um modo cliente denso, instale o Oracle Instant Client na máquina que executa o Visual Studio Code. A ferramenta lê a sua configuração sqlnet.ora e tnsnames.ora e alterna automaticamente para o modo espesso quando uma definição o exige.

Pode determinar se é necessário um modo cliente robusto verificando os ficheiros de configuração de rede Oracle no seu ambiente de origem. Procure os seguintes parâmetros no sqlnet.ora ficheiro (normalmente localizados em $ORACLE_HOME/network/admin/):

Autenticação Microsoft Foundry

Configure um dos seguintes métodos de autenticação para o Microsoft Foundry:

Processo de migração

Esta secção explica o processo de conversão. Instalas a extensão, inicializas um projeto, ligas-te ao Oracle, analisas o Discovery e configuras a base de dados do zero e o Microsoft Foundry. A conversão tenta a compilação e as verificações estáticas disponíveis na base de dados scratch. Depois revês e refinas a saída, implementas-na numa base de dados separada não em produção e valida-a de forma independente antes da utilização em produção.

Passo 1: Instalar a extensão PostgreSQL Visual Studio Code

1. Abre Visual Studio Code.

2. Aceda à vista Extensões (Ctrl+Shift+X).

3. Procure por PostgreSQL e instale a extensão PostgreSQL publicada por Microsoft.

   1. Transferência no Marketplace

   

Passo 2: Criar uma ligação ao Base de Dados do Azure para PostgreSQL

1. No painel da extensão PostgreSQL, crie uma ligação à sua instância do servidor flexível do Base de Dados do Azure para PostgreSQL.

2. Introduza os detalhes da ligação (anfitrião, base de dados, nome de utilizador, palavra-passe).

3. Teste e guarde a ligação.

   

Passo 3: Abra um novo espaço de trabalho

1. Crie uma nova pasta na sua máquina local para o projeto de migração.

2. Abra a pasta como um novo espaço de trabalho no Visual Studio Code.

   

Passo 4: Inicializar um projeto de migração

1. Abre a extensão PostgreSQL.

2. Vai ao painel de Migrações.

3. Selecione Criar Projeto de Migração.

   

Passo 5: Configurar as definições do projeto

1. No Assistente de Migração, introduza o nome do seu projeto.

2. Selecione Seguinte para continuar.

   

Passo 6: Configurar a ligação Oracle

1. Introduza os detalhes da sua ligação à Oracle:

   • Nome do host ou servidor.
   • Número da porta.
   • Nome da base de dados ou serviço.
   • Nome de utilizador e palavra-passe.

   A ferramenta seleciona automaticamente o modo de cliente fino ou de cliente pesado com base nas suas definições de sqlnet.ora e tnsnames.ora; a interface não disponibiliza um seletor manual. O modo estreito é utilizado por predefinição. Se o seu sqlnet.ora exigir o modo thick, certifique-se de que o Oracle Instant Client está instalado e de que a respetiva localização está definida na variável de ambiente PATH antes de continuar. Para mais informações, consulte Oracle Instant Client.

2. Selecione Load Schemas. A ferramenta testa a ligação Oracle e, se bem-sucedida, lista todos os esquemas definidos pelo utilizador disponíveis no Oracle.

3. Selecione um ou mais esquemas para converter para PostgreSQL.

4. Selecione Próximo: Discovery.

   

Passo 7: Reveja os resultados da Discovery

Descoberta mostra o inventário de origem e o âmbito de extração previsto. Não é extraído nenhum DDL nesta fase. Para uma explicação das contagens resumidas e do âmbito, veja Discovery na visão geral da conversão de esquemas.

1. Aguarde que o Discovery termine.

2. Em Permissões da origem, reveja cada verificação, a respetiva finalidade e o respetivo resultado. Analise as verificações que falharam com o administrador da sua base de dados Oracle. Após resolver os problemas de permissões, selecione Atualizar deteção e reveja os resultados atualizados. Para as permissões necessárias, veja privilégios do Oráculo de Origem.

3. Revise as contagens de resumo de objetos descobertos, por extrair, excluídos e inválidos.

4. Expanda os tipos de objetos suportados para rever as contagens de A extrair, Excluído e Objetos inválidos por tipo. Um tipo suportado pode ainda ter objetos excluídos; estas contagens não são resultados de conversão.

5. Expandir Tipos de objetos não suportados para rever as categorias não suportadas encontradas na origem. Para detalhes de suporte e alternativas ao PostgreSQL, veja Limitações de conversão de esquemas.

6. Em Esquemas dependentes, reveja esquemas referenciados que não selecionou. Selecione Mostrar diagrama para visualizar as referências. Os números nas ligações representam referências de dependência, não contagens de objetos a extrair ou converter.

7. Revise o aviso separado sobre esquemas de sistema Oracle referenciados que não foram migrados. Não encare estas referências como esquemas de aplicação adicionais selecionados para conversão.

8. Se precisares de alterar a seleção do esquema, seleciona Anterior para voltar a Ligar à Oracle, atualiza Esquemas e seleciona novamente Próximo: Descoberta . Revise o âmbito atualizado antes de continuar.

9. Selecione revisei os objetos, exclusões e esquemas dependentes.

10. Selecionar Próximo: Conexão PostgreSQL.

    

Passo 8: Configure uma base de dados temporária do Base de Dados do Azure para PostgreSQL

Usa uma base de dados vazia ou dedicada e não utilizada, sem objetos ou dados que precises de preservar. Para orientações de preparação, consulte Prepare the scratch database.

1. Selecione a ligação Base de Dados do Azure para PostgreSQL que definiu na extensão PostgreSQL.

2. Selecione a base de dados alvo na lista suspensa.

3. Selecione Verificar Extensões. Se aparecer o aviso As extensões recomendadas não estão instaladas, verifique as extensões em falta. Siga as orientações de preparação para bases de dados de origem para adicionar as extensões necessárias à lista de permissões do servidor e instalá-las na base de dados selecionada, depois selecione novamente Verificar Extensões . Podes continuar com o aviso, mas objetos que dependem de extensões em falta podem exigir alterações manuais.

   

4. Selecione a caixa de seleção a reconhecer que os esquemas scratch que correspondem aos esquemas selecionados da Oracle são eliminados e recriados durante a conversão, eliminando os seus objetos e dados existentes.

5. Selecionar Próximo: Configuração do Modelo Microsoft Foundry.

Passo 9: Configurar o modelo de linguagem do Microsoft Foundry

No Microsoft Foundry, atribua uma quota de implementação superior a 1.000.000 de tokens por minuto (TPM). O seguinte exemplo de implementação está configurado para 2,3 milhões de TPM; a quota disponível mostrada é específica para esse ambiente.

Volte ao assistente de migração no Visual Studio Code para configurar a ligação ao modelo:

1. Insira os seus dados do Microsoft Foundry:
   • URL do endpoint.
   • Nome da implementação (o nome que atribuiu à implementação no Microsoft Foundry; o modelo subjacente deve ser gpt-5.2).
2. Selecione o método de autenticação:
   • Chave de API: Introduza a chave de API para a sua implementação do Microsoft Foundry.
   • Microsoft Entra ID: Iniciar sessão com a extensão da conta Azure. A ferramenta adquire automaticamente o token de autenticação. Certifique-se de que a identidade com sessão iniciada tem a função Foundry User (anteriormente Azure AI User) no recurso do Microsoft Foundry. Para mais informações, consulte Controlo de acesso baseado em funções para Microsoft Foundry.
3. Selecione Testar Ligação Microsoft Foundry para verificar a configuração.
4. Depois de a ligação ser estabelecida, selecione Criar Projeto de Migração.

Passo 10: Execute a conversão do esquema

1. O sistema navega até ao Assistente de Migração principal.

2. Selecione Migrar para iniciar o processo de conversão de esquema.

3. Monitorize o progresso da conversão na interface do Visual Studio Code.

4. Quando a conversão termina, o projeto mostra que a conversão de esquema está concluída e a ação Rever resumo da conversão.

   

Passo 11: Rever o relatório de conversão de esquemas

1. Após a conclusão da conversão do esquema, o relatório de conversão HTML abre automaticamente.
2. Revise os resultados de descoberta, extração e conversão e as notas ao nível do objeto.
3. Para orientações sobre a interpretação do relatório, consulte Visualizar o relatório HTML para conversão de esquemas da Oracle.

Passo 12: Reveja e refine os objetos convertidos

1. A partir do projeto de migração concluído, selecione Rever resumo de conversão.

   

2. Na página Resumo da conversão, selecione Explorador de objetos de conversão.

   

3. Selecione um objeto para comparar as suas definições Oracle e PostgreSQL e leia as suas notas de conversão.

   

4. Use o Ask para explicar a conversão e as suas dependências, ou o Fix para abrir um pedido ao Copilot e fazer alterações ao ficheiro PostgreSQL.

5. Revise as edições e confirme se o SQL de implementação inclui as correções que pretende implementar. Não presuma que editar um ficheiro por objeto atualiza o arquivo gerado deploy.sql.

Para passos de filtragem, comparação e compilação manual, consulte Revisar objetos convertidos no Conversion Object Explorer.

Passo 13: Preparar a implementação com o Setup Experience

O fluxo de trabalho de conversão gera automaticamente ficheiros de configuração quando termina. Abrir as instruções de configuração não inicia uma implementação.

1. No projeto de migração concluído, selecione Rever resumo de conversão.
2. Na página de resumo de Conversão, selecione Instruções de configuração. Esta ação fica disponível quando os ficheiros de configuração estão prontos.
3. Revise o ficheiro gerado setup_instructions.md , que abre no editor. O Visual Studio Code também revela a pasta de configuração no Explorador.
4. Siga os esquemas convertidos Deploy com a Experiência de Configuração para preparar uma base de dados de destino não produtiva separada, executar verificações de prontidão, implementar os esquemas convertidos e rever os resultados da implementação.

Passo 14: Validar o esquema implementado antes da utilização em produção

Use a base de dados não de produção implementada no passo anterior para validação funcional, de dados e de aplicação, e não a base de dados scratch de conversão.

Se alterar um objeto após a implementação, aplique a correção manualmente:

1. Ligue o editor SQL ao servidor PostgreSQL não produtivo e à base de dados onde o esquema convertido foi implementado. Confirma a base de dados ativa do editor.
2. Revise as referências de esquemas e selecione a instrução ou instruções completas que pretende executar.
3. Selecione o botão de reprodução para executar apenas as instruções selecionadas. Revise a saída de execução e resolva erros antes de continuar.
4. Confirme que os ficheiros objeto e o SQL de implementação contêm as correções testadas antes da implementação em produção. Atualizar um ficheiro, atualizar um objeto implantado e atualizar deploy.sql são ações separadas.

Validar de forma independente o esquema implementado com dados de teste representativos e cargas de trabalho da aplicação. Verifique dependências, restrições, lógica de negócio e conjuntos de resultados com a fonte da Oracle, e volte a testar após correções. Revise quaisquer objetos que não tenham sido convertidos ou implementados, em vez de testar apenas conversões bem-sucedidas.

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

Conteúdo relacionado

• O que é a conversão de esquemas de Oracle para o Base de Dados do Azure para PostgreSQL - Flexible Server?
• Revise os objetos convertidos no Conversion Object Explorer
• Disponibilizar esquemas convertidos com a Experiência de Configuração
• Limitações da conversão de esquema do servidor flexível Oracle para Base de Dados do Azure para PostgreSQL