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 o SQL do aplicativo usando AWS SCT
Ao converter o esquema do seu banco de dados de um mecanismo para outro, é preciso também atualizar o código SQL nos seus aplicativos, a fim de interagir com o novo mecanismo de banco de dados, em vez do antigo. Você pode visualizar, analisar, editar e salvar o código SQL convertido.
Você pode usar o AWS Schema Conversion Tool (AWS SCT) para converter o código SQL em seu C\$1\$1, C\$1, Java ou outro código de aplicativo. Para uma conversão de Oracle para PostgreSQL, você pode AWS SCT usar para converter o código SQL\$1Plus em PSQL. Além disso, para uma conversão de Oracle para PostgreSQL, você pode usar a AWS SCT para converter o código SQL incorporado em aplicativos C\$1, C\$1\$1, Java e Pro\$1C.
**Topics**
+ [
## Visão geral da conversão de aplicativos SQL
](#CHAP_Converting.App.Overview)
+ [
# Convertendo código SQL em seus aplicativos com AWS SCT
](CHAP_Converting.App.Generic.md)
+ [
# Convertendo código SQL em aplicativos C\$1 com AWS Schema Conversion Tool
](CHAP_Converting.App.Csharp.md)
+ [
# Convertendo código SQL em aplicativos C\$1\$1 com AWS Schema Conversion Tool
](CHAP_Converting.App.Cplusplus.md)
+ [
# Convertendo código SQL em aplicativos Java com AWS Schema Conversion Tool
](CHAP_Converting.App.Java.md)
+ [
# Convertendo código SQL em aplicativos Pro\$1C com AWS Schema Conversion Tool
](CHAP_Converting.App.ProC.md)
## Visão geral da conversão de aplicativos SQL
Para converter o código SQL em seu aplicativo, siga as etapas de alto nível a seguir:
+ **Crie um projeto de conversão de aplicativos**: O projeto de conversão de aplicativos é filho do projeto de conversão de 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. Para obter mais informações, consulte [Criação de projetos genéricos de conversão de aplicativos no AWS SCT](CHAP_Converting.App.Generic.md#CHAP_Converting.App.Project).
+ **Analise e converta o código SQL**: A AWS SCT analisa seu aplicativo, extrai o código SQL e cria uma versão local do SQL convertido para você analisar e editar. A ferramenta não altera o código em seu aplicativo até que você esteja pronto. Para obter mais informações, consulte [Analisando e convertendo seu código SQL em AWS SCT](CHAP_Converting.App.Generic.md#CHAP_Converting.App.Convert).
+ **Crie um relatório de avaliação do aplicativo**: O relatório de avaliação do aplicativo fornece informações importantes sobre a conversão do código do aplicativo SQL do seu esquema de banco de dados de origem para o esquema de banco de dados de destino. Para obter mais informações, consulte [Criando e usando o relatório AWS SCT de avaliação no AWS SCT](CHAP_Converting.App.Generic.md#CHAP_Converting.App.AssessmentReport).
+ **Edite, aplique alterações e salve o código SQL convertido**: O relatório de avaliação inclui uma lista de itens de códigos SQL que não podem ser convertidos automaticamente. Para esses itens, é possível editar o código SQL manualmente para executar a conversão. Para obter mais informações, consulte [Editando e salvando seu código SQL convertido com AWS SCT](CHAP_Converting.App.Generic.md#CHAP_Converting.App.Edit).
# Convertendo código SQL em seus aplicativos com AWS SCT
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
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
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
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
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
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
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.
# Convertendo código SQL em aplicativos C\$1 com AWS Schema Conversion Tool
Para uma conversão de Oracle para PostgreSQL, você pode AWS Schema Conversion Tool usar AWS SCT() para converter código SQL incorporado em seus aplicativos C\$1. Esse conversor de aplicativos C\$1 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\$1 fornece melhores resultados de conversão do que o conversor genérico.
## Criação de projetos de conversão de aplicativos C\$1 em AWS SCT
Você pode criar um projeto de conversão de aplicativos C\$1 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 [Mapear tipo de dados no AWS Schema Conversion Tool](CHAP_Mapping.md).
Você pode adicionar vários projetos de conversão de aplicativos em um único AWS SCT projeto. Use o procedimento a seguir para criar um projeto de conversão de aplicativos C\$1.
**Para criar um projeto de conversão de aplicativos C\$1**
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 [Iniciando e gerenciando projetos em AWS SCT](CHAP_UserInterface.Project.md) e [Adicionando servidores ao projeto em AWS SCT](CHAP_UserInterface.AddServers.md).
1. 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 [Mapear tipo de dados no AWS Schema Conversion Tool](CHAP_Mapping.md) e [Mapeamento para alvos virtuais no AWS Schema Conversion Tool](CHAP_Mapping.VirtualTargets.md).
1. No menu **Visualizar**, escolha **Visualização principal**.
1. No menu **Aplicativos**, selecione **Novo aplicativo C\$1**.
A caixa de diálogo **Como criar um projeto de conversão de aplicativos C\$1** será exibida.
![\[A caixa de diálogo do novo projeto de conversão de aplicativos C#\]](http://docs.aws.amazon.com/pt_br/SchemaConversionTool/latest/userguide/images/csharp-application-new-project.png)
1. Em **Nome**, digite um nome para o seu projeto de conversão de aplicativos C\$1. 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.
1. Em **Local**, digite o local do código fonte referente ao aplicativo.
1. 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. AWS SCT destaca os esquemas que fazem parte de uma regra de mapeamento em negrito.
1. Selecione **OK** para criar um projeto de conversão de aplicativos C\$1.
1. Encontre seu projeto de conversão de aplicativos C\$1 no nó **Aplicativos** no painel esquerdo.
## Convertendo o código SQL do seu aplicativo C\$1 em AWS SCT
Depois de adicionar seu aplicativo C\$1 ao AWS SCT projeto, 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\$1 na AWS Schema Conversion Tool.
**Para converter seu código SQL**
1. Expanda o nó **C\$1** em **Aplicativos** no painel esquerdo.
1. Selecione o aplicativo a ser convertido e abra o menu de contexto (clique com o botão direito).
1. Escolha **Converter**. 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\$1 e assim por diante.
No painel do banco de dados de destino, 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\]](http://docs.aws.amazon.com/pt_br/SchemaConversionTool/latest/userguide/images/csharp-applications-project-analyze.png)
1. Salve o código do seu aplicativo convertido. Para obter mais informações, consulte [Como salvar o código do aplicativo convertido](#CHAP_Converting.App.Csharp.Save).
Seus aplicativos C\$1 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\$1 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, AWS SCT ainda analisa o código SQL de todos os arquivos de origem de seus aplicativos C\$1. Em seguida, 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.
## Salvando o código do aplicativo convertido com 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\$1** em **Aplicativos** no painel do banco de dados de destino.
1. Escolha seu aplicativo convertido e selecione **Salvar**.
1. Insira o caminho para a pasta para salvar o código do aplicativo convertido e escolha **Selecionar pasta**.
## Gerenciando projetos de conversão de aplicativos C\$1 em AWS SCT
Você pode adicionar vários projetos de conversão de aplicativos em C\$1, atualizar o código do aplicativo no AWS SCT projeto ou remover um projeto de conversão em C\$1 do seu AWS SCT projeto.
**Para adicionar um projeto adicional de conversão de aplicativos C\$1**
1. Expanda o nó **Aplicativos** no painel esquerdo.
1. Escolha o nó **C\$1** e abra o menu de contexto (clique com o botão direito).
1. Escolha **New application** (Nova aplicação).
1. Insira as informações necessárias para criar um novo projeto de conversão de aplicativos C\$1. Para obter mais informações, consulte [Como criar projetos de conversão de aplicativos C\$1](#CHAP_Converting.App.Csharp.Create).
Depois de fazer alterações no código-fonte do aplicativo, carregue-o no AWS SCT projeto.
**Para carregar o código do aplicativo atualizado**
1. Expanda o nó **C\$1** em **Aplicativos** no painel esquerdo.
1. Selecione o aplicativo a ser atualizado e abra o menu de contexto (clique com o botão direito).
1. Selecione **Atualizar** e, em seguida, selecione **Sim**.
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 AWS SCT e os resultados da conversão, crie um novo projeto de conversão em C\$1.
**Para remover um projeto de conversão de aplicativos C\$1**
1. Expanda o nó **C\$1** em **Aplicativos** no painel esquerdo.
1. Selecione o aplicativo a ser removido e abra o menu de contexto (clique com o botão direito).
1. Selecione **Excluir** e **OK**.
## Criando um relatório de avaliação de conversão de aplicativos C\$1 no AWS SCT
O *Relatório de avaliação da conversão do aplicativo C\$1* fornece informações sobre como converter o código SQL incorporado em seu aplicativo C\$1 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 não AWS SCT podem ser convertidos.
Use o procedimento a seguir para criar um relatório de avaliação de conversão de aplicativos C\$1.
**Para criar um relatório de avaliação de conversão de aplicativos C\$1**
1. Expanda o nó **C\$1** em **Aplicativos** no painel esquerdo.
1. Selecione o aplicativo a ser convertido e abra o menu de contexto (clique com o botão direito).
1. Selecione **Converter**.
1. No menu **Exibir**, selecione **Visualização do relatório de avaliação**.
1. 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\$1. 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#\]](http://docs.aws.amazon.com/pt_br/SchemaConversionTool/latest/userguide/images/csharp-applications-summary.png)
1. Selecione **Salvar instruções em JSON** para salvar o código SQL extraído do seu aplicativo C\$1 como um arquivo JSON.
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.
# Convertendo código SQL em aplicativos C\$1\$1 com AWS Schema Conversion Tool
Para uma conversão de Oracle para PostgreSQL, você pode AWS SCT usar para converter código SQL incorporado em seus aplicativos C\$1\$1. Esse conversor de aplicativos C\$1\$1 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\$1\$1 fornece melhores resultados de conversão do que o conversor genérico.
## Criação de projetos de conversão de aplicativos C\$1\$1 em AWS SCT
Você pode criar um projeto de conversão de aplicativos C\$1\$1 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 [Mapear tipo de dados no AWS Schema Conversion Tool](CHAP_Mapping.md).
Você pode adicionar vários projetos de conversão de aplicativos em um único projeto de AWS SCT .
**Para criar um projeto de conversão de aplicativos C\$1\$1**
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 [Iniciando e gerenciando projetos em AWS SCT](CHAP_UserInterface.Project.md) e [Adicionando servidores ao projeto em AWS SCT](CHAP_UserInterface.AddServers.md).
1. 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 [Mapear tipo de dados no AWS Schema Conversion Tool](CHAP_Mapping.md) e [Mapeamento para alvos virtuais no AWS Schema Conversion Tool](CHAP_Mapping.VirtualTargets.md).
1. No menu **Visualizar**, escolha **Visualização principal**.
1. No menu **Aplicativos**, selecione **Novo aplicativo C\$1\$1**.
A caixa de diálogo **Como criar um projeto de conversão de aplicativos C\$1\$1** será exibida.
![\[A caixa de diálogo do novo projeto de conversão de aplicativos C++\]](http://docs.aws.amazon.com/pt_br/SchemaConversionTool/latest/userguide/images/cplusplus-application-new-project.png)
1. Em **Nome**, digite um nome para o seu projeto de conversão de aplicativos C\$1\$1. 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.
1. Em **Local**, digite o local do código fonte referente ao aplicativo.
1. 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. AWS SCT destaca os esquemas que fazem parte de uma regra de mapeamento em negrito.
1. Selecione **OK** para criar um projeto de conversão de aplicativos C\$1\$1.
1. Encontre seu projeto de conversão de aplicativos C\$1\$1 no nó **Aplicativos** no painel esquerdo.
## Convertendo o código SQL do seu aplicativo C\$1\$1 em AWS SCT
Depois de adicionar seu aplicativo C\$1\$1 ao AWS SCT projeto, 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\$1\$1 na AWS SCT.
**Para converter seu código SQL**
1. Expanda o nó **C\$1\$1** em **Aplicativos** no painel esquerdo e escolha o aplicativo a ser convertido.
1. No **Projeto do aplicativo Oracle de origem**, selecione **Configurações**. Revise e edite as configurações de conversão do aplicativo C\$1\$1 selecionado. Você também pode especificar as configurações de conversão para todos os aplicativos C\$1\$1 que você adicionou ao seu AWS SCT projeto. Para obter mais informações, consulte [Como gerenciar projetos de conversão de aplicativos C\$1\$1](#CHAP_Converting.App.Cplusplus.Manage).
1. Em **Tipo de compilador**, escolha o compilador que você usa para o código-fonte do seu aplicativo C\$1\$1. AWS SCT **suporta os seguintes compiladores C\$1\$1: **Microsoft Visual C\$1\$1**, **GCC, GNU Compiler Collection** e Clang.** A opção padrão é o **Microsoft Visual C\$1\$1**.
1. Em **Macros definidas pelo usuário**, insira o caminho para o arquivo que inclui macros definidas pelo usuário do seu projeto em C\$1\$1. Certifique-se de que esse arquivo tenha a seguinte estrutura: `#define name value`. No exemplo anterior, `value` é um parâmetro opcional. O valor padrão para este parâmetro opcional é `1`.
Para criar esse arquivo, abra seu projeto no Microsoft Visual Studio e selecione **Projeto**, **Propriedades**, **C/C\$1\$1** e **Pré-processador**. Em **Definições de pré-processador**, selecione **Editar** e copie nomes e valores para um novo arquivo de texto. Em seguida, para cada string no arquivo, adicione o seguinte prefixo: `#define `.
1. Em **Diretórios de inclusão externos**, insira os caminhos para as pastas que incluem bibliotecas externas que você usa em seu projeto C\$1\$1.
1. No painel esquerdo, selecione o aplicativo a ser convertido e abra o menu de contexto (clique com o botão direito).
1. Escolha **Converter**. 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\$1\$1 e assim por diante.
No painel do banco de dados de destino, 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, como mostrado a seguir.
![\[Código SQL a ser analisado\]](http://docs.aws.amazon.com/pt_br/SchemaConversionTool/latest/userguide/images/cplusplus-applications-project-analyze.png)
1. Salve o código do seu aplicativo convertido. Para obter mais informações, consulte [Como salvar o código do aplicativo convertido](#CHAP_Converting.App.Cplusplus.Save).
## Salvando o código do aplicativo convertido com 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\$1\$1** em **Aplicativos** no painel do banco de dados de destino.
1. Escolha seu aplicativo convertido e selecione **Salvar**.
1. Insira o caminho para a pasta para salvar o código do aplicativo convertido e escolha **Selecionar pasta**.
## Gerenciando projetos de conversão de aplicativos C\$1\$1 no AWS SCT
Você pode adicionar vários projetos de conversão de aplicativos em C\$1\$1, editar configurações de conversão, atualizar o código do aplicativo em C\$1\$1 ou remover um projeto de conversão em C\$1\$1 do seu projeto. AWS SCT
**Para adicionar um projeto adicional de conversão de aplicativos C\$1\$1**
1. Expanda o nó **Aplicativos** no painel esquerdo.
1. Escolha o nó **C\$1\$1** e abra o menu de contexto (clique com o botão direito).
1. Escolha **New application** (Nova aplicação).
1. Insira as informações necessárias para criar um novo projeto de conversão de aplicativos C\$1\$1. Para obter mais informações, consulte [Como criar projetos de conversão de aplicativos C\$1\$1](#CHAP_Converting.App.Cplusplus.Create).
Você pode especificar as configurações de conversão para todos os projetos de conversão de aplicativos C\$1\$1 em seu AWS SCT projeto.
**Para editar as configurações de conversão para todos os aplicativos C\$1\$1**
1. No menu **Configurações**, selecione **Configurações do projeto** e, em seguida, selecione **Conversão de aplicativos**.
1. Em **Tipo de compilador**, escolha o compilador que você usa para o código-fonte do seu aplicativo C\$1\$1. AWS SCT **suporta os seguintes compiladores C\$1\$1: **Microsoft Visual C\$1\$1**, **GCC, GNU Compiler Collection** e Clang.** A opção padrão é o **Microsoft Visual C\$1\$1**.
1. Em **Macros definidas pelo usuário**, insira o caminho para o arquivo que inclui macros definidas pelo usuário do seu projeto em C\$1\$1. Certifique-se de que esse arquivo tenha a seguinte estrutura: `#define name value`. No exemplo anterior, `value` é um parâmetro opcional. O valor padrão para este parâmetro opcional é `1`.
Para criar esse arquivo, abra seu projeto no Microsoft Visual Studio e selecione **Projeto**, **Propriedades**, **C/C\$1\$1** e **Pré-processador**. Em **Definições de pré-processador**, selecione **Editar** e copie nomes e valores para um novo arquivo de texto. Em seguida, para cada string no arquivo, adicione o seguinte prefixo: `#define `.
1. Em **Diretórios de inclusão externos**, insira os caminhos para as pastas que incluem bibliotecas externas que você usa em seu projeto C\$1\$1.
1. Selecione **OK** para salvar as configurações do projeto e fechar a janela.
Ou você pode especificar configurações de conversão para cada projeto de conversão de aplicativos C\$1\$1. Para obter mais informações, consulte [Como converter o código SQL em seu aplicativo C\$1\$1](#CHAP_Converting.App.Cplusplus.Convert).
Depois de fazer alterações no código-fonte do aplicativo, carregue-o no AWS SCT projeto.
**Para carregar o código do aplicativo atualizado**
1. Expanda o nó **C\$1\$1** em **Aplicativos** no painel esquerdo.
1. Selecione o aplicativo a ser atualizado e abra o menu de contexto (clique com o botão direito).
1. Selecione **Atualizar** e, em seguida, selecione **Sim**.
AWS SCT carrega o código do aplicativo dos arquivos de origem e remove os resultados da conversão. Para manter as alterações de código feitas AWS SCT e os resultados da conversão, crie um novo projeto de conversão em C\$1\$1.
Além disso, AWS SCT remove as configurações de conversão do aplicativo que você especificou para o aplicativo selecionado. Depois de carregar o código atualizado do aplicativo, AWS SCT aplica os valores padrão das configurações do projeto.
**Para remover um projeto de conversão de aplicativos C\$1\$1**
1. Expanda o nó **C\$1\$1** em **Aplicativos** no painel esquerdo.
1. Selecione o aplicativo a ser removido e abra o menu de contexto (clique com o botão direito).
1. Selecione **Excluir** e **OK**.
## Criando um relatório de avaliação de conversão de aplicativos C\$1\$1 no AWS SCT
O *Relatório de avaliação da conversão do aplicativo C\$1\$1* fornece informações sobre como converter o código SQL incorporado em seu aplicativo C\$1\$1 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 não AWS SCT podem ser convertidos.
**Para criar um relatório de avaliação de conversão de aplicativos C\$1\$1**
1. Expanda o nó **C\$1\$1** em **Aplicativos** no painel esquerdo.
1. Selecione o aplicativo a ser convertido e abra o menu de contexto (clique com o botão direito).
1. Selecione **Converter**.
1. No menu **Exibir**, selecione **Visualização do relatório de avaliação**.
1. Visualize a guia **Resumo**.
A guia **Resumo** exibe as informações do resumo executivo do relatório de avaliação de aplicativos C\$1\$1. Ele mostra os resultados da conversão para todos os pontos de execução do SQL e todos os arquivos de código fonte.
1. Selecione **Salvar instruções em JSON** para salvar o código SQL extraído do seu aplicativo Java como um arquivo JSON.
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.
# Convertendo código SQL em aplicativos Java com AWS Schema Conversion Tool
Para uma conversão de Oracle para PostgreSQL, você pode AWS Schema Conversion Tool usar para converter código SQL incorporado em seus aplicativos Java. Esse conversor de aplicativos Java 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 Java fornece melhores resultados de conversão do que o conversor genérico.
Se seu aplicativo Java usa a MyBatis estrutura para interagir com bancos de dados, você pode usá-la AWS SCT para converter instruções SQL incorporadas em arquivos e anotações MyBatis XML. Para entender a lógica dessas instruções SQL, AWS SCT use o arquivo MyBatis de configuração. AWS SCT pode descobrir automaticamente esse arquivo na pasta do aplicativo ou você pode inserir o caminho para esse arquivo manualmente.
## Criação de projetos de conversão de aplicativos Java no AWS SCT
Você pode criar um projeto de conversão de aplicativos Java 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 [Mapear tipo de dados no AWS Schema Conversion Tool](CHAP_Mapping.md).
Você pode adicionar vários projetos de conversão de aplicativos em um único AWS SCT projeto. Use o procedimento a seguir para criar um projeto de conversão de aplicativos Java.
**Para criar um projeto de conversão de aplicativos Java**
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 [Iniciando e gerenciando projetos em AWS SCT](CHAP_UserInterface.Project.md) e [Adicionando servidores ao projeto em AWS SCT](CHAP_UserInterface.AddServers.md).
1. 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 [Mapear tipo de dados no AWS Schema Conversion Tool](CHAP_Mapping.md) e [Mapeamento para alvos virtuais no AWS Schema Conversion Tool](CHAP_Mapping.VirtualTargets.md).
1. No menu **Visualizar**, escolha **Visualização principal**.
1. No menu **Aplicativos**, selecione **Novo aplicativo Java**.
A caixa de diálogo **Como criar um projeto de conversão de aplicativos Java** será exibida.
![\[A caixa de diálogo Novo projeto de conversão de aplicativo Java\]](http://docs.aws.amazon.com/pt_br/SchemaConversionTool/latest/userguide/images/java-application-new-project.png)
1. Em **Nome**, digite um nome para o seu projeto de conversão de aplicativos Java. 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.
1. Em **Local**, digite o local do código fonte referente ao aplicativo.
1. (Opcional) Para **arquivo MyBatis de configuração**, insira o caminho para o arquivo MyBatis de configuração. AWS SCT escaneia a pasta do aplicativo para descobrir esse arquivo automaticamente. Se esse arquivo não estiver localizado na pasta do aplicativo ou se você usar vários arquivos de configuração, insira o caminho manualmente.
1. 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. AWS SCT destaca os esquemas que fazem parte de uma regra de mapeamento em negrito.
1. Selecione **OK** para criar um projeto de conversão de aplicativos Java.
1. Encontre seu projeto de conversão de aplicativos Java no nó **Aplicativos** no painel esquerdo.
## Convertendo o código SQL do seu aplicativo Java em AWS SCT
Depois de adicionar seu aplicativo Java ao AWS SCT projeto, 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 Java na AWS Schema Conversion Tool.
**Para converter seu código SQL**
1. Expanda o nó **Java** em **Aplicativos** no painel esquerdo.
1. Selecione o aplicativo a ser convertido e abra o menu de contexto (clique com o botão direito).
1. Escolha **Converter**. 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 Java e assim por diante.
No painel do banco de dados de destino, 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\]](http://docs.aws.amazon.com/pt_br/SchemaConversionTool/latest/userguide/images/java-applications-project-analyze.png)
1. Salve o código do seu aplicativo convertido. Para obter mais informações, consulte [Como salvar o código do aplicativo convertido](#CHAP_Converting.App.Java.Save).
Seus aplicativos Java 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 Java 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, AWS SCT ainda analisa o código SQL de todos os arquivos de origem de seus aplicativos Java. Em seguida, 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.
## Salvando o código do aplicativo convertido com 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ó **Java** em **Aplicativos** no painel do banco de dados de destino.
1. Escolha seu aplicativo convertido e selecione **Salvar**.
1. Insira o caminho para a pasta para salvar o código do aplicativo convertido e escolha **Selecionar pasta**.
Se seu aplicativo Java de origem usa a MyBatis estrutura, certifique-se de atualizar seu arquivo de configuração para funcionar com seu novo banco de dados.
## Gerenciando projetos de conversão de aplicativos Java no AWS SCT
Você pode adicionar vários projetos de conversão de aplicativos Java, atualizar o código do aplicativo no AWS SCT projeto ou remover um projeto de conversão Java do seu AWS SCT projeto.
**Para adicionar um projeto adicional de conversão de aplicativos Java**
1. Expanda o nó **Aplicativos** no painel esquerdo.
1. Escolha o nó **Java** e abra o menu de contexto (clique com o botão direito).
1. Escolha **New application** (Nova aplicação).
1. Insira as informações necessárias para criar um novo projeto de conversão de aplicativos Java. Para obter mais informações, consulte [Como criar projetos de conversão de aplicativos Java](#CHAP_Converting.App.Java.Create).
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ó **Java** em **Aplicativos** no painel esquerdo.
1. Selecione o aplicativo a ser atualizado e abra o menu de contexto (clique com o botão direito).
1. Selecione **Atualizar** e, em seguida, selecione **Sim**.
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 AWS SCT e os resultados da conversão, crie um novo projeto de conversão Java.
Se seu aplicativo Java de origem usa a MyBatis estrutura, AWS SCT usa o arquivo de MyBatis configuração para analisar seu código SQL. Depois de alterar esse arquivo, carregue-o no AWS SCT projeto.
**Para editar o caminho para o arquivo MyBatis de configuração**
1. Expanda o nó **Java** em **Aplicativos** no painel esquerdo.
1. Escolha seu aplicativo e, em seguida, selecione **Configurações**.
1. Escolha **Procurar e, em** seguida, escolha o arquivo MyBatis de configuração.
1. Escolha **Aplicar**.
1. No painel esquerdo, escolha seu aplicativo, abra o menu de contexto (clique com o botão direito do mouse) e selecione **Atualizar**.
**Para remover um projeto de conversão de aplicativos Java**
1. Expanda o nó **Java** em **Aplicativos** no painel esquerdo.
1. Selecione o aplicativo a ser removido e abra o menu de contexto (clique com o botão direito).
1. Selecione **Excluir** e **OK**.
## Criando um relatório de avaliação de conversão de aplicativos Java no AWS SCT
O *Relatório de avaliação da conversão do aplicativo Java* fornece informações sobre como converter o código SQL incorporado em seu aplicativo Java 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 não AWS SCT podem ser convertidos.
Use o procedimento a seguir para criar um relatório de avaliação de conversão de aplicativos Java.
**Para criar um relatório de avaliação de conversão de aplicativos Java**
1. Expanda o nó **Java** em **Aplicativos** no painel esquerdo.
1. Selecione o aplicativo a ser convertido e abra o menu de contexto (clique com o botão direito).
1. Selecione **Converter**.
1. No menu **Exibir**, selecione **Visualização do relatório de avaliação**.
1. 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 Java. 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 Java\]](http://docs.aws.amazon.com/pt_br/SchemaConversionTool/latest/userguide/images/java-applications-summary.png)
1. Selecione **Salvar instruções em JSON** para salvar o código SQL extraído do seu aplicativo Java como um arquivo JSON.
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.
# Convertendo código SQL em aplicativos Pro\$1C com AWS Schema Conversion Tool
Para uma conversão de Oracle para PostgreSQL, você pode usar AWS Schema Conversion Tool o AWS SCT() para converter o código SQL incorporado em seus aplicativos Pro\$1C. Esse conversor de aplicativos Pro\$1C 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\$1C fornece melhores resultados de conversão do que o conversor genérico.
## Criação de projetos de conversão de aplicativos Pro\$1C em AWS SCT
Você pode criar um projeto de conversão de aplicativos Pro\$1C 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 [Mapear tipo de dados no AWS Schema Conversion Tool](CHAP_Mapping.md).
Você pode adicionar vários projetos de conversão de aplicativos em um único AWS SCT projeto. Use o procedimento a seguir para criar um projeto de conversão de aplicativos Pro\$1C.
**Para criar um projeto de conversão de aplicativos Pro\$1C**
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 [Iniciando e gerenciando projetos em AWS SCT](CHAP_UserInterface.Project.md) e [Adicionando servidores ao projeto em AWS SCT](CHAP_UserInterface.AddServers.md).
1. 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 [Mapear tipo de dados no AWS Schema Conversion Tool](CHAP_Mapping.md) e [Mapeamento para alvos virtuais no AWS Schema Conversion Tool](CHAP_Mapping.VirtualTargets.md).
1. No menu **Visualizar**, escolha **Visualização principal**.
1. No menu **Aplicativos**, selecione **Novo aplicativo Pro\$1C**.
A caixa de diálogo **Como criar um projeto de conversão de aplicativos Pro\$1C** será exibida.
![\[A caixa de diálogo do novo projeto de conversão de aplicativos Pro*C\]](http://docs.aws.amazon.com/pt_br/SchemaConversionTool/latest/userguide/images/proc-application-new-project.png)
1. Em **Nome**, digite um nome para o seu projeto de conversão de aplicativos Pro\$1C. 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.
1. Em **Local**, digite o local do código fonte referente ao aplicativo.
1. 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. AWS SCT destaca os esquemas que fazem parte de uma regra de mapeamento em negrito.
1. Selecione **OK** para criar um projeto de conversão de aplicativos Pro\$1C.
1. Encontre seu projeto de conversão de aplicativos Pro\$1C no nó **Aplicativos** no painel esquerdo.
## Convertendo o código SQL do aplicativo Pro\$1C em AWS SCT
Depois de adicionar seu aplicativo Pro\$1C ao AWS SCT projeto, 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\$1C na AWS Schema Conversion Tool.
**Para converter seu código SQL**
1. Expanda o nó **Pro\$1C** em **Aplicativos** no painel esquerdo.
1. 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.
1. Selecione **Interpretar todas as variáveis não resolvidas do host** para ver todas as variáveis não resolvidas no código convertido.
1. 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.
1. Escolha **Transformar PL/SQL blocos anônimos em chamadas SQL autônomas ou funções armazenadas** para criar procedimentos armazenados em seu banco de dados de destino para todos os PL/SQL blocos anônimos. AWS SCT em seguida, inclui as execuções desses procedimentos armazenados no código do aplicativo convertido.
1. Selecione **Usar fluxo de cursor personalizado** para melhorar a conversão dos cursores do banco de dados Oracle.
1. No painel esquerdo, selecione o aplicativo a ser convertido e abra o menu de contexto (clique com o botão direito).
1. Escolha **Converter**. 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\$1C e assim por diante.
No painel do banco de dados de destino, 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\]](http://docs.aws.amazon.com/pt_br/SchemaConversionTool/latest/userguide/images/proc-applications-project-analyze.png)
1. Salve o código do seu aplicativo convertido. Para obter mais informações, consulte [Como editar e salvar o código do aplicativo convertido](#CHAP_Converting.App.ProC.Save).
## Editando e salvando o código do aplicativo convertido com AWS SCT
Você pode editar as instruções SQL convertidas e usá-las AWS SCT para incorporar esse código editado no código do aplicativo Pro\$1C 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\$1C** em **Aplicativos** no painel esquerdo.
1. Selecione o aplicativo a ser convertido, abra o menu de contexto (clique com o botão direito) e selecione **Converter**.
1. No menu **Exibir**, selecione **Visualização do relatório de avaliação**.
1. Selecione **Salvar instruções em CSV** para salvar o código SQL extraído do seu aplicativo Pro\$1C como um arquivo CSV.
1. Insira o nome do arquivo CSV para salvar o código SQL extraído e escolha selecione **Salvar**.
1. Edite o código SQL extraído.
1. No menu **Visualizar**, escolha **Visualização principal**.
1. Expanda o nó **Pro\$1C** em **Aplicativos** no painel do banco de dados de destino.
1. Escolha seu aplicativo convertido, abra o menu de contexto (clique com o botão direito) e selecione **Importar instruções do CSV**.
1. Selecione **Sim**, depois escolha o arquivo com seu código SQL editado e selecione **Abrir**.
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\$1C** em **Aplicativos** no painel do banco de dados de destino.
1. Escolha seu aplicativo convertido e selecione **Salvar**.
1. Insira o caminho para a pasta para salvar o código do aplicativo convertido e escolha **Selecionar pasta**.
## Gerenciando projetos de conversão de aplicativos Pro\$1C em AWS SCT
Você pode adicionar vários projetos de conversão do aplicativo Pro\$1C, atualizar o código do aplicativo no AWS SCT projeto ou remover um projeto de conversão do Pro\$1C do seu projeto. AWS SCT
**Para adicionar um projeto adicional de conversão de aplicativos Pro\$1C**
1. Expanda o nó **Aplicativos** no painel esquerdo.
1. Escolha o nó **Pro\$1C** e abra o menu de contexto (clique com o botão direito).
1. Escolha **New application** (Nova aplicação).
1. Insira as informações necessárias para criar um novo projeto de conversão de aplicativos Pro\$1C. Para obter mais informações, consulte [Como criar projetos de conversão de aplicativos Pro\$1C](#CHAP_Converting.App.ProC.Create).
Depois de fazer alterações no código-fonte do aplicativo, carregue-o no AWS SCT projeto.
**Para carregar o código do aplicativo atualizado**
1. Expanda o nó **Pro\$1C** em **Aplicativos** no painel esquerdo.
1. Selecione o aplicativo a ser atualizado e abra o menu de contexto (clique com o botão direito).
1. Selecione **Atualizar** e, em seguida, selecione **Sim**.
AWS SCT carrega o código do aplicativo dos arquivos de origem e remove os resultados da conversão. Para manter as alterações de código que você fez AWS SCT e os resultados da conversão, crie um novo projeto de conversão Pro\$1C.
**Para remover um projeto de conversão de aplicativos Pro\$1C**
1. Expanda o nó **Pro\$1C** em **Aplicativos** no painel esquerdo.
1. Selecione o aplicativo a ser removido e abra o menu de contexto (clique com o botão direito).
1. Selecione **Excluir** e **OK**.
## Criando um relatório de avaliação de conversão de aplicativos Pro\$1C no AWS SCT
O *Relatório de avaliação da conversão do aplicativo Pro\$1C* fornece informações sobre como converter o código SQL incorporado em seu aplicativo Pro\$1C 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 não AWS SCT podem ser convertidos.
Use o procedimento a seguir para criar um relatório de avaliação de aplicativos Pro\$1C.
**Para criar um relatório de avaliação de conversão de aplicativos Pro\$1C**
1. Expanda o nó **Pro\$1C** em **Aplicativos** no painel esquerdo.
1. Selecione o aplicativo a ser convertido e abra o menu de contexto (clique com o botão direito).
1. Selecione **Converter**.
1. No menu **Exibir**, selecione **Visualização do relatório de avaliação**.
1. 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\$1C. 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 Pro*C\]](http://docs.aws.amazon.com/pt_br/SchemaConversionTool/latest/userguide/images/proc-applications-summary.png)
1. Selecione **Salvar instruções em CSV** para salvar o código SQL extraído do seu aplicativo Pro\$1C como um arquivo de valores separados por vírgulas (CSV).
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.