Tutorial: O que é a conversão de esquema do Oracle para o servidor flexível do Banco de Dados do Azure para PostgreSQL

Este tutorial orienta você pela conversão de esquemas de banco de dados Oracle em Banco de Dados do Azure para PostgreSQL usando a extensão Visual Studio Code PostgreSQL com Microsoft Foundry para gerar e examinar definições do PostgreSQL.

Aborda a conexão com a origem Oracle e o destino Banco 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 artefatos PostgreSQL gerados. Antes de começar, verifique se você tem acesso à rede e credenciais para servidores e uma implantação do Microsoft Foundry.

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

• Descoberta de esquema: a ferramenta analisa seus objetos de esquema Oracle.
• Processamento de IA: O Microsoft Foundry processa e converte objetos compatíveis.
• Verificações de banco de dados temporário: a ferramenta tenta compilar e executar as verificações estáticas disponíveis. A validação funcional, de dados e de aplicação permanece separada.
• Revisão de objeto: use o Conversion Pesquisador de Objetos para inspecionar os resultados e refinar definições geradas do PostgreSQL.
• Geração de saída: objetos convertidos com êxito são salvos como arquivos PostgreSQL.

Pré-requisitos

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

Requisitos do sistema

Suporte ao sistema operacional

Requisitos do Banco de Dados do Azure para PostgreSQL de destino

Requisitos do modelo de IA

Você precisa de um dos seguintes componentes de IA configurados:

configuração de implantação do Microsoft Foundry

No Microsoft Foundry, crie uma implantação que use o modelo gpt-5.2. O nome da implantação é o escolhido quando você criou a implantação; ele não precisa corresponder ao nome do modelo.

O ponto de extremidade é a URL de recurso do Microsoft Foundry. Os recursos do Microsoft Foundry expõem vários nomes de host equivalentes; qualquer um dos formatos a seguir é 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 recurso Microsoft Foundry (por exemplo, oracletopg). Se você precisar chamar uma rota de inferência diretamente, o caminho de prévia atual é /openai/responses?api-version=2025-04-01-preview.

Para obter mais informações sobre formatos de ponto de extremidade e rotas de inferência, consulte Endpoints for Microsoft Foundry Models.

Privilégios de banco de dados necessários

Antes de executar a conversão de esquema, verifique o acesso aos metadados de origem e as permissões do banco de dados temporário com seus administradores de banco de dados. A conta Oracle precisa de acesso a metadados de esquema e exibições de dicionário, não dados de linha de aplicativo. A conta postgreSQL deve ser capaz de remover e recriar esquemas correspondentes e criar objetos para validação. Use uma conta dedicada sempre que possível e siga o princípio do privilégio mínimo.

Privilégios de Origem Oracle

Os seguintes privilégios mínimos são necessários no banco de dados Oracle de origem:

Privilégios de banco de dados temporário

Organize o seguinte acesso no banco de dados temporário selecionado. O nível CREATE do banco de dados não concede permissão para remover um esquema de propriedade de outro papel.

Requisitos de rede

• Conectividade de saída: pontos de extremidade do Microsoft Foundry.
• Conectividade do banco de dados: o Oracle de origem e o servidor flexível do Banco de Dados do Azure para PostgreSQL de destino.
• Acesso HTTPS: Visual Studio Code Extensions Marketplace e serviços do GitHub Copilot.
• Acesso ao repositório do GitHub: https://github.com/microsoft/pgsql-tools/.

Cliente Instantâneo Oracle (para modo de cliente pesado)

A ferramenta de conversão de esquema se conecta ao Oracle usando o modo de cliente fino por padrão, o que não requer software extra. Se o ambiente exigir um modo de cliente espesso, instale o Oracle Instant Client no computador que executa Visual Studio Code. A ferramenta lê a configuração de sqlnet.ora e tnsnames.ora e alterna automaticamente para o modo grosso quando uma configuração exige.

Você pode determinar se o modo de cliente espesso é necessário verificando os arquivos de configuração de rede Oracle em seu ambiente de origem. Procure os seguintes parâmetros no sqlnet.ora arquivo (normalmente localizado em $ORACLE_HOME/network/admin/):

autenticação do Microsoft Foundry

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

Processo de migração

Esta seção percorre o fluxo de trabalho de conversão. Instale a extensão, inicialize um projeto, conecte-se ao Oracle, examine a Descoberta e configure o banco de dados zero e o Microsoft Foundry. Tentativas de conversão de compilação e verificações estáticas disponíveis no banco de dados zero. Em seguida, revise e refine a saída, implante-a em um banco de dados de não produção separado e valide-a independentemente antes do uso da produção.

Etapa 1: Instalar a extensão do Visual Studio Code do PostgreSQL

1. Abra o Visual Studio Code.

2. Vá para a exibição Extensões (Ctrl+Shift+X).

3. Pesquise PostgreSQL e instale a extensão PostgreSQL publicada pelo Microsoft.

   1. Download do Marketplace

   

Etapa 2: Criar uma conexão para o Banco de Dados do Azure para PostgreSQL

1. No painel de extensões do PostgreSQL, crie uma conexão com sua instância do Banco de Dados do Azure para PostgreSQL – Servidor Flexível.

2. Insira os detalhes da conexão (host, banco de dados, nome de usuário, senha).

3. Teste e salve a conexão.

   

Etapa 3: Abrir um novo workspace

1. Crie uma nova pasta no computador local para o projeto de migração.

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

   

Etapa 4: Inicializar um projeto de migração

1. Abra a extensão PostgreSQL.

2. Vá para o painel Migrações .

3. Selecione Create Migration Project.

   

Etapa 5: Definir as configurações do projeto

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

2. Selecione Avançar para continuar.

   

Etapa 6: Configurar a conexão oracle

1. Digite os detalhes da sua conexão com o Oracle:

   • Nome do host ou do servidor.
   • Número da porta.
   • Nome do banco de dados ou do serviço.
   • Nome de usuário e senha.

   A ferramenta seleciona automaticamente o modo cliente leve ou cliente pesado com base nas suas configurações sqlnet.ora e tnsnames.ora; a interface não oferece um seletor manual. O modo fino é usado por padrão. Se o seu sqlnet.ora exigir o modo thick, verifique se o Oracle Instant Client está instalado e se o local de instalação dele está na variável de ambiente PATH antes de continuar. Para obter mais informações, consulte Oracle Instant Client.

2. Selecione Esquemas de Carga. A ferramenta testa a conexão Oracle e, se bem-sucedida, lista todos os esquemas definidos pelo usuário disponíveis no Oracle.

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

4. Selecione Avançar: Descoberta.

   

Etapa 7: Examinar os resultados da descoberta

A descoberta mostra o inventário de origem e o escopo de extração planejado. Nenhuma DDL é extraída neste estágio. Para obter uma explicação das contagens de resumo e do escopo, consulte Discovery na visão geral da conversão de esquema.

1. Aguarde a conclusão do Discovery.

2. Em permissões de origem, examine cada verificação, sua finalidade e seu resultado. Examine as verificações malsucedidas com o administrador do banco de dados Oracle. Depois de resolver problemas de permissão, selecione Atualizar Descoberta e examine os resultados atualizados. Para obter as permissões necessárias, consulte privilégios oracle de origem.

3. Examine as contagens de resumo de objetos Descobertos, A serem extraídos, Excluídos e Inválidos .

4. Expanda os tipos de objeto com suporte para examinar as contagens de objetos Para serem extraídos, Excluídos e Inválidos por tipo. Um tipo com suporte ainda pode ter objetos excluídos; essas contagens não são resultados de conversão.

5. Expanda tipos de objeto sem suporte para examinar categorias sem suporte encontradas na origem. Para obter detalhes de suporte e alternativas do PostgreSQL, consulte limitações de conversão de esquema.

6. Em esquemas dependentes, examine os esquemas referenciados que você não selecionou. Selecione Mostrar diagrama para exibir as referências. Os números nas conexões representam referências de dependência, não contagens de objetos para extrair ou converter.

7. Examine o aviso separado sobre esquemas do sistema Oracle referenciados que não são migrados. Não trate essas referências como esquemas de aplicativo adicionais selecionados para conversão.

8. Se você precisar alterar a seleção de esquema, selecione Voltar para retornar ao Connect to Oracle, atualize Esquemas e selecione Avançar: Descobrir novamente. Examine o escopo atualizado antes de continuar.

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

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

    

Etapa 8: Configurar um banco de dados temporário do Banco de Dados do Azure para PostgreSQL

Use um banco de dados temporário vazio ou dedicado e não utilizado, sem objetos ou dados que você precisa preservar. Para obter diretrizes de preparação, consulte Preparar o banco de dados temporário.

1. Selecione a conexão Banco de Dados do Azure para PostgreSQL definida na extensão PostgreSQL.

2. Selecione o banco de dados de destino na lista suspensa.

3. Selecione Verificar Extensões. Se o aviso de extensões recomendadas não estiverem instaladas aparecer, examine as extensões ausentes. Siga as diretrizes de preparação do banco de dados temporário para adicionar as extensões necessárias à lista de permissões do servidor e instalá-las no banco de dados selecionado e selecione Verificar Extensões novamente. Você pode continuar apesar do aviso, mas objetos que dependem de extensões ausentes podem exigir alterações manuais.

   

4. Marque a caixa de seleção reconhecendo que scratch schemas correspondentes aos esquemas Oracle selecionados são descartados e recriados durante a conversão, excluindo seus objetos e dados existentes.

5. Selecione Avançar: Configuração do modelo do Microsoft Foundry.

Etapa 9: Configurar o modelo de linguagem Microsoft Foundry

No Microsoft Foundry, aloque uma cota de implantação maior que 1.000.000 tokens por minuto (TPM). O exemplo de implantação a seguir está configurado para 2,3 milhões de TPM; a cota disponível mostrada é específica para esse ambiente.

Retorne ao assistente de migração em Visual Studio Code para configurar a conexão de modelo:

1. Insira os detalhes do Microsoft Foundry:
   • URL do ponto de extremidade.
   • Nome da implantação (o nome atribuído à implantação no Microsoft Foundry; o modelo subjacente deve ser gpt-5.2).
2. Selecione o método de autenticação:
   • API key: insira a chave de API para a implantação do Microsoft Foundry.
   • Microsoft Entra ID: faça login usando a extensão da conta do Azure. A ferramenta adquire o token de autenticação automaticamente. Verifique se a identidade conectada tem a função Foundry User (anteriormente Azure AI User) no recurso do Microsoft Foundry. Para obter mais informações, consulte o controle de acesso baseado em funções do Microsoft Foundry.
3. Selecione Test Microsoft Foundry Connection para verificar a configuração.
4. Depois que a conexão for bem-sucedida, selecione Criate Migration Project.

Etapa 10: Execute a conversão de schema

1. O sistema vai para o Assistente principal de migração.

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

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

4. Quando a conversão for concluída, o projeto mostrará que a conversão de esquema está concluída e a ação Revisar resumo da conversão.

   

Etapa 11: Examinar o relatório de conversão de esquema

1. Após a conclusão da conversão de schema, o relatório de conversão HTML será aberto automaticamente.
2. Examine os resultados de descoberta, extração e conversão e as notas no nível do objeto.
3. Para obter diretrizes sobre como interpretar o relatório, consulte Exibir o relatório HTML para conversão de esquema Oracle.

Etapa 12: Examinar e refinar objetos convertidos

1. No projeto de migração concluído, selecione a opção Revisar resumo da conversão.

   

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

   

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

   

4. Use Ask para explicar a conversão e suas dependências ou corrigir para abrir um prompt do Copilot e fazer alterações no arquivo PostgreSQL.

5. Examine as edições e confirme se o SQL de implantação inclui as correções que você pretende implantar. Não suponha que a edição de um arquivo por objeto atualize o arquivo gerado deploy.sql.

Para filtragem, comparação e etapas de compilação manual, consulte Revisar objetos convertidos em Conversion Pesquisador de Objetos.

Etapa 13: Preparar a implantação com a Experiência de Instalação

O fluxo de trabalho de conversão gera automaticamente arquivos de instalação quando ele é concluído. Abrir as instruções de configuração não inicia uma implantação.

1. No projeto de migração concluído, selecione Revisar resumo da conversão.
2. Na página resumo de conversão, selecione Instruções de configuração. Essa ação fica disponível quando os arquivos de instalação estão prontos.
3. Examine o arquivo gerado setup_instructions.md, que se abre no editor. Visual Studio Code também revela a pasta de instalação no Explorer.
4. Siga Implantar esquemas convertidos com o Setup Experience para preparar um banco de dados de destino de não produção separado, executar verificações de preparação, implantar os esquemas convertidos e examinar os resultados da implantação.

Etapa 14: Validar o esquema publicado antes do uso em produção

Use o banco de dados de não produção implantado na etapa anterior para validação funcional, de dados e de aplicativo, e não o banco de dados temporário de conversão.

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

1. Conecte o editor do SQL ao servidor PostgreSQL de não produção e ao banco de dados em que o esquema convertido é implantado. Confirme o banco de dados ativo do editor.
2. Examine as referências de esquema e selecione a instrução ou as instruções completas que você pretende executar.
3. Selecione o botão Play para executar somente as instruções selecionadas. Examine a saída de execução e resolva os erros antes de continuar.
4. Confirme se os arquivos de objeto e o SQL de implantação contêm as correções testadas antes da implantação de produção. Atualizar um arquivo, atualizar um objeto implantado e atualizar deploy.sql são ações separadas.

Valide independentemente o esquema implantado com cargas de trabalho de aplicativo e dados de teste representativos. Verifique dependências, restrições, lógica de negócios e conjuntos de resultados em relação à fonte Oracle e teste novamente após as correções. Revise todos os objetos que não foram convertidos ou implantados, em vez de testar apenas conversões bem-sucedidas.

Para obter 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 esquema do Oracle para o servidor flexível do Banco de Dados do Azure para PostgreSQL?
• Revisar objetos convertidos no Conversion Pesquisador de Objetos
• Implantar esquemas convertidos com o Setup Experience
• Limitações da conversão de esquema do Oracle para o Banco de Dados do Azure para PostgreSQL – servidor flexível