Consulte o relatório HTML para conversão de esquema Oracle

Depois de executar a conversão do esquema Oracle para Azure PostgreSQL na extensão PostgreSQL para Visual Studio Code, utilize o relatório HTML para rever os resultados registados. O relatório aplica-se a conversões que utilizam o Base de Dados do Azure para PostgreSQL – Servidor Flexível ou o Azure HorizonDB. Reúne descoberta, extração, resultados de conversão, detalhes do ambiente e ligações para relatórios a nível de objeto para uma sessão de conversão.

Utilize-o para confirmar o âmbito, investigar objetos que precisam de atenção e partilhar os resultados com a sua equipa de projeto. Para o fluxo de conversão, consulte Tutorial: Converter esquemas do Oracle para Azure PostgreSQL.

Abrir o relatório

O relatório HTML abre automaticamente quando a conversão de esquema é concluída. Também pode abri-lo de uma das seguintes formas:

  • Na página de resumo de Conversão , selecione Relatório de Conversão.
  • No Explorador do Workspace, abra .github\postgres-migrations\<migration-project> e localize o convert\sessions\<session-id>\reports\report.html da execução pretendida. Pesquise nesse projeto, se necessário, em vez de abrir um relatório de outro projeto com um nome semelhante.

Verifique o ID da sessão no título de Conversão do relatório para confirmar que está a rever a execução pretendida. Comece com Resumo Geral e selecione os links do resumo ou expanda os títulos das secções para ver mais detalhes.

Atualizar relatórios após correções de objetos

Após corrigir objetos no Conversion Object Explorer, atualize os relatórios antes de rever ou partilhar os resultados:

  1. Revise as definições corrigidas e os resultados da compilação. O Fix também pode corrigir objetos dependentes e resolvê-los automaticamente após compilação bem-sucedida.
  2. Para um objeto que requer uma atualização manual do estado, selecione Resolver no Conversion Object Explorer para o marcar como Convertido.
  3. Selecione Atualizar no Conversion Object Explorer para atualizar os relatórios de conversão com os estados revistos.
  4. Abra novamente o relatório e reveja os resultados atualizados.

Atualizar relatórios não volta a executar a conversão de esquemas nem substitui a validação independente dos dados e da aplicação.

Leia o resumo geral

O resumo separa os resultados de cada fase:

Resumo O que rever
Deteção Objetos descobertos na fonte, incluindo contagens para A ser extraído, Excluído e Inválido.
Extração Definições obtidas da fonte, juntamente com as contagens de Falhados e Excluídos. Uma definição extraída não é um objeto convertido.
Conversão Contagens de convertidos e não convertidos para a sessão de conversão.
Taxa de conversão (%) Objetos convertidos divididos pelo total de conversão, expresso como percentagem.

Descoberta, extração e conversão não contam necessariamente os mesmos objetos. Por exemplo, a conversão pode incluir objetos de esquema gerados. Utilize o total de conversão mostrado no relatório, e não o total de descoberta ou extração, ao interpretar a taxa de conversão. Expanda o Glossário para as regras de contagem e definições utilizadas pelo relatório.

O exemplo seguinte mostra o relatório antes das correções de objetos.

Captura de ecrã dos cartões de resumo geral que mostram descoberta, extração, contagens de conversões e a taxa de conversão.

Em Conversão ao nível do esquema, reveja as contagens e a taxa de conversão de cada esquema. A coluna Função distingue:

  • Selecionado: Um esquema de origem que escolheu para a conversão.
  • Incluído: Um esquema adicional representado no inventário de conversão.

Estes rótulos descrevem o âmbito do relatório. Não significam que todos os esquemas referenciados pela sua fonte foram automaticamente selecionados, extraídos ou implantados. Compare-os com Dependent schemas na Descoberta e reveja os resultados ao nível do objeto. Utilize Pesquisar esquemas para encontrar um esquema, ou selecione o seu nome para abrir os resultados do tipo de objeto.

Exemplo: Ler uma taxa de conversão alterada

Suponha que o resumo da conversão mostra 20 objetos no total: 18 convertidos e dois não convertidos. A taxa de conversão é de 90%. Corrige um desses dois objetos, confirma a compilação, atualiza o seu estado se necessário e seleciona Refresh. Se o total permanecer 20 e não houver outras alterações de estado, 19 objetos convertidos produzem uma taxa de 95%.

Utilize os totais reais do relatório, incluindo quaisquer objetos dependentes resolvidos pelo Fix. A percentagem revista regista as alterações do estado da conversão; não mede a equivalência em tempo de execução nem o número de objetos implementados. Para os passos de correção, consulte o exemplo do Conversion Object Explorer.

Encontre objetos que precisem de atenção

Comece pelos 5 tipos de objetos principais a rever e veja as cinco taxas de conversão mais baixas entre os tipos com objetos não convertidos. Esta lista não classifica a criticidade empresarial. Selecione um tipo de objeto para o investigar, ou selecione Ver mais para abrir a secção completa de conversão de tipo de Objeto .

A partir do relatório principal, investigue os resultados da conversão:

  1. Expanda a Conversão e depois expanda a Conversão do tipo de Objeto.
  2. Para restringir a tabela, selecione Todos os tipos de objetos, escolha um ou mais tipos e selecione Concluído. A tabela mostra um total filtrado para os tipos selecionados. Para restaurar todos os tipos, reabra o controlo, selecione Limpar filtro e depois selecione Concluído.
  3. Selecione o nome de um tipo de objeto para abrir o seu relatório ao nível do objeto.
  4. Utilize o Nome do Esquema para restringir os resultados por esquema, quando esse filtro estiver disponível. Utilize Search name para encontrar um nome de origem Oracle ou um nome de destino PostgreSQL.
  5. Selecione um cabeçalho de coluna ordenável, como Nome de Origem ou Estado, para ordenar as linhas. Selecione novamente para inverter a ordem.
  6. Revise a coluna Estado , que mostra Convertido ou Não Convertido. Selecione Notas, quando disponível, para ler as notas de conversão gravadas do objeto.

Captura de ecrã do relatório do objeto VIEW com filtros de esquema e nome, nomes de origem e destino, estados e botões de Notas.

O painel de notas identifica o objeto e fornece a explicação registada, como uma alteração de conversão, uma falha de validação ou uma diferença que requer revisão. Notas de revisão para objetos convertidos, bem como para objetos que não foram convertidos.

Important

Um resultado convertido não estabelece, por si só, o sucesso da compilação, uma implementação completa, a inclusão na implantação ou um comportamento equivalente em tempo de execução. A compilação verifica a sintaxe e a estrutura, não os dados ou o comportamento da aplicação. Conclua testes de tempo de execução separados antes da utilização em produção.

Rever membros do pacote

Voltar ao relatório principal e expandir a Conversão e Conversão de Pacotes para rever os resultados ao nível do pacote e ao nível dos membros. Utilize Nome do esquema e Filtrar pacotes para encontrar um pacote. A tabela mostra o seu estado do Pacote, número de membros, contagens de membros convertidos e não convertidos, e taxa de conversão de membros.

Captura de ecrã da conversão de pacote mostrando os totais de pacotes e membros, filtros e resultados da conversão de membros por pacote.

Selecione o nome de um pacote para abrir o seu relatório do membro. Revise Nome da fonte, Tipo da fonte, Nome do destino, Tipo do destino, Alteração, Estado e Notas para entender como os membros individuais correspondem ao PostgreSQL.

Captura de ecrã de um relatório de membro do pacote com ESCALATE_TASK selecionado e as suas notas de conversão gravadas.

Um pacote pode não ser convertido mesmo quando alguns dos seus membros são convertidos. As contagens de pacotes, as contagens de corpos de pacote e as contagens de membros descrevem diferentes populações. Não adicione o total de membros aos totais do tipo de objeto. Uma taxa de n/d significa que não existem objetos ou membros para esse cálculo, não uma taxa de conversão de 0%.

Investigar a deteção e a extração

Se um objeto esperado estiver em falta nos resultados de conversão, regresse ao relatório principal e reveja as fases anteriores:

  1. Expandir Discovery. Revise tipos de objetos suportados e tipos de objeto não suportados, e selecione um nome de tipo de objeto para abrir os detalhes de descoberta.
  2. Revise os grupos A Extrair, Excluído e Inválido aplicáveis. Utilize os filtros de esquema e texto para encontrar um objeto e ler a sua razão de exclusão ou invalidez quando fornecida.
  3. Revise as permissões de fonte e os esquemas dependentes para o acesso registado à origem e dependências de esquema. Contagens de referências de dependência não são contagens de objetos.
  4. Expanda a Extração para rever as contagens de Extraído, Falhado, Excluído e Inválido. Expandir os objetos extraídos por tipo para rever as definições retiradas da Oracle por tipo de objeto.

Um objeto Excluído foi omitido da extração; esse estado não estabelece que existe um substituto no PostgreSQL. Uma contagem de extrações com Falhou representa definições que não puderam ser recuperadas, não a contagem Não convertido da fase de conversão.

Revisão do ambiente e das informações de apoio

Utilize as secções restantes para compreender o contexto da execução e planear o trabalho de seguimento:

Secção O que rever
Ambiente Detalhes de origem, Target (a base de dados de validação de esquema usada para esta execução, não prova de um destino de implementação posterior), extensões usadas pela Conversão de Esquema e definições do LLM .
Próximos Passos - Configuração Orientação sobre conectividade alvo, permissões, esquemas e pré-requisitos de extensão antes da configuração.
Referências Ligações para documentação pública, o CSV de mapeamento de objetos e a localização do relatório.
Glossário Definições de estados, taxas de conversão, contagem de pacotes e membros, e outros termos do relatório.

Em Referências, abra object_mapping_summary.csv para nomes e tipos de objetos de origem e alvo, estados registados e ações necessárias. As entradas de mapeamento podem diferir dos totais dos objetos de relatório, por isso não use a contagem de linhas CSV como denominador da taxa de conversão.

Utilize Next Steps - Setup como orientação de preparação. O relatório em si não é um script de deployment.

Partilhar o relatório

Mantenha o diretório de relatórios unido para que as ligações relativas aos relatórios a nível de objeto continuem a funcionar. Revise e partilhe apenas através de um local aprovado.

O diretório de relatórios pode conter nomes de bases de dados e esquemas, nomes de objetos, detalhes do ambiente e notas de conversão. Revise o conteúdo antes de partilhar, siga os requisitos de gestão de dados da sua organização e remova credenciais ou segredos de tudo o que partilhe.