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

Este artigo responde às perguntas mais comuns sobre a conversão de esquema do Oracle para Azure PostgreSQL na extensão Visual Studio Code PostgreSQL. O recurso usa Microsoft Foundry para converter esquemas de bancos de dados Oracle em DDL do Azure PostgreSQL.

Quais bancos de dados de destino do Azure têm suporte?

Você pode usar Banco de Dados do Azure para PostgreSQL servidor flexível ou Azure HorizonDB para o banco de dados de validação de esquema e o destino de implantação. Faça a correspondência entre a versão principal do PostgreSQL e as extensões necessárias no banco de dados de validação de esquema e no destino da implantação. Consulte os requisitos para o banco de dados de validação de esquema.

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

Não automaticamente. A ferramenta gera DDL do Azure PostgreSQL para revisão e validação. Um status convertido ou uma compilação bem-sucedida não estabelece uma implementação completa, um comportamento de runtime equivalente ou uma preparação de produção. Para obter o fluxo de validação recomendado, consulte Práticas recomendadas para conversão de esquema do Oracle para o Azure PostgreSQL.

O que a ferramenta de conversão faz?

A ferramenta lê metadados dos esquemas Oracle selecionados e gera artefatos do Azure PostgreSQL para revisão e implantação em qualquer um dos serviços do Azure compatíveis:

  • arquivos DDL do Azure PostgreSQL. Arquivos de objeto em postgres_ddl para tabelas, exibições, funções, procedimentos, gatilhos, tipos, sequências e índices.
  • Relatórios de conversão. Resumos estruturados do que foi convertido, do que foi ignorado e de todos os itens que precisam de revisão.

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

Há um custo extra para o recurso de conversão de esquema?

O recurso de conversão de esquema não tem nenhuma cobrança adicional separada. Orçamento para os serviços que você usa:

  • uso do Microsoft Foundry: os tokens de IA consumidos durante a conversão. Para informações sobre preços, consulte preços do Microsoft Foundry.
  • Banco de Dados do Azure para PostgreSQL – Servidor Flexível: o servidor de destino (e qualquer servidor que hospeda um banco de dados de validação de esquema). Para obter preços, consulte preços do Banco de Dados do Azure para PostgreSQL.
  • Azure HorizonDB: os recursos que hospedam o banco de dados de validação de esquema e o destino de implantação se você usar esse serviço. Examine os preços da configuração do cluster selecionado.
  • GitHub Copilot: a assinatura e quaisquer encargos de uso associados a Ask e Fix, de acordo com seu plano e configurações organizacionais. Essas cobranças são separadas das cobranças do Foundry. Consulte cobrança do GitHub Copilot.

Você pode incorrer em encargos para outros recursos escolhidos, como uma máquina virtual de conversão. Os pré-requisitos do tutorial listam os planos de Copilot para esse fluxo de trabalho.

Por onde começar?

Siga o passo a passo de ponta a ponta no Tutorial: Converter esquemas Oracle em Azure PostgreSQL. O tutorial aborda a instalação da extensão, a conexão com a origem Oracle e o 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 de um esquema Oracle usando uma implantação de modelo do Microsoft Foundry. Ele processa a conversão em lotes, tenta compilar no banco de dados de validação de esquema e resume os resultados em um relatório de resumo do cliente.

Meu esquema ou dados são enviados para a IA? Algo foi retido?

Distinga a conversão automatizada, a assistência do Copilot e os arquivos mantidos em seu workspace:

Workflow Dados a serem considerados
Conversão do Foundry Definições e metadados de esquema extraídos, incluindo nomes, corpos de rotina, exibições e gatilhos, são enviados para o modelo configurado. A extração automatizada lê catálogos Oracle, não linhas de tabelas do aplicativo. As definições ainda podem conter literais confidenciais ou comentários.
Copilot Perguntar e Corrigir Os detalhes do objeto e o contexto fornecidos ao Copilot são tratados de acordo com seu plano do Copilot, configurações e políticas de serviço. Examinar arquivos anexados, prompts e ações de ferramentas propostas; não suponha que o limite de extração somente de metadados se aplique a tudo o que você compartilha no Chat.
Artefatos locais do projeto O SQL, os relatórios e os logs gerados permanecem no workspace de conversão de esquema até que você os gerencie. Examine o conteúdo antes de compartilhar 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 dos recursos usados e da configuração de monitoramento de abuso aplicável. Consulte Dados, privacidade e segurança para Foundry Models. Copilot tem políticas separadas de tratamento de dados; consulte o GitHub Trust Center. Examine os requisitos de ambos os serviços antes de enviar definições de esquema confidenciais.

Onde o modelo é executado?

A conversão automatizada chama a implantação de modelo em seu recurso Microsoft Foundry. Seu local de processamento depende do tipo de implantação, não apenas da região do recurso:

  • Implantações globais podem processar solicitações em regiões do Azure.
  • As implantações de Zona de Dados processam solicitações dentro da zona de dados especificada.
  • As implantações provisionadas padrão e regionais seguem as regras de geografia de processamento para esses tipos.

Verifique o tipo real da implantação e as diretrizes de tipo de implantação do Foundry em relação aos requisitos de residência. Os compromissos de dados em repouso e o local de processamento de inferência são considerações diferentes. As solicitações do Copilot não herdam a configuração de residência da implantação do Foundry.

O que preciso antes de executar uma conversão?

Do lado do Azure:

No lado do Oracle, consulte os requisitos de origem do Oracle no tutorial.

Quais recursos do Oracle não podem ser convertidos?

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

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

A taxa de conversão é o número de objetos relatados como Convertidos divididos pelo total de conversão, expresso como uma porcentagem. Utilize os totais de conversão no relatório HTML, não os totais de descoberta ou extração.

Examine e verifique os objetos convertidos e não convertidos no Conversion Pesquisador de Objetos para inspecionar suas definições disponíveis e notas de conversão. A taxa de conversão não estabelece comportamento de runtime equivalente ou prontidão para produção.

Posso executar novamente uma conversão concluída?

No. Não há suporte para executar novamente a conversão em um projeto concluído. Mantenha os artefatos gerados como referência para o projeto e use Conversion Pesquisador de Objetos para examinar e corrigir definições do PostgreSQL. Fix também pode corrigir objetos dependentes e resolvê-los automaticamente após a compilação bem-sucedida. Compile as edições manuais e mantenha suas correções em postgres_ddl. Nem atualizar a Descoberta antes da conversão nem atualizar relatórios de conversão posteriormente executam novamente 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 como Não convertidos.

  1. Preserve o projeto de conversão de esquema, os artefatos gerados e os logs disponíveis. Registre a versão da extensão, o estágio com falha e a mensagem de erro.
  2. Verifique o progresso atual do projeto antes de iniciar outra operação. Não inicie uma segunda conversão enquanto a primeira ainda estiver em execução ou em recuperação.
  3. Resolva a causa relatada, como uma conexão Oracle ou erro de cliente, permissões de origem insuficientes, conectividade de banco de dados perdida, autenticação de modelo expirada ou limitação.
  4. Abra o projeto existente e siga as ações disponíveis para seu estado atual. A reabertura do projeto por si só não confirma que a conversão foi retomada. Se não puder continuar, relate o problema por meio do suporte à extensão PostgreSQL e inclua diagnósticos com trechos ocultados.

Se você optar por iniciar um novo projeto, preserve o primeiro original e examine o banco de dados de validação de esquema selecionado novamente. Uma nova conversão pode remover esquemas correspondentes e seus objetos dependentes; siga a preparação do banco de dados de validação de esquema. Não trate a saída parcial como um pacote de implantação completo.

Para uma execução concluída com objetos não convertidos , use o fluxo de trabalho de correção de objeto, não uma reinicialização de conversão. Para falhas de implantação, use as diretrizes de recuperação de instalação.

Qual é a diferença entre Resolve e Refresh?

Resolver no Explorador de Objetos de Conversão altera o status registrado de um objeto para Convertido. Não abre Copilot Chat, não compila o SQL nem o implanta. Atualizar atualiza os relatórios de conversão para refletir os status revisados. Use Atualizar após a resolução manual ou depois que a Correção resolver automaticamente objetos dependentes que foram compilados com êxito. Essas atualizações não estabelecem inclusão de implantação ou comportamento de aplicativo equivalente. Consulte Resolver objetos e atualizar relatórios.

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

Etapas de validação recomendadas:

  1. Examine o relatório de conversão HTML e use Conversion Pesquisador de Objetos para verificar objetos convertidos e não convertidos. Leia as anotações de conversão e resolva os problemas identificados.
  2. Valide procedimentos críticos para os negócios, gatilhos e exibições complexas em relação ao comportamento do Oracle.
  3. Execute testes funcionais, de integração e de desempenho com cargas de trabalho de aplicativos e dados representativos no banco de dados escolhido para teste.
  4. Verifique se as sequências foram além das IDs máximas dos dados antes de reabilitar as gravações de aplicativo.
  5. Confirme se todas as extensões necessárias estão instaladas e presentes em search_path.

Essas etapas não substituem seu plano mais amplo de migração e transição. Para obter diretrizes de validação de esquema, consulte As práticas recomendadas para conversão de esquema.

Como implantar e verificar o esquema convertido?

Use a Experiência de Configuração para implantar e verificar o esquema convertido. Examine o setup_instructions.md gerado e salve as correções nos arquivos de objeto gerados pela ferramenta em postgres_ddl. A Instalação lê o conteúdo salvo mais recente e ignora os arquivos adicionados manualmente a esse diretório. Prepare um servidor flexível do Banco de Dados do Azure para PostgreSQL ou um destino do Azure HorizonDB e execute verificações apenas de validação antes de executar o script de implantação do PowerShell ou Bash. A geração dos arquivos de configuração não implanta o esquema.

Após a implantação, examine o relatório de implantação de instalação, os resultados de verificação de objeto e extensão e os logs. Resolva quaisquer erros de implantação ou objetos que não foram implantados. Depois, faça um smoke test das funções críticas, dos procedimentos, dos gatilhos e das exibições no banco de dados que você escolher para teste. A configuração bem-sucedida não substitui a validação independente de dados e de aplicativos.

Onde posso obter ajuda?