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

Depois de executar o Oracle para Azure conversão de esquema PostgreSQL na extensão PostgreSQL para Visual Studio Code, use o relatório HTML para examinar os resultados registrados. O relatório se aplica a conversões que usam o Banco de Dados do Azure para PostgreSQL - Servidor Flexível ou o Azure HorizonDB. Ele reúne descoberta, extração, resultados de conversão, detalhes do ambiente e links para relatórios no nível do objeto para uma sessão de conversão.

Use-o para confirmar o escopo, investigar objetos que precisam de atenção e compartilhar os resultados com sua equipe de projeto. Para o fluxo de conversão, consulte Tutorial: Converter esquemas do Oracle para o PostgreSQL do Azure.

Abra o relatório

O relatório HTML é aberto automaticamente quando a conversão de esquema é concluída. Você também pode abri-lo de uma das seguintes maneiras:

  • Na página resumo de conversão , selecione Relatório de conversão.
  • No Gerenciador de workspaces, abra .github\postgres-migrations\<migration-project> e localize a execução convert\sessions\<session-id>\reports\report.htmlpretendida. Pesquise dentro desse projeto, se necessário, em vez de abrir um relatório de nome semelhante de outro projeto.

Verifique a ID da sessão no título conversão do relatório para confirmar se você está revisando a execução pretendida. Comece com o resumo geral e selecione os links de resumo ou expanda os títulos da seção para ver mais detalhes.

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

Depois de corrigir objetos no Conversion Pesquisador de Objetos, atualize os relatórios antes de examinar ou compartilhar os resultados:

  1. Examine as definições corrigidas e os resultados da compilação. Corrigir também pode corrigir objetos dependentes e resolvê-los automaticamente após a compilação bem-sucedida.
  2. Para um objeto que precisa de uma atualização de status manual, selecione Resolver em Conversion Pesquisador de Objetos para marcá-lo como Convertido.
  3. Selecione Atualizar no Conversion Pesquisador de Objetos para atualizar os relatórios de conversão com os status revisados.
  4. Abra o relatório novamente e examine os resultados atualizados.

A atualização de relatórios não executa novamente a conversão de esquema nem substitui dados independentes e a validação do aplicativo.

Ler o resumo geral

O resumo separa os resultados de cada fase:

Resumo O que revisar
Descoberta Objetos descobertos na origem, incluindo contagens para serem extraídos, Excluídos e Inválidos.
Extração Definições recuperadas da origem, com contagens de Falhas 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, expressos como uma porcentagem.

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

O exemplo a seguir mostra o relatório antes das correções de objeto.

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

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

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

Esses rótulos descrevem o escopo do relatório. Eles não significam que todos os esquemas referenciados pela fonte foram automaticamente selecionados, extraídos ou implantados. Compare-os com esquemas dependentes no Discovery e examine os resultados no nível do objeto. Use Pesquisar esquemas para encontrar um esquema ou selecione o nome para abrir os resultados de tipo do objeto.

Exemplo: ler uma taxa de conversão alterada

Suponha que o resumo da conversão mostre 20 objetos totais: 18 Convertidos e dois Não convertidos. A taxa de conversão é de 90%. Corrija um desses dois objetos, confirme a compilação, atualize seu status, se necessário, e selecione Atualizar. Se o total permanecer 20 e não houver nenhuma outra alteração de status, 19 objetos convertidos produzirão uma taxa de 95%.

Use os totais reais do relatório, incluindo todos os objetos dependentes resolvidos por Corrigir. O status de conversão de registros percentuais revisados muda; ele não mede a equivalência de runtime ou o número de objetos implantados. Para obter as etapas de correção, consulte o exemplo do Conversion Pesquisador de Objetos.

Localizar objetos que precisam de atenção

Comece com Top 5 tipos de objeto para examinar para ver as cinco taxas de conversão mais baixas entre tipos com objetos não convertidos. Essa lista não classifica a gravidade empresarial. Selecione um tipo de objeto para investigá-lo ou selecione Exibir mais para abrir a seção de conversão de tipo de objeto completa.

No relatório principal, investigue os resultados da conversão:

  1. Expanda Conversão e, em seguida, expanda Conversão de tipo de objeto.
  2. Para restringir a tabela, selecione Todos os tipos de objeto, 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 controle, selecione Limpar filtro e selecione Concluído.
  3. Selecione um nome do tipo de objeto para abrir seu relatório no nível do objeto.
  4. Utilize o Nome do Esquema para restringir os resultados por esquema, quando esse filtro estiver disponível. Use Pesquisar nome para encontrar um nome de origem Oracle ou um nome de destino PostgreSQL.
  5. Selecione um título de coluna classificável, como Nome da fonte ou Status, para classificar as linhas. Selecione-o novamente para reverter a ordem.
  6. Examine a coluna Status , que mostra Convertido ou Não convertido. Selecione Anotações, quando disponível, para ler as notas de conversão gravadas do objeto.

Captura de tela do relatório de objetos VIEW com filtros de esquema e nome, nomes de origem e de destino, status e botões de Anotações.

O painel de anotações identifica o objeto e fornece a explicação registrada, como uma alteração de conversão, uma falha de validação ou uma diferença que requer revisão. Examine as notas sobre objetos convertidos, bem como objetos que não foram convertidos.

Important

Um resultado Convertido, por si só, não comprova 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 do aplicativo. Realize o teste de runtime à parte antes do uso em produção.

Examinar membros do pacote

Retorne ao relatório principal e expanda Conversão e Conversão de pacote para examinar os resultados no nível do pacote e do membro. Use Nome do Esquema e Filtrar pacotes para encontrar um pacote. A tabela mostra o status do pacote, a contagem de membros, as contagens de membros convertidas e não convertidas e a taxa de conversão de membro.

Captura de tela da conversão de pacote mostrando os totais de pacote e membro, filtros e resultados de conversão por membro por pacote.

Selecione um nome do pacote para abrir o relatório do membro. Examine o nome da origem, o tipo de origem, o nome de destino, o tipo de destino, a alteração, o status e as anotações para entender como os membros individuais são mapeados para o PostgreSQL.

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

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

Investigar descoberta e extração

Se um objeto esperado estiver ausente dos resultados da conversão, retorne ao relatório principal e examine as fases anteriores:

  1. Expanda Descoberta. Examine os tipos de objeto com suporte e tipos de objeto sem suporte e selecione um nome do tipo objeto para abrir seus detalhes de descoberta.
  2. Examine os grupos aplicáveis a serem extraídos, excluídos e inválidos . Use os filtros de esquema e texto para encontrar um objeto e ler o motivo da exclusão ou da invalidez quando fornecido.
  3. Examine as permissões de origem e os esquemas dependentes para as dependências de esquema e de acesso de origem registradas. Contagens de referência de dependência não são contagens de objetos.
  4. Expanda Extração para examinar as contagens de Extraídos, Falha, Excluídos e Inválidos. Expanda objetos extraídos por tipo para examinar as definições recuperadas do Oracle por tipo de objeto.

Um objeto Excluído foi omitido da extração; esse status não estabelece que existe uma substituição no PostgreSQL. Uma contagem de extrações com Falha representa definições que não puderam ser recuperadas, e não a contagem Não convertidos da fase de conversão.

Examinar o ambiente e as informações de suporte

Use as seções restantes para compreender o contexto da execução e planejar o trabalho de acompanhamento:

Seção O que revisar
Ambiente Detalhes da origem, Destino (o banco de dados de validação de esquema usado para essa execução, não a prova de um destino de implantação posterior), extensões usadas pela Conversão de Esquema e configurações de LLM .
Próximas etapas – Configuração Diretrizes sobre conectividade de destino, permissões, esquemas e pré-requisitos de extensão antes da instalação.
Referências Links para a documentação pública, o CSV de mapeamento de objeto e o local do relatório.
Glossário Definições de status, taxas de conversão, contagens de pacotes e membros e outros termos de relatório.

Em Referências, abra object_mapping_summary.csv para tipos e nomes de objeto de origem e de destino, status registrados e ações necessárias. As entradas de mapeamento podem ser diferentes dos totais de objeto de relatório, portanto, não use a contagem de linhas CSV como o denominador de taxa de conversão.

Use Próximas Etapas – Configuração como a diretriz de preparação. O relatório em si não é um script de implantação.

Compartilhar o relatório

Mantenha o diretório de relatório unido para que os links relativos aos relatórios no nível do objeto continuem funcionando. Examine e compartilhe-o somente por meio de um local aprovado.

O diretório de relatório pode conter nomes de banco de dados e esquema, nomes de objeto, detalhes do ambiente e notas de conversão. Examine o conteúdo antes do compartilhamento, siga os requisitos de tratamento de dados da sua organização e remova credenciais ou segredos de qualquer coisa que você compartilhe.