As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Convertendo código SQL em seus aplicativos com AWS SCT
<a name="CHAP_Converting.App.Generic"></a>

Você pode usar AWS SCT para converter 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 [Código SQL em aplicativos C\$1](CHAP_Converting.App.Csharp.md), [Código SQL em Java](CHAP_Converting.App.Java.md) e [Código SQL no Pro\$1C](CHAP_Converting.App.ProC.md).

## Criação de projetos genéricos de conversão de aplicativos no AWS SCT
<a name="CHAP_Converting.App.Project"></a>

No AWS Schema Conversion Tool, o projeto de conversão do aplicativo é filho do projeto de conversão do esquema do 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**  
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
Serviços de integração do SQL Server 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. No AWS Schema Conversion Tool, escolha **Novo aplicativo genérico** no menu **Aplicativos**. 

   A caixa de diálogo **Novo projeto de conversão de aplicativo** será exibida.   
![\[A caixa de diálogo Novo projeto de conversão de aplicativo\]](http://docs.aws.amazon.com/pt_br/SchemaConversionTool/latest/userguide/images/applications-new-project.png)

1. Adicione as seguintes informações de projeto.   
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/SchemaConversionTool/latest/userguide/CHAP_Converting.App.Generic.html)

1. 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
   ```

1. 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, AWS SCT use 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.

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

   A janela do projeto será aberta.  
![\[A janela do projeto da\]](http://docs.aws.amazon.com/pt_br/SchemaConversionTool/latest/userguide/images/applications-project-window.png)

## Gerenciando projetos de conversão de aplicativos no AWS SCT
<a name="CHAP_Converting.App.Manage"></a>

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).

1. 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).

1. Escolha **New application** (Nova aplicação).

1. 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](#CHAP_Converting.App.Project).

## Analisando e convertendo seu código SQL em AWS SCT
<a name="CHAP_Converting.App.Convert"></a>

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**. 

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

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

1. Escolha **Converter** para converter o código SQL no painel **Script SQL extraído**. 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](#CHAP_Converting.App.Edit).  
![\[Código SQL a ser analisado\]](http://docs.aws.amazon.com/pt_br/SchemaConversionTool/latest/userguide/images/applications-project-analyze.png)

1. Quando você cria um relatório de avaliação de conversão de aplicativos, 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](#CHAP_Converting.App.AssessmentReport). 

## Criando e usando o relatório AWS SCT de avaliação no AWS SCT
<a name="CHAP_Converting.App.AssessmentReport"></a>

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 os itens de ação do código SQL que não AWS SCT podem ser convertidos. 

### Como criar um relatório de avaliação de conversão de aplicativos
<a name="CHAP_Converting.App.AssessmentReport.Create"></a>

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**. 

   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. 

1. 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.   
![\[Guia de resumo do relatório da avaliação de aplicativos\]](http://docs.aws.amazon.com/pt_br/SchemaConversionTool/latest/userguide/images/applications-summary.png)

1. Selecione **Ações de extração de SQL**. 

   Examine a lista de itens de código SQL que não AWS SCT podem ser extraídos do seu código-fonte. 

1. Selecione **Ações de conversão de SQL**. 

   Examine a lista de itens de código SQL que não AWS SCT podem ser convertidos 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 [Editando e salvando seu código SQL convertido com AWS SCT](#CHAP_Converting.App.Edit). 

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

## Editando e salvando seu código SQL convertido com AWS SCT
<a name="CHAP_Converting.App.Edit"></a>

O relatório de avaliação inclui uma lista de itens de código SQL que não AWS SCT podem ser convertidos. Para cada item, 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. 

1. 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. 

1. 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.