Revise os objetos convertidos no Conversion Object Explorer

Utilize o Conversion Object Explorer para rever e refinar os resultados de conversão Oracle-para-PostgreSQL. O explorador mostra os objetos de origem juntamente com os seus nomes, tipos e estados de destino. Cada objeto abre uma comparação source-to-target, com ações do Copilot para explicar a conversão ou ajudar a alterar o ficheiro PostgreSQL gerado.

Para instruções sobre como abrir o explorador a partir de uma conversão concluída, veja Rever e refinar objetos convertidos no tutorial.

Encontrar e inspecionar objetos

Utilize os filtros acima da tabela de resultados para restringir os objetos que pretende rever:

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

Leia o Schema, o tipo de origem e o objeto de origem juntos para identificar o objeto Oracle. Compare o objeto Target e o tipo Target para compreender o seu mapeamento PostgreSQL. A coluna Estado mostra o resultado de conversão do objeto, e Ações fornece Perguntar e Corrigir.

Utilize os controlos de página abaixo da tabela quando os resultados abrangem mais de uma página.

Captura de ecrã do Conversion Object Explorer a mostrar filtros de objetos, mapeamentos source-to-target, estados e ações de Perguntar e Corrigir.

Pacotes de revisão e outros objetos com múltiplas instruções

Pacotes e alguns outros objetos fonte podem produzir múltiplas instruções PostgreSQL. Expande o objeto pai para inspecionar as entradas associadas em vez de tratar a conversão como uma única instrução PostgreSQL.

Ver conteúdo do pacote

Utilize a hierarquia de pacotes para trabalhar com membros individuais e os respetivos equivalentes PostgreSQL:

  1. Localize o pacote usando os filtros de esquema e de nome do objeto de origem acima da tabela principal.
  2. Selecione o chevron ao lado do pacote para expandir as entradas de membro.
  3. Revise o mapeamento source-to-target de cada membro, incluindo o seu tipo de origem Oracle e o tipo de alvo PostgreSQL.
  4. Selecione o membro que pretende inspecionar e reveja a sua comparação entre origem e destino e as notas de conversão.

Revise os membros individualmente para compreender as alterações feitas em cada um. Uma vista ao nível do pacote ajuda a localizar os membros, mas não substitui a revisão das definições geradas.

Filtrar membros por tipo de objeto de origem

Para um pacote com muitos membros, use o filtro de tipo de objeto dentro do pacote expandido para focar num tipo de membro da fonte Oracle de cada vez. O filtro utiliza o tipo de origem Oracle do membro, não o seu tipo de alvo PostgreSQL.

Os dois filtros do tipo objeto servem propósitos diferentes:

Filtrar por localização O que ele filtra
Todos os tipos de objetos fonte acima da tabela principal Objetos de origem na lista principal de resultados.
Filtro de tipo objeto dentro de um pacote expandido Membros desse pacote por tipo de origem Oracle.

Após rever um tipo de membro, altere ou remova o filtro de tipo de membro para rever os restantes membros.

Expandir e recolher a hierarquia

Utilize os controlos expandir tudo e colapsar tudo ao nível que está a rever:

Level Purpose
Explorer Expandir ou colapsar, em conjunto, objetos expansíveis no Explorador.
Package Expandir ou recolher os membros dentro desse pacote juntos.

Usa o chevron de um objeto expansível quando só quiseres expandir ou colapsar esse objeto.

Compare as definições e leia as notas de conversão

Selecione um objeto para abrir a sua vista de diferenças. A definição do Oracle aparece à esquerda, e a definição gerada do PostgreSQL aparece à direita. Revise a comparação para compreender alterações a nomes, tipos, parâmetros e construtos específicos da base de dados.

Leia o painel de notas de conversão juntamente com as definições. As notas fornecem contexto sobre a conversão e as diferenças que exigem a tua atenção. Revê-os tanto para ver se há objetos convertidos, bem como os objetos que precisam de correção.

Captura de ecrã de uma vista diferencial Oracle-para-PostgreSQL com a definição de origem, definição gerada e painel de notas de conversão.

Pedir ao Copilot para explicar uma conversão

Selecione Pedir para um objeto para pedir ao GitHub Copilot que explique a sua conversão, incluindo as suas dependências. Utilize a explicação juntamente com a vista de diferenças e as notas de conversão para perceber como a definição do PostgreSQL se relaciona com a fonte Oracle.

Revise a explicação do Copilot em relação às definições e aos requisitos da sua aplicação antes de fazer alterações.

Corrigir um objeto e compilar alterações

Fix abre um pedido ao Copilot com os detalhes do objeto. O Copilot usa esse contexto para ajudar a fazer alterações ao ficheiro PostgreSQL. Revise as edições resultantes antes de as compilar.

Podes editar os ficheiros gerados antes da implementação. Para compilação manual, utilize uma base de dados não produtiva e confirme que os esquemas e dependências necessários estão disponíveis. Se precisares de preparar essa base de dados, consulta a Setup Experience.

Para corrigir e compilar manualmente um objeto nessa base de dados não produtiva:

  1. Seleciona Fix para o objeto que queres alterar.
  2. Trabalhe com o Copilot para fazer as correções necessárias e reveja a definição atualizada do PostgreSQL.
  3. Abra o ficheiro PostgreSQL editado no editor SQL.
  4. Ligue o editor SQL ao servidor PostgreSQL não produtivo.
  5. Liga-te à base de dados desse servidor onde o esquema convertido é implementado. Confirma a base de dados ativa do editor.
  6. Revise as referências de esquema no SQL e selecione a instrução completa ou instruções que pretende executar.
  7. Selecione o botão play no editor SQL para executar as instruções selecionadas e compilar os objetos. Também pode executar a seleção com Executar Consulta PostgreSQL.
  8. Revise a saída da execução. Corrija quaisquer erros reportados e execute novamente a definição atualizada conforme necessário.

O comando Execute PostgreSQL Query do editor SQL executa o texto selecionado. Se não for selecionado texto, executa todo o conteúdo do editor. Quando um ficheiro contém definições para múltiplos membros convertidos, selecione instruções completas para evitar executar definições não relacionadas sem querer.

Editar um ficheiro e compilá-lo na base de dados são passos separados. Use os resultados da execução para determinar se a definição atualizada foi aplicada. Confirme que o SQL de implementação gerado inclui as correções testadas antes da implementação em produção; não presuma que editar um ficheiro por objeto atualiza deploy.sql.

Para os passos para ligar o editor, selecionar uma base de dados e executar SQL, consulte Editor de Consultas e IntelliSense.

Validar para além da compilação

Uma compilação bem-sucedida não estabelece que o objeto convertido se comporta da mesma forma que a sua origem Oracle. Antes da implementação em produção, teste-se de forma independente o tratamento de dados, a lógica de negócio, as dependências e o comportamento da aplicação com o esquema convertido.