Examinar objetos convertidos no Pesquisador de Objetos de Conversão

Use Pesquisador de Objetos de Conversão para examinar e refinar os resultados da conversão do Oracle no PostgreSQL. O explorer mostra objetos de origem com nomes, tipos e status de destino. Cada objeto abre uma comparação de origem para destino, com ações Copilot para explicar a conversão ou ajudar a alterar o arquivo PostgreSQL gerado.

Para obter instruções sobre como abrir o explorer de uma conversão concluída, consulte Examinar e refinar objetos convertidos no tutorial.

Localizar e inspecionar objetos

Use os filtros acima da tabela de resultados para restringir os objetos que convém examinar:

Controle Purpose
Filtrar pelo nome do objeto de origem Localize um objeto pelo nome de origem Oracle.
Todos os esquemas Restringir os resultados a um esquema de origem.
Todos os tipos de objeto de origem Restringir os resultados por tipo de objeto Oracle.
Todos os status Restringir os resultados pelos status disponíveis para a conversão.

Leia Schema, tipo de origem e objeto de origem juntos para identificar o objeto Oracle. Compare o objeto de destino e o tipo de destino para compreender o mapeamento do PostgreSQL. A coluna Status mostra o resultado da conversão do objeto, e Ações indica Perguntar e Corrigir.

Use os controles de página abaixo da tabela quando os resultados abrangem mais de uma página.

Captura de tela do Pesquisador de Objetos de Conversão mostrando filtros de objeto, mapeamentos de origem para destino, status e ações Perguntar e Corrigir.

Examinar pacotes e outros objetos com várias instruções

Pacotes e alguns outros objetos de origem podem produzir várias instruções PostgreSQL. Expanda o objeto pai para inspecionar as entradas associadas em vez de tratar a conversão como uma única instrução PostgreSQL.

Inspecionar membros de pacote

Use a hierarquia de pacotes para trabalhar com membros individuais e os respectivos equivalentes do PostgreSQL:

  1. Localize o pacote usando os filtros de nome de objeto de origem e esquema acima da tabela principal.
  2. Selecione a divisa próxima do pacote para expandir as entradas dos membros.
  3. Examine o mapeamento de origem para destino de cada membro, incluindo o tipo de origem Oracle e o tipo de destino PostgreSQL.
  4. Selecione o membro que você deseja inspecionar e examine suas notas de conversão e comparação de origem para destino.

Examine os membros individualmente para entender as alterações feitas para cada um deles. Uma exibição no nível do pacote ajuda você a localizar os membros, mas não substitui a revisão de suas definições geradas.

Filtrar membros por tipo de objeto de origem

Para um pacote com muitos membros, use o filtro do tipo objeto dentro do pacote expandido para se concentrar em um tipo de membro de origem Oracle de cada vez. O filtro usa o tipo de origem Oracle do membro, não seu tipo de destino PostgreSQL.

Os dois filtros de tipo de objeto servem a diferentes finalidades:

Filtrar local O que ele filtra
Todos os tipos de objeto de origem acima da tabela principal Objetos de origem na lista de resultados principais.
Filtro de tipo de objeto dentro de um pacote expandido Membros desse pacote por tipo de origem Oracle.

Depois de examinar um tipo de membro, altere ou remova o filtro do tipo membro para examinar os membros restantes.

Expandir e recolher a hierarquia

Use os controles para expandir tudo e recolher tudo no nível que você está examinando:

Level Purpose
Explorer Expanda ou recolha objetos expansíveis em todo o explorer juntos.
Package Expanda ou recolha membros dentro desse pacote juntos.

Use a divisa de um objeto expansível quando você só quiser expandir ou recolhê-lo.

Comparar definições e ler notas de conversão

Selecione um objeto para abrir sua visualização de diff. A definição do Oracle é exibida à esquerda e a definição de PostgreSQL gerada é exibida à direita. Analise a comparação para entender as alterações em nomes, tipos, parâmetros e construções específicas do banco de dados.

Leia o painel de anotações de conversão junto com as definições. As anotações fornecem contexto sobre a conversão e as diferenças que precisam de sua atenção. Examine-os quanto aos objetos convertidos, bem como aos objetos que precisam de correção.

Captura de tela de uma exibição de comparação Oracle-to-PostgreSQL com a definição de origem, a definição gerada e o painel de notas de conversão.

Peça ao Copilot para explicar uma conversão

Selecione Perguntar para um objeto a fim de pedir para o GitHub Copilot explicar a conversão, inclusive as dependências. Use a explicação com as notas de conversão e exibição de diferenciação para compreender como a definição do PostgreSQL se relaciona com a fonte do Oracle.

Examine a explicação do Copilot em relação às definições e aos requisitos do aplicativo antes de fazer alterações.

Corrigir um objeto e compilar as alterações

Fix abre um prompt do Copilot com os detalhes do objeto. Copilot usa esse contexto para ajudar a fazer alterações no arquivo PostgreSQL. Examine as edições resultantes antes de compilá-las.

Você pode editar os arquivos gerados antes da implantação. Para compilação manual, use um banco de dados de não produção e confirme se os esquemas e dependências necessários estão disponíveis. Se você precisar preparar esse banco de dados, consulte a Setup Experience.

Para corrigir e compilar manualmente um objeto nesse banco de dados de não produção:

  1. Selecione Corrigir para o objeto que convém alterar.
  2. Trabalhe com Copilot para fazer as correções necessárias e examine a definição atualizada do PostgreSQL.
  3. Abra o arquivo PostgreSQL editado no editor do SQL.
  4. Conecte o editor do SQL ao servidor PostgreSQL não produtivo.
  5. Conecte-se ao banco de dados nesse servidor em que o esquema convertido está implantado. Confirme o banco de dados ativo do editor.
  6. Examine as referências de esquema no SQL e selecione a instrução ou as instruções completas que você deseja executar.
  7. Selecione o botão Executar no editor do SQL para executar as instruções selecionadas e compilar os objetos. Você também pode executar a seleção com Executar Consulta do PostgreSQL.
  8. Examine a saída de execução. Corrija os erros relatados e execute a definição atualizada novamente conforme necessário.

O comando Execute PostgreSQL Query do editor SQL executa o texto selecionado. Se nenhum texto for selecionado, ele executará todo o conteúdo do editor. Quando um arquivo contiver definições para vários membros convertidos, selecione instruções completas para evitar a execução não intencional de definições não relacionadas.

Editar um arquivo e compilá-lo no banco de dados são etapas separadas. Use os resultados de execução para determinar se a definição atualizada foi aplicada. Confirme que o SQL de implantação gerado inclui as correções testadas antes da implantação em produção; não presuma que editar um arquivo por objeto atualize deploy.sql.

Para ver as etapas para se conectar pelo editor, selecionar um banco de dados e executar SQL, consulte Editor de Consultas e IntelliSense.

Validar além da compilação

A compilação bem-sucedida não estabelece que o objeto convertido se comporta da mesma forma que o código-fonte do Oracle. Antes da implantação em produção, realize testes independentes do tratamento de dados, da lógica de negócio, das dependências e do comportamento da aplicação com o esquema convertido.

Conteúdo relacionado

  • Última atualização em