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

A funcionalidade de conversão do esquema de Oracle para Azure PostgreSQL na extensão PostgreSQL do Visual Studio Code ajuda-o a converter os objetos existentes do esquema da sua base de dados Oracle em definições compatíveis com o Azure PostgreSQL. Pode utilizar o Base de Dados do Azure para PostgreSQL Servidor Flexível ou o Azure HorizonDB tanto para a validação do esquema como para a implantação do esquema convertido.

A ferramenta lê metadados da Oracle, gera a linguagem de definição de dados (DDL) Azure PostgreSQL e verifica a sintaxe e a estrutura numa base de dados de validação de esquemas. Não migra linhas de tabela nem valida o comportamento equivalente da aplicação. Revise o resultado com relatórios de conversão e o Conversion Object Explorer, depois utilize o GitHub Copilot para explicações e correções.

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

O diagrama seguinte mostra a descoberta de esquemas Oracle, conversão assistida por IA e verificações de compilação, seguidas de revisão e implementação para o servidor flexível Base de Dados do Azure para PostgreSQL ou Azure HorizonDB.

Diagrama da conversão de esquema Oracle com o Microsoft Foundry, utilizando Azure HorizonDB ou Base de Dados do Azure para PostgreSQL para verificações de compilação e um destino de implementação.

Arquitetura

O fluxo de trabalho utiliza os seguintes componentes:

Component Role
Fonte Oracle Fornece definições de esquemas e metadados.
Extensão Visual Studio Code PostgreSQL Faz a gestão do projeto de conversão de esquemas, do fluxo de trabalho de conversão e dos artefactos locais.
Microsoft Foundry Hospeda a implementação do modelo utilizado para conversão automatizada.
Base de dados de validação de esquemas Fornece compilação e verificações estáticas disponíveis em qualquer um dos dois serviços Azure suportados.
GitHub Copilot Ajuda com explicações e correções de objetos através de Ask e Fix.
  • Implementação e testes: Escolha o seu destino de implementação no Base de Dados do Azure para PostgreSQL flexible server ou Azure HorizonDB. Decide onde testar o esquema convertido.
  • Configuração de IA: Configure a implementação de modelo e autenticação do Microsoft Foundry para conversão automática. Inicie sessão no GitHub Copilot separadamente para usar o Ask e Fix.

Para informações sobre como estes serviços lidam com definições de esquemas e código, consulte as FAQ sobre tratamento de dados.

Instalar a extensão

A conversão de esquema está integrada na extensão PostgreSQL publicada pela Microsoft (ms-ossdata.vscode-pgsql). Siga os pré-requisitos do tutorial e os passos de instalação, incluindo o início de sessão no Copilot para o fluxo de trabalho de revisão assistida.

Fluxo de trabalho de conversão de esquemas

O fluxo de trabalho começa com a descoberta, seguida da extração e conversão. A ferramenta valida as definições Azure PostgreSQL geradas numa base de dados de validação de esquemas e analisa os resultados no Object Explorer antes de preparar os ficheiros de implementação.

Descoberta

A descoberta ocorre após a ligação Oracle e a seleção do esquema, antes de configurar a base de dados de validação de esquemas. Verifica permissões de origem e inventaria objetos de esquema sem extrair DDL. As contagens descrevem o inventário de origem e a extração planeada, não os resultados de conversão.

Result O que isto lhe diz
Descoberto Objetos encontrados durante a deteção.
A extrair Objetos previstos para extração de DDL.
Excluído Objetos omitidos do âmbito de extração previsto.
Objetos inválidos Objetos assinalados como inválidos durante a deteção.

Reveja o suporte a tipos de objeto e respetivas exclusões, bem como as dependências do esquema, antes de confirmar o âmbito. Esquemas dependentes listam esquemas referenciados que não selecionou. O facto de um esquema aparecer nesta lista não constitui confirmação de que está incluído no âmbito da conversão.

Para obter instruções detalhadas, consulte Rever os resultados da deteção no tutorial.

Extração

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

Conversion

Os agentes de conversão de esquema utilizam modelos no Microsoft Foundry para traduzir as definições extraídas da Oracle para PostgreSQL DDL e tentar compilar na base de dados de validação de esquemas. Revise tanto os objetos convertidos como os não convertidos no Conversion Object Explorer e valide o comportamento de forma independente antes da implementação.

Base de dados de validação de esquema

Selecione uma base de dados vazia ou uma base de dados dedicada e não utilizada no Base de Dados do Azure para PostgreSQL para servidor flexível ou no Azure HorizonDB para validação de conversões. Alinhe a versão principal PostgreSQL da base de dados de validação de esquemas e as extensões necessárias com o destino de implementação. A ferramenta utiliza esquemas correspondentes aos esquemas Oracle que seleciona; não utiliza um prefixo separado para esquemas de validação.

Warning

A ferramenta elimina esquemas correspondentes com DROP SCHEMA ... CASCADE e recria-os. Esta ação elimina os objetos e dados existentes e pode remover objetos dependentes noutros esquemas. Não selecione uma base de dados que contenha algo que tenha de preservar.

O utilizador da ligação precisa de permissão para se ligar, criar esquemas e objetos de validação, e eliminar os esquemas correspondentes. O CREATE ao nível da base de dados, por si só, não concede permissão para eliminar um esquema pertencente a outro perfil. Veja privilégios obrigatórios do PostgreSQL.

Verificações de compilação e estáticas podem identificar erros de sintaxe, dependência e tipo neste ambiente. Eles não testam dados de produção, o comportamento da aplicação, nem todos os caminhos de execução.

Explorador de Objetos de Conversão

Utilize Conversion Object Explorer para inspecionar mapeamentos de origem para destino, comparar as definições do Oracle e do PostgreSQL e ler notas de conversão. Selecione Pedir uma explicação ou Corrigir para correções assistidas pelo Copilot ao objeto e aos seus objetos dependentes. Após a compilação bem-sucedida, os objetos dependentes corrigidos são resolvidos automaticamente.

Selecione Resolver para alterar o estado registado de um objeto para Convertido e, em seguida, selecione Atualizar para atualizar os relatórios de conversão. Uma alteração de estado não substitui a compilação nem o teste independente de aplicações. Para edições manuais, compile as definições corrigidas na base de dados selecionada e reveja os resultados da execução.

Para obter instruções detalhadas, consulte Reveja os objetos convertidos no Conversion Object Explorer.

Modo de agente do GitHub Copilot

Ask e Fix fornecem contexto de objeto ao GitHub Copilot. Revise as edições propostas e os resultados da compilação antes de aceitar uma correção. A assistência do Copilot não altera quais os objetos que o conversor suporta automaticamente nem recupera código-fonte que não esteja disponível. Consulte Resolver problemas de conversão de endereços com o GitHub Copilot.

Deployment

A Experiência de Instalação gera instruções e scripts que utilizam os ficheiros objeto em postgres_ddl. Reveja o âmbito da implantação e as correções e, em seguida, execute o programa de configuração no destino escolhido. Gerar ficheiros não os instala. Reveja os resultados da implementação e teste, de forma independente, os dados e o comportamento da aplicação.

Modos de conectividade Oracle

O modo thin não precisa das bibliotecas do Oracle Client; o modo thick usa-as. A extensão seleciona o modo com base no cliente que detecta. Prepare a máquina onde o Visual Studio Code é executado de acordo com os requisitos da sua ligação ao Oracle, incluindo encriptação nativa de rede ou verificação por soma de controlo. Consulte a configuração do cliente Oracle no tutorial.

Autenticação para Microsoft Foundry

Utilize uma chave API de recurso ou Microsoft Entra ID com permissão para invocar o modelo. Uma chave API pertence ao recurso do Azure AI Foundry, não a uma implementação individual. O nome da implementação identifica a implementação do modelo dentro desse recurso. Siga os pré-requisitos de autenticação do Foundry e os passos de configuração do assistente.

Segurança e rede

Ao utilizar a funcionalidade de conversão de esquemas, certifique-se de que o seu ambiente Visual Studio Code pode ligar-se de forma segura tanto à sua base de dados Oracle de origem como ao servidor flexível Base de Dados do Azure para PostgreSQL ou ao cluster Azure HorizonDB que hospeda a base de dados de validação de esquemas.

A Microsoft recomenda que se ligue ao seu recurso Microsoft Foundry usando um endpoint privado. Para mais informações, consulte Configure um link privado para Microsoft Foundry.

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

Diagrama de como o Visual Studio Code se liga a um endpoint privado.

Important

O resultado da conversão do Foundry e as sugestões do Copilot requerem ambos revisão independente. A compilação e a revisão assistida por IA não estabelecem uma lógica de negócio equivalente nem a prontidão para produção. Teste o tratamento de dados, dependências, controlos de segurança e comportamento da aplicação antes da utilização em produção.

Objetos de esquema suportados

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

Um estado Convertido regista um resultado; não certifica compilação, implementação completa ou inclusão na implementação. Inspecione definições e notas, incluindo marcadores de posição e dependências.

Objetos de esquema de base de dados

Os tipos de objetos suportados incluem tabelas, restrições, índices B-tree e únicos, sequências, triggers ao nível da linha e ao nível da instrução, vistas, vistas materializadas, esquemas e sinónimos públicos e privados. O comportamento específico de armazenamento, atualização e sinónimos da Oracle pode exigir trabalho manual.

Objetos de código Oracle

As construções de código suportadas incluem pacotes, funções, procedimentos, lógica de gatilhos, tipos de objetos e corpos de tipos, bem como coleções como VARRAY, tabelas aninhadas e SUBTYPE declarações. Revise as implementações dos membros e os chamadores, não apenas o estado do objeto pai.

Conversão de pacote

Os membros do pacote podem mapear para múltiplas definições PostgreSQL. Revise ajudantes de estado gerados, constantes, coleções, cursores e tratamento de exceções. Pacotes apenas de especificação podem gerar marcadores de posição. Consulte orientações para validação de objetos complexos e revisão de pacotes no Conversion Object Explorer.

Consultas hierárquicas

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

Controlo de transações

As rotinas que usam PRAGMA AUTONOMOUS_TRANSACTION podem depender de dblink e de alterações aos seus chamadores. Validar de forma independente ligações, limites de transação e gestão de erros; consulte orientações de validação de objetos complexos.

Validar PL/pgSQL convertido com plpgsql_check

Criar uma rotina PL/pgSQL não valida todos os caminhos executáveis. Quando suportado e configurado, plpgsql_check adiciona verificações estáticas dos corpos de rotinas na base de dados de validação de esquemas. Sem ele, essas verificações adicionais não estão disponíveis. Nem a compilação nem o estado Convertido provam que foram executados ou que o comportamento corresponde ao Oracle. Para disponibilidade, pré-carregamento e etapas de instalação, consulte Permitir e instalar extensões necessárias.

Versões Oracle suportadas

A conversão de esquema suporta as seguintes versões da base de dados Oracle. Para o ambiente de conversão e os requisitos do PostgreSQL, consulte os pré-requisitos do tutorial.

  • Oracle 21c
  • Oráculo 19c
  • Oráculo 18c
  • Oracle 12.2
  • Oracle 12.1

Suporte à extensão PostgreSQL

Para reportar um bug ou solicitar uma funcionalidade, apresente uma questão no repositório GitHub do vscode-pgsql. Prefixe o título do problema com Schema Conversion:. Para bugs, inclua a versão da extensão, a fase de falha e as mensagens de erro censuradas relevantes. Remova credenciais, informações secretas e detalhes sensíveis do esquema antes de partilhar.