Perguntas frequentes sobre a conversão de esquemas Oracle para Azure PostgreSQL

Este artigo responde às perguntas mais comuns sobre a conversão de esquema de Oracle para Azure PostgreSQL na extensão Visual Studio Code PostgreSQL. A funcionalidade utiliza o Microsoft Foundry para converter esquemas de bases de dados Oracle em Azure PostgreSQL DDL.

Quais destinos da base de dados Azure são suportados?

Pode utilizar o Base de Dados do Azure para PostgreSQL flexible server ou o Azure HorizonDB tanto para a base de dados de validação de esquema como para o destino de implementação. Faça corresponder a versão principal do PostgreSQL e as extensões necessárias entre a base de dados de validação do esquema e o destino de implementação. Consulte os requisitos da base de dados de validação de esquemas.

O esquema convertido está pronto para produção?

Não automaticamente. A ferramenta gera DDL Azure PostgreSQL para revisão e validação. Um estado de Convertido ou compilação bem-sucedida não estabelece uma implementação completa, comportamento equivalente em tempo de execução ou prontidão para produção. Para o fluxo de validação recomendado, consulte Melhores práticas para conversão de esquema Oracle para Azure PostgreSQL.

O que faz a ferramenta de conversão?

A ferramenta lê metadados dos esquemas Oracle selecionados e gera artefactos Azure PostgreSQL para revisão e implementação em qualquer um dos serviços Azure suportados:

  • Ficheiros DDL Azure PostgreSQL. Ficheiros objeto em postgres_ddl de tabelas, vistas, funções, procedimentos, disparadores, tipos, sequências e índices.
  • Relatórios de conversão. Resumos estruturados do que foi convertido, do que foi omitido e de quaisquer itens que necessitem de revisão.

Para uma visão geral completa das entradas, saídas e do pipeline de conversão, consulte O que é a conversão de esquema Oracle para Azure PostgreSQL?

Há algum custo extra pela funcionalidade de conversão de esquema?

A funcionalidade de conversão de esquemas não tem um custo adicional em separado. Orçamento para os serviços que utiliza:

  • Utilização do Microsoft Foundry: os tokens de IA consumidos durante a conversão. Para preços, consulte Microsoft Foundry pricing.
  • Base de Dados do Azure para PostgreSQL servidor flexível: o servidor alvo (e qualquer servidor que aloje uma base de dados de validação de esquemas). Para obter informações sobre preços, consulte preços do Base de Dados do Azure para PostgreSQL.
  • Azure HorizonDB: os recursos que hospedam a base de dados de validação do esquema e o destino de implementação caso utilize este serviço. Revise os preços da configuração de cluster selecionada.
  • GitHub Copilot: a subscrição e quaisquer custos de utilização associados ao Ask and Fix, de acordo com o seu plano e definições organizacionais. Estas taxas são separadas dos custos do Foundry. Consulte faturação do GitHub Copilot.

Pode incorrer em custos por outros recursos que escolher, como uma máquina virtual de conversão. Os pré-requisitos do tutorial listam os planos do Copilot para este fluxo de trabalho.

Como posso começar?

Siga o guia de ponta a ponta no Tutorial: Converter esquemas Oracle para Azure PostgreSQL. O tutorial aborda a instalação da extensão, a ligação à fonte Oracle e ao destino Azure selecionado, a configuração do Microsoft Foundry e a execução da primeira conversão.

Como funciona a conversão?

A extensão Visual Studio Code PostgreSQL gera definições PostgreSQL a partir de um esquema Oracle utilizando a implementação de um modelo Microsoft Foundry. Processa a conversão em lotes, tenta compilar na base de dados de validação de esquemas e resume os resultados num relatório resumo do cliente.

O meu esquema ou dados são enviados para a IA? Alguma coisa é retenida?

Distingua a conversão automática, a assistência do Copilot e os ficheiros guardados no seu espaço de trabalho:

Workflow Dados a considerar
Conversão Foundry Definições de esquema e metadados extraídos, incluindo nomes, corpos de rotina, vistas e triggers, são enviados para o modelo configurado. A extração automatizada lê catálogos Oracle, não linhas de tabelas da aplicação. As definições podem ainda conter literais ou comentários sensíveis.
Copilot Ask e Fix Os detalhes dos objetos e o contexto fornecidos ao Copilot são tratados no âmbito do seu plano, definições e políticas de serviço do Copilot. Revise ficheiros anexados, prompts e ações propostas para a ferramenta; não presuma que o limite de extração apenas de metadados se aplica a tudo o que partilha no Chat.
Artefatos locais do projeto SQL gerado, relatórios e registos permanecem no espaço de trabalho de conversão de esquemas até que os gere corretamente. Revise os seus conteúdos antes de partilhar e aplique as políticas de acesso e retenção da sua organização.

Não presuma retenção zero. A retenção do Foundry depende das APIs e funcionalidades utilizadas e da configuração de monitorização de abuso aplicável. Consulte Dados, privacidade e segurança para Foundry Models. O Copilot tem políticas de tratamento de dados separadas; consulte o Centro de Confiança do GitHub. Revise os requisitos de ambos os serviços antes de submeter definições de esquemas sensíveis.

Onde corre o modelo?

A conversão automática chama o deployment do modelo no seu recurso Microsoft Foundry. A sua localização de processamento depende do tipo de implementação, não apenas da região do recurso:

  • Implementações globais podem processar pedidos em várias regiões do Azure.
  • As implementações da Zona de Dados processam pedidos dentro da zona de dados especificada.
  • As implementações provisionadas padrão e regional seguem as regras de geografia de processamento para esses tipos.

Verifique o tipo real da implantação e as orientações do tipo de implantação do Foundry em relação aos seus requisitos de residência. Compromissos de dados em repouso e localização do processamento de inferência são considerações diferentes. Os pedidos Copilot não herdam a configuração de residência da sua implementação Foundry.

O que preciso antes de fazer uma conversão?

Do lado do Azure:

Do lado da Oracle, veja os requisitos de origem da Oracle no tutorial.

Que funcionalidades da Oracle não podem ser convertidas?

Consulte limitações da conversão de esquemas de Oracle para Azure PostgreSQL para lacunas de extração conhecidas e conversões parciais. Utilize o fluxo de trabalho de correção assistida para objetos com definições disponíveis e planeie separadamente para objetos excluídos da extração.

O que significa a taxa de conversão para o meu projeto?

A taxa de conversão é o número de objetos reportados como Convertidos dividido pelo total de conversão, expresso em percentagem. Utilize os totais de conversão no relatório HTML, não os totais de descoberta ou extração.

Revise e verifique tanto os objetos convertidos como os não convertidos no Conversion Object Explorer para inspecionar as suas definições e notas de conversão. A conversão não estabelece comportamento equivalente em tempo de execução nem prontidão para produção.

Posso repetir uma conversão concluída?

Não. A reexecução de conversão num projeto concluído não é suportada. Mantenha os artefactos gerados como referência para o projeto e utilize o Conversion Object Explorer para rever e corrigir definições do PostgreSQL. O Fix também pode corrigir objetos dependentes e resolvê-los automaticamente após compilação bem-sucedida. Compile as edições manuais e mantenha as suas correções em postgres_ddl. Nem atualizar o Discovery antes da conversão nem atualizar os relatórios de conversão depois reexecutam uma conversão concluída.

O que devo fazer se a conversão falhar ou for interrompida?

Uma execução incompleta é diferente de uma execução concluída com objetos marcados Não convertidos.

  1. Preserve o projeto de conversão de esquema, os artefactos gerados e os registos disponíveis. Registe a versão da extensão, a fase de falha e a mensagem de erro.
  2. Verifique o progresso atual do projeto antes de iniciar outra operação. Não comece uma segunda conversão enquanto a primeira ainda está a funcionar ou a recuperar.
  3. Resolva a causa comunicada, como um erro de ligação ao Oracle ou erro do cliente, permissões de origem insuficientes, perda de conectividade à base de dados, autenticação do modelo expirada ou limitação da taxa.
  4. Abra o projeto existente e siga as ações disponíveis para o seu estado atual. Reabrir o projeto, por si só, não confirma que a conversão foi retomada. Se não puder continuar, reporte o problema através do suporte da extensão PostgreSQL e inclua diagnósticos censurados.

Se optar por iniciar um novo projeto, preserve primeiro o original e revise novamente a base de dados de validação do esquema selecionada. Uma nova conversão pode eliminar esquemas correspondentes e os seus objetos dependentes; siga a preparação da base de dados de validação de esquemas. Não trate a saída parcial como um pacote de implementação completo.

Para uma execução concluída com objetos Não convertidos , utilize o fluxo de trabalho de correção de objetos, não um reinício de conversão. Para falhas de implantação, utilize as orientações de recuperação do Setup.

Em que é que o Resolve e o Refresh diferem?

Resolve no Object Explorer de Conversão altera o estado registado de um objeto para Convertido. Não abre o Copilot Chat, não compila SQL nem o implementa. Atualizar atualiza os relatórios de conversão para refletir os estados revistos. Utilize Atualizar após resolução manual ou depois de Corrigir resolver com sucesso os objetos dependentes compilados. Estas atualizações não estabelecem inclusão de implantação nem comportamento equivalente da aplicação. Consulte Resolver objetos e atualizar relatórios.

Que validação devo fazer antes de passar para produção?

Passos recomendados para validação:

  1. Consulte o relatório de conversão HTML e use o Conversion Object Explorer para verificar tanto os objetos convertidos como os não convertidos. Leia as notas de conversão e resolva os problemas identificados.
  2. Valide procedimentos, gatilhos e vistas complexas críticas para o negócio contra o comportamento da Oracle.
  3. Execute testes funcionais, de integração e de desempenho com dados representativos e cargas de trabalho de aplicações na base de dados que escolher para testes.
  4. Verifique se as sequências estão avançadas para além dos IDs máximos dos dados antes de reativar as escritas da aplicação.
  5. Confirme que todas as extensões necessárias estão instaladas e presentes em search_path.

Estes passos não substituem o seu plano mais amplo de migração e cutover. Para orientações para validação de esquemas, consulte Melhores práticas para conversão de esquemas.

Como é que implemento e verifico o esquema convertido?

Utilize a Setup Experience para implementar e verificar o esquema convertido. Revise o setup_instructions.md gerado e guarde as correções nos ficheiros de objetos gerados pela ferramenta em postgres_ddl. O programa de instalação lê o conteúdo guardado mais recente e ignora ficheiros adicionados manualmente a esse diretório. Prepare uma Base de Dados Base de Dados do Azure para PostgreSQL para servidor flexível ou destino Azure HorizonDB, e execute verificações apenas de validação antes de executar o script de implementação PowerShell ou Bash. Gerar ficheiros de configuração não implementa o schema.

Após a implementação, reveja o relatório de implementação da configuração, os resultados da verificação de objetos e extensões, e os registos. Resolva quaisquer erros de implementação em produção ou objetos que não tenham sido implementados em produção. Depois, faça um teste rápido de verificação das funções críticas, procedimentos, gatilhos e vistas na base de dados que escolher para testes. Uma configuração bem-sucedida não substitui a validação independente de dados e aplicações.

Onde posso obter ajuda?