Como converter o código SQL em aplicativos Pro*C com a AWS SCT

Para uma conversão de Oracle para PostgreSQL, você pode usar a AWS Schema Conversion Tool (AWS SCT) para converter o código SQL incorporado em aplicativos Pro*C. Esse conversor de aplicativos Pro*C específico compreende a lógica do aplicativo. Ele coleta instruções que estão localizadas em diferentes objetos do aplicativo, como perfis, parâmetros, variáveis locais e assim por diante.

Devido a essa análise profunda, o conversor de código SQL do aplicativo Pro*C fornece melhores resultados de conversão do que o conversor genérico.

Como criar projetos de conversão de aplicativos Pro*C na AWS SCT

Você pode criar um projeto de conversão de aplicativos Pro*C somente para converter esquemas de banco de dados Oracle em esquemas de banco de dados PostgreSQL. Certifique-se de adicionar uma regra de mapeamento em seu projeto que inclua um esquema Oracle de origem e um banco de dados PostgreSQL de destino. Para obter mais informações, consulte Criação de regras de mapeamento na AWS SCT.

Você pode adicionar vários projetos de conversão de aplicativos em um único projeto de AWS SCT. Use o procedimento a seguir para criar um projeto de conversão de aplicativos Pro*C.

Para criar um projeto de conversão de aplicativos Pro*C

1. Crie um projeto de conversão de banco de dados e adicione um banco de dados Oracle de origem. Para obter mais informações, consulte Criando um projeto da AWS SCT e Adicionando servidores de banco de dados a um projeto da AWS SCT.

2. Adicione uma regra de mapeamento que inclua seu banco de dados Oracle de origem e um banco de dados PostgreSQL de destino. Você pode adicionar um banco de dados PostgreSQL de destino ou usar uma plataforma de banco de dados de destino PostgreSQL virtual em uma regra de mapeamento. Para obter mais informações, consulte Criação de regras de mapeamento na AWS SCT e Usar alvos virtuais.

3. No menu Exibir, selecione Visualização principal.

4. No menu Aplicativos, selecione Novo aplicativo Pro*C.

   A caixa de diálogo Como criar um projeto de conversão de aplicativos Pro*C será exibida.

   

5. Em Nome, digite um nome para o seu projeto de conversão de aplicativos Pro*C. Como cada projeto de conversão de esquema de banco de dados pode ter um ou mais projetos de conversão de aplicativos filho, escolha um nome que faça sentido se você adicionar vários projetos.

6. Em Local, digite o local do código fonte referente ao aplicativo.

7. Na árvore de origem, escolha o esquema que seu aplicativo usa. Certifique-se de que esse esquema faça parte de uma regra de mapeamento. A AWS SCT destaca os esquemas que fazem parte de uma regra de mapeamento em negrito.

8. Selecione OK para criar um projeto de conversão de aplicativos Pro*C.

9. Encontre seu projeto de conversão de aplicativos Pro*C no nó Aplicativos no painel esquerdo.

Como converter o código SQL em seu aplicativo Pro*C na AWS SCT

Depois de adicionar seu aplicativo Pro*C ao projeto AWS SCT, converta o código SQL desse aplicativo em um formato compatível com sua plataforma de banco de dados de destino. Use o procedimento a seguir para analisar e converter o código SQL incorporado em seu aplicativo Pro*C na AWS Schema Conversion Tool.

Para converter seu código SQL

1. Expanda o nó Pro*C em Aplicativos no painel esquerdo.

2. Selecione o aplicativo a ser convertido e selecione Configurações.

   1. Em Caminho do arquivo de cabeçalho global, insira o caminho para os arquivos de cabeçalho que seu projeto de aplicativo usa.

   2. Selecione Interpretar todas as variáveis não resolvidas do host para ver todas as variáveis não resolvidas no código convertido.

   3. Selecione Usar função de conversão de cadeia de caracteres de largura fixa do pacote de extensão para usar as funções do pacote de extensão no código SQL convertido. A AWS SCT inclui os arquivos do pacote de extensão no projeto do seu aplicativo.

   4. Selecione Transformar blocos PL/SQL anônimos em chamadas SQL autônomas ou perfis armazenados para criar procedimentos armazenados em seu banco de dados de destino para todos os blocos PL/SQL anônimos. A AWS SCT então inclui as execuções desses procedimentos armazenados no código do aplicativo convertido.

   5. Selecione Usar fluxo de cursor personalizado para melhorar a conversão dos cursores do banco de dados Oracle.

3. No painel esquerdo, selecione o aplicativo a ser convertido e abra o menu de contexto (clique com o botão direito).

4. Selecione Converter. A AWS SCT analisa seus arquivos de código fonte, determina a lógica do aplicativo e carrega os metadados do código no projeto. Esses metadados de código incluem classes, objetos, métodos, variáveis globais, interfaces em Pro*C e assim por diante.

   No painel do banco de dados de destino, a AWS SCT cria a estrutura de pastas semelhante ao seu projeto de aplicativo de origem. Aqui você pode revisar o código do aplicativo convertido.

   

5. Salve o código do seu aplicativo convertido. Para obter mais informações, consulte Como editar e salvar o código do aplicativo convertido.

Como editar e salvar o código do aplicativo convertido com a AWS SCT

Você pode editar as instruções SQL convertidas e usar a AWS SCT para incorporar esse código editado no código do aplicativo Pro*C convertido. Use o procedimento a seguir para editar seu código SQL convertido.

Para editar seu código SQL convertido

1. Expanda o nó Pro*C em Aplicativos no painel esquerdo.

2. Selecione o aplicativo a ser convertido, abra o menu de contexto (clique com o botão direito) e selecione Converter.

3. No menu Exibir, selecione Visualização do relatório de avaliação.

4. Selecione Salvar instruções em CSV para salvar o código SQL extraído do seu aplicativo Pro*C como um arquivo CSV.

5. Insira o nome do arquivo CSV para salvar o código SQL extraído e escolha selecione Salvar.

6. Edite o código SQL extraído.

7. No menu Exibir, selecione Visualização principal.

8. Expanda o nó Pro*C em Aplicativos no painel do banco de dados de destino.

9. Escolha seu aplicativo convertido, abra o menu de contexto (clique com o botão direito) e selecione Importar instruções do CSV.

10. Selecione Sim, depois escolha o arquivo com seu código SQL editado e selecione Abrir.

A AWS SCT divide as instruções SQL convertidas em partes e as coloca nos objetos apropriados do código fonte do aplicativo. Use o procedimento a seguir para salvar o código do seu aplicativo convertido.

Para salvar o código do seu aplicativo convertido

1. Expanda o nó Pro*C em Aplicativos no painel do banco de dados de destino.

2. Escolha seu aplicativo convertido e selecione Salvar.

3. Insira o caminho para a pasta para salvar o código do aplicativo convertido e escolha Selecionar pasta.

Como gerenciar projetos de conversão de aplicativos Pro*C na AWS SCT

Você pode adicionar vários projetos de conversão de aplicativos Pro*C, atualizar o código do aplicativo no projeto da AWS SCT ou remover um projeto de conversão em Pro*C do seu projeto da AWS SCT.

Para adicionar um projeto adicional de conversão de aplicativos Pro*C

1. Expanda o nó Aplicativos no painel esquerdo.

2. Escolha o nó Pro*C e abra o menu de contexto (clique com o botão direito).

3. Escolha New application (Nova aplicação).

4. Insira as informações necessárias para criar um novo projeto de conversão de aplicativos Pro*C. Para obter mais informações, consulte Como criar projetos de conversão de aplicativos Pro*C.

Depois de fazer alterações no código fonte do aplicativo, carregue-o no projeto da AWS SCT.

Para carregar o código do aplicativo atualizado

1. Expanda o nó Pro*C em Aplicativos no painel esquerdo.

2. Selecione o aplicativo a ser atualizado e abra o menu de contexto (clique com o botão direito).

3. Selecione Atualizar e, em seguida, selecione Sim.

   A AWS SCT carrega o código do aplicativo dos arquivos de origem e remove os resultados da conversão. Para manter as alterações no código que você fez na AWS SCT e os resultados da conversão, crie um novo projeto de conversão em Pro*C.

Para remover um projeto de conversão de aplicativos Pro*C

1. Expanda o nó Pro*C em Aplicativos no painel esquerdo.

2. Selecione o aplicativo a ser removido e abra o menu de contexto (clique com o botão direito).

3. Selecione Excluir e OK.

Como criar um relatório de avaliação de conversão de aplicativos Pro*C na AWS SCT

O Relatório de avaliação da conversão do aplicativo Pro*C fornece informações sobre como converter o código SQL incorporado em seu aplicativo Pro*C para um formato compatível com seu banco de dados de destino. O relatório de avaliação fornece detalhes de conversão para todos os pontos de execução do SQL e todos os arquivos de código fonte. O relatório de avaliação também inclui também inclui itens de ação para código SQL que a AWS SCT não pode converter.

Use o procedimento a seguir para criar um relatório de avaliação de aplicativos Pro*C.

Para criar um relatório de avaliação de conversão de aplicativos Pro*C

1. Expanda o nó Pro*C em Aplicativos no painel esquerdo.

2. Selecione o aplicativo a ser convertido e abra o menu de contexto (clique com o botão direito).

3. Selecione Converter.

4. No menu Exibir, selecione Visualização do relatório de avaliação.

5. Analise a guia Resumo.

   A guia Resumo mostrada a seguir exibe as informações do resumo executivo do relatório de avaliação de aplicativos Pro*C. Ele mostra os resultados da conversão para todos os pontos de execução do SQL e todos os arquivos de código fonte.

   

6. Selecione Salvar instruções em CSV para salvar o código SQL extraído do seu aplicativo Pro*C como um arquivo de valores separados por vírgulas (CSV).

7. (Opcional) Salve uma cópia local do relatório como um arquivo PDF ou um arquivo de valores separados por vírgula (CSV):

   • Selecione Salvar em PDF no canto superior direito para salvar o relatório como um arquivo PDF.

     O arquivo PDF contém o resumo executivo, os itens de ação e as recomendações para a conversão do aplicativo.

   • Selecione Salvar em CSV no canto superior direito para salvar o relatório como um arquivo CSV.

     O arquivo CSV contém itens de ação, ações recomendadas e uma complexidade estimada do esforço manual necessário para converter o código SQL.