O que é a conversão de esquema do Oracle para o Azure PostgreSQL?

O recurso de conversão de esquema Oracle to Azure PostgreSQL na extensão PostgreSQL do Visual Studio Code ajuda você a converter os objetos de esquema do seu banco de dados Oracle em definições compatíveis com o Azure PostgreSQL. Você pode usar Banco de Dados do Azure para PostgreSQL servidor flexível ou Azure HorizonDB para validação de esquema e implantação do esquema convertido.

A ferramenta lê metadados do Oracle, gera a linguagem de definição de dados (DDL) do Azure PostgreSQL e verifica a sintaxe e a estrutura em um banco de dados de validação de esquema. Ele não migra linhas de tabela nem valida o comportamento do aplicativo equivalente. Examine a saída com relatórios de conversão e Conversion Pesquisador de Objetos e use GitHub Copilot para obter explicações e correções.

Para executar sua primeira conversão, siga o tutorial de conversão de esquema.

O diagrama a seguir mostra a descoberta de esquema oracle, conversão assistida por IA e verificações de compilação, seguidas de revisão e implantação para Banco de Dados do Azure para PostgreSQL servidor flexível ou Azure HorizonDB.

Diagrama da conversão de esquema oracle com Microsoft Foundry, usando Azure HorizonDB ou Banco de Dados do Azure para PostgreSQL para verificações de compilação e um destino de implantação.

Architecture

O fluxo de trabalho usa os seguintes componentes:

Component Role
Fonte Oracle Fornece definições de esquema e metadados.
Extensão Visual Studio Code PostgreSQL Gerencia o projeto de conversão de esquema, o fluxo de trabalho de conversão e os artefatos locais.
Microsoft Foundry Hospeda a implantação de modelo usada para conversão automatizada.
Banco de dados de validação de esquema Fornece compilação e verificações estáticas disponíveis em um dos serviços do Azure com suporte.
GitHub Copilot Ajuda com explicações e correções de objeto por meio de Ask e Fix.
  • Implantação e teste: Escolha seu destino de implantação no servidor flexível do Banco de Dados do Azure para PostgreSQL ou Azure HorizonDB. Você decide onde testar o esquema convertido.
  • Configuração da IA: Configure a implantação e a autenticação do modelo Microsoft Foundry para conversão automatizada. Entre em GitHub Copilot separadamente para usar Ask e Fix.

Para obter informações sobre como esses serviços lidam com definições de esquema e código, consulte as perguntas frequentes sobre manipulação de dados.

Instalar a extensão

A conversão de esquema é integrada à extensão PostgreSQL publicada pelo Microsoft (ms-ossdata.vscode-pgsql). Siga os pré-requisitos do tutorial e as etapas de instalação, incluindo login no Copilot para o fluxo de trabalho de revisão assistida.

Fluxo de trabalho de conversão de esquema

O fluxo de trabalho começa com a descoberta, seguida de extração e conversão. A ferramenta valida as definições geradas do Azure PostgreSQL em um banco de dados de validação de esquema, e você analisa os resultados em Pesquisador de Objetos antes de preparar arquivos de implantação.

Descoberta

A descoberta segue a conexão do Oracle e a seleção de esquemas, antes de configurar o banco de dados de validação de esquemas. Ele verifica as permissões de origem e inventaria objetos de esquema sem extrair DDL. As contagens descrevem o inventário de origem e a extração planejada, não os resultados de conversão.

Result O que isso te diz
Descoberto Objetos encontrados durante a varredura.
A ser extraído Objetos planejados para extração de DDL.
Excluído Objetos omitidos do escopo de extração planejado.
Objetos inválidos Objetos sinalizados como inválidos pela detecção.

Examine o suporte e as exclusões do tipo objeto, juntamente com as dependências de esquema, antes de confirmar o escopo. Os esquemas dependentes listam esquemas referenciados que você não selecionou. Um schema que aparece nesta lista não é a confirmação de que ele está incluído no escopo de conversão.

Para obter etapas detalhadas, consulte Revisar resultados do Discovery no tutorial.

Extração

A extração lê a DDL do Oracle e os metadados para o escopo de origem revisado. As definições extraídas fornecem a entrada para conversão; Extração bem-sucedida não significa que um objeto foi convertido.

Conversion

Os agentes de conversão de esquema usam modelos no Microsoft Foundry para traduzir as definições extraídas do Oracle para DDL do PostgreSQL e tentar a compilação no banco de dados de validação de esquema. Examine os objetos convertidos e não convertidos no Pesquisador de Objetos de Conversão e valide independentemente o comportamento antes da implantação.

Banco de dados de validação de esquema

Selecione um banco de dados vazio ou um banco de dados dedicado e não utilizado em Banco de Dados do Azure para PostgreSQL servidor flexível ou Azure HorizonDB para validação de conversão. Alinhe a versão principal do PostgreSQL do banco de dados de validação de esquema e as extensões necessárias com o destino da implantação. A ferramenta usa esquemas correspondentes aos esquemas Oracle selecionados; ele não usa um prefixo separado para esquemas de validação.

Aviso

A ferramenta descarta esquemas correspondentes DROP SCHEMA ... CASCADE e os recria. Essa ação exclui seus objetos e dados já existentes e pode remover objetos dependentes em outros esquemas. Não selecione um banco de dados que contenha nada que você precise preservar.

O usuário de conexão precisa de permissão para se conectar, criar esquemas e objetos de validação e descartar os esquemas correspondentes. O nível do banco de dados CREATE sozinho não concede permissão para remover um esquema de propriedade de outra função. Consulte os privilégios necessários do PostgreSQL.

A compilação e as verificações estáticas podem identificar a sintaxe, a dependência e os erros de tipo nesse ambiente. Eles não testam dados de produção, comportamento do aplicativo ou todos os caminhos de runtime.

Explorador de Objetos de Conversão

Use Pesquisador de Objetos de Conversão para inspecionar mapeamentos de origem para destino, comparar definições do Oracle e do PostgreSQL, além de ler observações de conversão. Selecione Perguntar para obter uma explicação ou Corrigir para obter correções assistidas pelo Copilot no objeto e em seus objetos dependentes. Após a compilação bem-sucedida, os objetos dependentes corrigidos são resolvidos automaticamente.

Selecione Resolver para alterar o status registrado de um objeto para Convertido e, em seguida, selecione Atualizar para atualizar os relatórios de conversão. Uma alteração de status não substitui a compilação nem o teste de aplicativo independente. Para edições manuais, compile as definições corrigidas no banco de dados selecionado e examine os resultados da execução.

Para obter etapas detalhadas, consulte Examinar objetos convertidos no Pesquisador de Objetos de Conversão.

Modo de agente do GitHub Copilot

Perguntar e Corrigir fornecem contexto de objeto para o GitHub Copilot. Examine as edições e os resultados da compilação propostos antes de aceitar uma correção. A assistência do Copilot não altera quais objetos o conversor dá suporte automaticamente nem recupera código-fonte indisponível. Consulte Lidar com problemas de conversão com o GitHub Copilot.

Deployment

A Experiência de Instalação gera instruções e scripts que usam os arquivos de objeto em postgres_ddl. Examine o escopo e as correções de implantação e execute o setup no destino escolhido. Gerar arquivos não os implanta. Examine os resultados da implantação e teste, de forma independente, os dados e o comportamento do aplicativo.

Modos de conectividade Oracle

O modo leve não requer bibliotecas do Cliente Oracle; o modo completo as usa. A extensão seleciona o modo com base no cliente que ele detecta. Prepare o computador que executa o Visual Studio Code para atender aos requisitos da sua conexão Oracle, incluindo criptografia de rede nativa ou soma de verificação. Consulte a configuração do cliente Oracle no tutorial.

Autenticação para Microsoft Foundry

Use uma chave de API de recurso ou Microsoft Entra ID com permissão para invocar o modelo. Uma chave de API pertence ao recurso Foundry, não a uma implantação individual. O nome da implantação identifica a implantação do modelo nesse recurso. Siga os pré-requisitos de autenticação do Foundry e as etapas de configuração do assistente.

Rede e segurança

Ao usar o recurso de conversão de esquema, verifique se o ambiente Visual Studio Code pode se conectar com segurança ao banco de dados Oracle de origem e ao servidor do Banco de Dados do Azure para PostgreSQL flexível ou cluster do Azure HorizonDB que hospeda o banco de dados de validação de esquema.

A Microsoft recomenda conectar-se ao seu recurso do Microsoft Foundry por meio de um ponto de extremidade privado. Para obter mais informações, consulte Configurar um link privado para Microsoft Foundry.

Para tratamento de dados de modelo, consulte Dados, privacidade e segurança para modelos do Foundry.

Diagrama de como Visual Studio Code se conecta a um ponto de extremidade privado.

Importante

A saída da conversão do Foundry e sugestões do Copilot exigem revisão independente. A compilação e a revisão assistida por IA não estabelecem a lógica de negócios equivalente ou a preparação para produção. Teste o tratamento de dados, as dependências, os controles de segurança e o comportamento do aplicativo antes do uso em produção.

Objetos de esquema com suporte

A ferramenta converte objetos de código e esquema oracle comuns. O suporte para um tipo de objeto não significa que todas as definições de origem sejam convertidas completamente. Verifique as limitações e os resultados de seus próprios objetos de origem.

O status “Converted” registra um resultado; ele não certifica a compilação, a implementação completa ou a inclusão na implantação. Inspecione definições e anotações, incluindo espaços reservados e dependências.

Objetos de esquema de banco de dados

Os tipos de objeto com suporte incluem tabelas, restrições, índices de árvore B e exclusivos, sequências, gatilhos em nível de linha e instrução, exibições, exibições materializadas, esquemas e sinônimos públicos e privados. O comportamento de armazenamento, atualização e sinônimo específico do Oracle pode exigir trabalho manual.

Objetos de código Oracle

Os constructos de código com suporte incluem pacotes, funções, procedimentos, lógica de gatilho, tipos de objeto e corpos de tipo e coleções como VARRAY, tabelas aninhadas e SUBTYPE declarações. Examine as implementações de membro e os chamadores, não apenas o status do objeto pai.

Conversão de pacotes

Os membros do pacote podem ser mapeados para várias definições do PostgreSQL. Examine auxiliares de estado, constantes, coleções, cursores e tratamento de exceções gerados. Os pacotes somente especificação podem produzir espaços reservados. Consulte as diretrizes de validação de objeto complexo e a revisão do pacote no Explorador de Objetos de Conversão.

Consultas hierárquicas

Examine as consultas geradas WITH RECURSIVE comparadas aos resultados do Oracle, incluindo raízes, ordenação, caminhos e ciclos. A compilação por si só não valida esses resultados.

Controle de transação

Rotinas que usam PRAGMA AUTONOMOUS_TRANSACTION podem depender de dblink e de alterações em seus chamadores. Validar conexões, limites de transação e tratamento de erros de forma independente; consulte as diretrizes de validação de objeto complexo.

Validar PL/pgSQL convertido com plpgsql_check

A criação de uma rotina PL/pgSQL não valida todos os caminhos executáveis. Quando há suporte e configuração, plpgsql_check adiciona verificações estáticas de corpos de rotina no banco de dados de validação de esquema. Sem ele, essas verificações adicionais não estão disponíveis. Nem a compilação nem um status convertido provam que eles foram executados ou que o comportamento corresponde ao Oracle. Para informações sobre disponibilidade, pré-carregamento e etapas de instalação, consulte Permitir e instalar as extensões necessárias.

Versões do Oracle com suporte

A conversão de esquema dá suporte às seguintes versões do banco de dados Oracle. Para o ambiente de conversão e os requisitos do PostgreSQL, consulte os pré-requisitos do tutorial.

  • Oracle 21c
  • Oracle 19c
  • Oracle 18c
  • Oracle 12.2
  • Oracle 12.1

Suporte à extensão PostgreSQL

Para relatar um bug ou solicitar um recurso, registre um problema no repositório vscode-pgsql GitHub. Prefixe o título do problema com Schema Conversion:. Para bugs, inclua a versão da extensão, o estágio com falha e as mensagens de erro relevantes com trechos ocultados. Remova credenciais, segredos e detalhes confidenciais do esquema antes do compartilhamento.