Como converter o código SQL em seus aplicativos com a AWS SCT

Você pode usar AWS SCT para converter o código SQL incorporado em seus aplicativos. O conversor genérico do aplicativo da AWS SCT trata o código do aplicativo como texto simples. Ele escaneia o código do seu aplicativo e extrai o código SQL com expressões regulares. Esse conversor suporta diferentes tipos de arquivos de código fonte e funciona com código de aplicativo escrito em qualquer linguagem de programação.

O conversor de aplicativo genérico tem as limitações a seguir. Ele não se aprofunda na lógica do aplicativo que é específica para a linguagem de programação do seu aplicativo. Além disso, o conversor genérico não oferece suporte a instruções SQL de diferentes objetos do aplicativo, como funções, parâmetros, variáveis locais e assim por diante.

Para melhorar a conversão de código SQL do seu aplicativo, use conversores de código SQL de aplicativo específicos da linguagem. Para obter mais informações, consulte Como converter o código SQL em aplicativos C#, Como converter o código SQL em aplicativos Java e Como converter o código SQL em aplicativos Pro*C.

Como criar projetos genéricos de conversão de aplicativos em na AWS SCT

Na AWS Schema Conversion Tool, o projeto de conversão do aplicativo é filho do projeto de conversão do esquema de banco de dados. Cada projeto de conversão de esquema de banco de dados pode ter um ou mais projetos de aplicativos de conversão do esquema de banco de dados filho.

nota

A AWS SCT não oferece suporte à conversão entre as seguintes fontes e destinos:

• Oracle para Oracle

• PostgreSQL para PostgreSQL ou Aurora PostgreSQL

• MySQL para MySQL

• SQL Server para SQL Server

• Amazon Redshift para (Amazon Redshift)

• SQL Server para Babelfish

• SQL Server Integration Services para AWS Glue

• Apache Cassandra para o Amazon DynamoDB

Use o procedimento a seguir para criar um projeto genérico de conversão de aplicativos.

Para criar um projeto de conversão de aplicativos

1. Na AWS Schema Conversion Tool, selecione Novo aplicativo genérico no menu Aplicativos.

   A caixa de diálogo Novo projeto de conversão de aplicativo será exibida.

   

2. Adicione as seguintes informações de projeto.

   Para este parâmetro	Faça o seguinte
   Nome	Digite um nome para o seu projeto de conversão de aplicativos. Cada projeto de conversão de esquema de banco de dados pode ter um ou mais projetos de conversão de aplicativos filho, portanto, escolha um nome que faça sentido se você adicionar mais projetos mais tarde.
   Local	Digite o local do código-fonte referente ao aplicativo.
   Linguagem	Escolha uma das seguintes opções: Java C++ C# Quaisquer
   Estilo do parâmetro de destino	Escolha a sintaxe a ser usada para vincular variáveis no código convertido. Plataformas de banco de dados diferentes usam sintaxe diferente para variáveis de vinculação. Escolha uma das seguintes opções: O mesmo da origem Posicional (?) Indexado (:1) Indexado ($1) Nomeadas (@ nome) Nomeadas (: nome) Nomeadas (&nome) Nomeadas ($nome) Nomeadas (#nome) Nomeadas (!nome!)
   Escolha o esquema do banco de dados de origem	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.

3. Selecione Não converter variáveis de ligação em tipos SQL para evitar a conversão de tipos de variáveis de ligação em tipos SQL. Essa opção só está disponível para uma conversão de Oracle para PostgreSQL.

   Por exemplo, o código fonte do aplicativo inclui a seguinte consulta Oracle:

   SELECT * FROM ACCOUNT WHERE id = ?

   Quando você seleciona Não converter variáveis de ligação em tipos SQL, a AWS SCT converte essa consulta conforme mostrado a seguir.

   SELECT * FROM account WHERE id = ?

   Quando você desmarca Não converter variáveis de ligação em tipos SQL, a AWS SCT altera o tipo de variável de associação para o tipo de dados NUMERIC. O resultado da conversão é mostrado a seguir.

   SELECT * FROM account WHERE id = (?)::NUMERIC

4. Selecione Manter nomes de objetos para evitar adicionar o nome do esquema ao nome do objeto convertido. Essa opção só está disponível para uma conversão de Oracle para PostgreSQL.

   Por exemplo, suponha que o código do seu aplicativo fonte inclua a seguinte consulta Oracle.

   SELECT * FROM ACCOUNT

   Quando você seleciona Manter nomes de objetos, a AWS SCT converte essa consulta conforme mostrado a seguir.

   SELECT * FROM account

   Quando você desmarca Manter nomes de objetos, a AWS SCT adiciona o nome do esquema ao nome da tabela. O resultado da conversão é mostrado a seguir.

   SELECT * FROM schema_name.account

   Se o código fonte incluir os nomes dos objetos principais nos nomes dos objetos, a AWS SCT usa esse formato no código convertido. Nesse caso, ignore a opção Manter nomes de objetos porque a AWS SCT adiciona os nomes dos objetos principais no código convertido.

5. Selecione OK para criar um projeto de conversão de aplicativos.

   A janela do projeto será aberta.

   

Como gerenciar projetos de conversão de aplicativos na AWS SCT

Você pode abrir um projeto de conversão de aplicativos existente e adicionar vários projetos de conversão de aplicativos.

Depois que você criar um projeto de conversão de aplicativo, a janela de projeto do projeto de conversão se abrirá automaticamente. Você pode fechar a janela do projeto de conversão do aplicativo e voltar a ela mais tarde.

Para abrir um projeto de conversão de aplicativos existente

1. No painel esquerdo, escolha o nó do projeto de conversão do aplicativo e abra o menu de contexto (clique com o botão direito do mouse).

2. Escolha Gerenciar aplicativo.

Para adicionar um projeto adicional de conversão de aplicativos

1. No painel esquerdo, escolha o nó do projeto de conversão do aplicativo e abra o menu de contexto (clique com o botão direito do mouse).

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

3. Insira as informações necessárias para criar um novo projeto de conversão de aplicativos. Para obter mais informações, consulte Como criar projetos genéricos de conversão de aplicativos.

Como analisar e converter seu código SQL na AWS SCT

Use o procedimento a seguir para analisar e converter seu código SQL na AWS Schema Conversion Tool.

Para analisar e converter seu código SQL

1. Abra um projeto de conversão de aplicativo existente e selecione Analisar.

   A AWS SCT analisa o código do aplicativo e extrai o código SQL. A AWS SCT exibe o código SQL extraído na lista de Scripts SQL analisados.

2. Para Scripts SQL analisados, escolha um item para revisar o código SQL extraído. A AWS SCT exibe o código do item selecionado no painel Script SQL extraído.

3. Escolha Converter para converter o código SQL no painel Script SQL extraído. A AWS SCT converte o código em um formato compatível com seu banco de dados de destino.

   Você pode editar o código SQL convertido. Para obter mais informações, consulte Como editar e gravar seu código SQL convertido.

   

4. Quando você cria um relatório de avaliação de conversão de aplicativos, a AWS SCT converte todos os itens de código SQL extraídos. Para obter mais informações, consulte Como criar e usar o relatório de avaliação.

Como criar e usar o relatório de avaliação da AWS SCT na AWS SCT

O relatório de avaliação da conversão do aplicativo fornece informações sobre a conversão do código SQL do aplicativo em um formato compatível com seu banco de dados de destino. O relatório detalha todo o código SQL extraído, todo o código SQL convertido e itens de ação para o código SQL que a AWS SCT não pode converter.

Como criar um relatório de avaliação de conversão de aplicativos

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

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

1. Na janela do projeto de conversão do aplicativo, selecione Criar relatório no menu Ações.

   A AWS SCT cria o relatório de avaliação da conversão do aplicativo e o abre na janela do projeto de conversão do aplicativo.

2. Analise a guia Resumo.

   A guia Resumo mostrada a seguir exibe as informações de resumo do relatório de avaliação de aplicativos. Ela mostra os códigos SQL que foram convertidos automaticamente e os itens que não foram convertidos automaticamente.

   

3. Selecione Ações de extração de SQL.

   Examine a lista de itens de código SQL que a AWS SCT não pode extrair do seu código fonte.

4. Selecione Ações de conversão de SQL.

   Examine a lista de itens de código SQL que a AWS SCT não pode converter automaticamente. Use as ações recomendadas para converter manualmente o código SQL. Para obter informações sobre como converter o código SQL, consulte Como editar e gravar seu código SQL convertido com a AWS SCT.

5. (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.

Como editar e gravar seu código SQL convertido com a AWS SCT

O relatório de avaliação inclui uma lista de itens do código SQL que a AWS SCT não pode converter. Para cada item, a AWS SCT cria um item de ação na guia de Ações de conversão de SQL. Para esses itens, é possível editar o código SQL manualmente para executar a conversão.

Use o procedimento a seguir para editar seu código de SQL convertido, aplicar as alterações e, em seguida, salvá-los.

Para editar, aplicar alterações e salvar o código SQL convertido

1. Edite seu código de SQL convertido diretamente no painel Script SQL de destino. Se não houver códigos convertidos mostrados, você pode clicar no painel e começar a digitar.

2. Após concluir as edições do SQL convertido do seu código, escolha Aplicar. Neste momento, as alterações serão salvas na memória, mas ainda não serão gravados em seu arquivo.

3. Selecione Salvar para salvar as alterações no arquivo.

   Ao selecionar Salvar, o arquivo original será substituído. Faça uma cópia do arquivo original antes de salvar, para que você tenha um registro de seu código de aplicativo original.