Partilhar via

Tutorial: Oracle to Azure Database para Conversão de Esquemas PostgreSQL Preview

Este tutorial orienta-o na conversão de esquemas de bases de dados Oracle para Azure Database para PostgreSQL usando a extensão Visual Studio PostgreSQL com Azure OpenAI para automatizar e validar a tradução de esquemas

Abrange a ligação à sua fonte Oracle e ao destino Azure Database for PostgreSQL, a configuração do Azure OpenAI, a execução do Assistente de Migração e a revisão dos elementos gerados do PostgreSQL. Antes de começar, certifique-se de que tem acesso à rede e credenciais para ambos os servidores e uma implementação Azure OpenAI.

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

  • Descoberta de Esquemas: A ferramenta analisa os seus objetos de esquema Oracle
  • Processamento de IA: Azure OpenAI processa e converte objetos compatíveis
  • Validação: Os objetos convertidos são validados na base de dados scratch
  • Tarefas de Revisão: Objetos que exigem atenção manual são assinalados
  • 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

Categoria Detalhes
Versão Visual Studio Code 1.95.2 ou superior
GitHub Copilot subscrição Pro+, Negócios, Empresas

Suporte de sistema operativo

Sistema Operativo Detalhes de Apoio
Windows Apenas arquitetura x64
Linux Arquitetura x64
macOS macOS 13+

Suporte a versões PostgreSQL

Componente Requisito de Versão
Base de Dados do Azure para PostgreSQL PostgreSQL versão 15 ou superior
Base de dados scratch Base de Dados do Azure para PostgreSQL

Requisitos do modelo de IA

Precisa de configurar um dos seguintes componentes de IA:

Componente AI Versão do modelo
Azure OpenAI Implantação do GPT-4.1

Configuração de implementação do Azure OpenAI

Tem de configurar a implementação do Azure OpenAI com o modelo nomeado gpt-4.1.

Exemplo de formato de endpoint:

https://{your-resource}.openai.azure.com/openai/deployments/gpt-4.1/chat/completions?api-version=2025-01-01-preview

Privilégios obrigatórios para a base de dados

Antes de executares a conversão de esquema, assegura que as contas que utilizas têm os privilégios mínimos exigidos tanto na base de dados Oracle de origem como na base de dados Azure de experimentação para PostgreSQL. A conta Oracle precisa de acesso de leitura a dados e vistas de dicionário para que a ferramenta possa analisar esquemas e códigos. A conta scratch do PostgreSQL deve ser capaz de criar esquemas, tabelas e outros objetos para validação. Use uma conta de serviço dedicada sempre que possível. Siga o princípio do menor privilégio. Coordena com os teus DBAs para conceder quaisquer direitos temporários elevados e validar a conectividade e o acesso antes de iniciar a conversão.

Privilégios Originais da Oracle

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

Privilégio Propósito
CONNECT Ligação básica à base de dados
SELECT_CATALOG_ROLE Acesso a vistas de dicionários de dados
SELECIONE QUALQUER DICIONÁRIO Leia metadados do sistema e objetos do dicionário
SELECT SYS.ARGUMENT$ Acesso a informações sobre procedimentos e argumentos funcionais

Privilégios de base de dados temporária

Os seguintes privilégios são exigidos na Azure Database para PostgreSQL Flexible Server (Scratch DB):

Privilégio Propósito
CRIAR ESQUEMA Criar esquemas de validação
CRIAR NA BASE DE DADOS Criar objetos de base de dados para validação
GRANT CONNECT À BASE DE DADOS Permissões de ligação para processos de validação

Requisitos de rede

  • Conectividade de saída para endpoints do Azure OpenAI
  • Conectividade da base de dados tanto à Oracle de origem como à base de dados PostgreSQL de destino
  • Acesso HTTPS para o marketplace de extensões Visual Studio Code e serviços GitHub Copilot
  • Acesso ao repositório GitHub a https://github.com/microsoft/pgsql-tools/

Processo de migração

Esta secção percorre o fluxo de trabalho completo da migração: instalar a extensão PostgreSQL, criar e testar ligações à sua fonte Oracle e Azure Database para o destino PostgreSQL, abrir e inicializar um projeto de migração, configurar o Azure OpenAI para tradução de esquemas, executar o Assistente de Migração para descobrir e converter esquemas, validar objetos convertidos numa base de dados scratch e rever ou corrigir quaisquer itens sinalizados antes de aplicar os artefactos Gerados do PostgreSQL ao seu destino.

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

  1. Abra o Visual Studio.

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

  3. Pesquise PostgreSQL e instale a extensão PostgreSQL.

    1. Transferência no Marketplace

    Captura de ecrã da instalação da extensão PostgreSQL no VS Code.

Passo 2: Criar ligação PostgreSQL

  1. No painel de extensão do PostgreSQL, crie uma ligação à sua base de dados Azure para PostgreSQL.

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

  3. Teste e guarde a ligação.

    Captura de ecrã da adição de uma nova ligação PostgreSQL.

Passo 3: Abrir um novo espaço de trabalho

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

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

    Captura de ecrã de adicionar novo espaço de trabalho no VS Code.

Passo 4: Inicializar o projeto de migração

  1. Vai à extensão PostgreSQL.

  2. Navegue até ao painel de Migrações (pré-visualização ).

  3. Selecionar Criar Projeto de Migração.

    Captura de ecrã da criação de um novo 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 Avançar para prosseguir para a próxima etapa.

    Captura de ecrã do nome do projeto.

Passo 6: Configurar a ligação Oracle

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

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

  2. Selecione Load Schemas.

  3. O sistema testa a ligação Oracle.

  4. Se for bem-sucedido, lista todos os esquemas definidos pelo utilizador disponíveis na Oracle.

  5. Escolhe um ou vários esquemas que queres converter para PostgreSQL.

  6. Selecione Seguinte para continuar.

    Captura de ecrã da configuração de um servidor Oracle.

Passo 7: Configurar uma base de dados scratch do PostgreSQL

  1. Selecione a base de dados Azure para a ligação PostgreSQL que definiu na extensão PostgreSQL

  2. Selecione a base de dados alvo na lista suspensa

  3. Selecione Seguinte para prosseguir

    Captura de ecrã de configurar uma base de dados scratch.

Passo 8: Configurar um modelo de linguagem Azure OpenAI

  1. Introduza os dados do Azure OpenAI, incluindo:

    • URL do ponto de extremidade
    • chave de API
    • Nome da implantação (deve ser gpt-4.1)

  2. Selecione Teste de Ligação para verificar a configuração

  3. Quando a ligação for bem-sucedida, selecione Criar Projeto de Migração

    Captura de ecrã da configuração do modelo de linguagem.

Passo 9: Executar a conversão de 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. Monitorizar o progresso da conversão na interface do Visual Studio

    Captura de ecrã do progresso do passo de migração.

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

  1. Uma vez concluída a conversão de esquema, é gerado um relatório de conversão de esquema .
  2. Revise os objetos que foram convertidos com sucesso ou que foram ignorados.
  3. O relatório mostra a percentagem de sucesso da conversão.

Passo 11: Rever e refinar as tarefas de conversão

  1. Uma vez concluída a conversão do esquema, são criadas tarefas de Revisão para objetos que requerem atenção.
  2. Usa agentes do GitHub Copilot ou converte manualmente esquemas para PostgreSQL.
  3. Revise e compare as declarações de conversão de esquemas anteriores convertidas e novas esquemas convertidas.

Passo 12: Validar objetos convertidos antes da implementação

  1. Validar independentemente todos os objetos convertidos num ambiente não produtivo.
  2. Confirme que dependências, restrições e cargas de trabalho representativas se comportam como esperado.
  3. Revise as resoluções de todas as tarefas de revisão e volte a testar após as alterações.

Importante

Responsabilidade pela validação do cliente: O mesmo motor de IA usado para conversão de esquemas também pode ajudar na validação e revisão. Os sistemas de IA podem, por vezes, confirmar os seus próprios erros. Para evitar perda de dados, regressões funcionais ou problemas de segurança, valide de forma independente todos os objetos convertidos e reveja as resoluções das tarefas antes de implementar para produção. Como parte dos seus controlos, considere ativar a filtragem de conteúdos do Azure AI Foundry para ajudar a reduzir saídas prejudiciais ou indesejadas. Para orientação, consulte filtragem de conteúdos no Azure AI Foundry.

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

Conteúdo relacionado

  • Last updated on