Como converter o código SQL em aplicativos C# com a AWS Schema Conversion Tool - AWS Schema Conversion Tool

Como converter o código SQL em aplicativos C# com a AWS Schema Conversion Tool

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 C#. Esse conversor de aplicativos 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 C# fornece melhores resultados de conversão do que o conversor genérico.

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

Você pode criar um projeto de conversão de aplicativos 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 ter mais informações, consulte Mapear tipo de dados no AWS Schema Conversion Tool.

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 C#.

Para criar um projeto de conversão de aplicativos C#
  1. Crie um projeto de conversão de banco de dados e adicione um banco de dados Oracle de origem. Para ter mais informações, consulte Como iniciar e gerenciar projetos no AWS SCT e Adicionar servidores ao projeto no 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 ter mais informações, consulte Mapear tipo de dados no AWS Schema Conversion Tool e Mapeamento para alvos virtuais no AWS Schema Conversion Tool.

  3. No menu Visualizar, escolha Visualização principal.

  4. No menu Aplicativos, selecione Novo aplicativo C#.

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

    A caixa de diálogo do novo projeto de conversão de aplicativos C#
  5. Em Nome, digite um nome para o seu projeto de conversão de aplicativos 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 C#.

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

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

Depois de adicionar seu aplicativo 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 C# na AWS Schema Conversion Tool.

Para converter seu código SQL
  1. Expanda o nó 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. 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 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.

    Código SQL a ser analisado
  4. Salve o código do seu aplicativo convertido. Para ter mais informações, consulte Como salvar o código do aplicativo convertido.

Seus aplicativos C# podem incluir código SQL que interage com diferentes bancos de dados de origem. Você pode migrar para o PostgreSQL vários desses bancos de dados de origem. Nesse caso, certifique-se de não converter o código SQL que interage com bancos de dados que você excluiu do escopo da migração. Você pode excluir os arquivos de origem do seu aplicativo C# do escopo da conversão. Para fazer isso, desmarque as caixas de seleção dos nomes dos arquivos que você deseja excluir do escopo da conversão.

Depois de alterar o escopo da conversão, a AWS SCT ainda analisa o código SQL de todos os arquivos de origem de seus aplicativos C#. Em seguida, a AWS SCT copia para a pasta de destino todos os arquivos de origem que você excluiu do escopo da conversão. Essa operação possibilita a criação do aplicativo depois de salvar os arquivos convertidos do aplicativo.

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

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ó 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 C# na AWS SCT

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

Para adicionar um projeto adicional de conversão de aplicativos C#
  1. Expanda o nó Aplicativos no painel esquerdo.

  2. Escolha o nó 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 C#. Para ter mais informações, consulte Como criar projetos de conversão de aplicativos 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ó 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 C#.

Para remover um projeto de conversão de aplicativos C#
  1. Expanda o nó 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 C# na AWS SCT

O Relatório de avaliação da conversão do aplicativo C# fornece informações sobre como converter o código SQL incorporado em seu aplicativo 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 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 conversão de aplicativos C#.

Para criar um relatório de avaliação de conversão de aplicativos C#
  1. Expanda o nó 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. Visualize a guia Resumo.

    A guia Resumo mostrada a seguir exibe as informações do resumo executivo do relatório de avaliação de aplicativos 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.

    Guia de resumo do relatório da avaliação de aplicativos C#
  6. Selecione Salvar instruções em JSON para salvar o código SQL extraído do seu aplicativo C# como um arquivo JSON.

  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.