

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Convertir código SQL en aplicaciones de C\$1\$1 con AWS Schema Conversion Tool
<a name="CHAP_Converting.App.Cplusplus"></a>

Para una conversión de Oracle a PostgreSQL, puede AWS SCT utilizarla para convertir el código SQL incrustado en sus aplicaciones de C\$1\$1. Este conversor de aplicaciones de C\$1\$1 específico comprende la lógica de la aplicación. Recopila las declaraciones que se encuentran en diferentes objetos de la aplicación, como funciones, parámetros, variables locales, etc. 

Gracias a este análisis profundo, el conversor de código SQL de aplicaciones de C\$1\$1 proporciona mejores resultados de conversión que el conversor genérico. 

## Creación de proyectos de conversión de aplicaciones de C\$1\$1 en AWS SCT
<a name="CHAP_Converting.App.Cplusplus.Create"></a>

Puede crear un proyecto de conversión de aplicaciones de C\$1\$1 solo para convertir esquemas de bases de datos Oracle en esquemas de bases de datos PostgreSQL. Agregue una regla de asignación a su proyecto que incluya un esquema de Oracle de origen y una base de datos PostgreSQL de destino. Para obtener más información, consulte [Asignación de tipos de datos en AWS Schema Conversion Tool](CHAP_Mapping.md). 

Puede agregar varios proyectos de conversión de aplicaciones en un único proyecto de AWS SCT .

**Para crear un proyecto de conversión de aplicaciones de C\$1\$1**

1. Cree un proyecto de conversión de bases de datos y agregue una base de datos Oracle de origen. Para obtener más información, consulte [Iniciar y gestionar proyectos en AWS SCT](CHAP_UserInterface.Project.md) y [Añadir servidores al proyecto en AWS SCT](CHAP_UserInterface.AddServers.md). 

1. Agregue una regla de asignación que incluya la base de datos Oracle de origen y una base de datos PostgreSQL de destino. Puede agregar una base de datos PostgreSQL de destino o utilizar una plataforma de base de datos PostgreSQL de destino virtual en una regla de asignación. Para obtener más información, consulte [Asignación de tipos de datos en AWS Schema Conversion Tool](CHAP_Mapping.md) y [Asignación a destinos virtuales en AWS Schema Conversion Tool](CHAP_Mapping.VirtualTargets.md). 

1. En el menú **Ver**, seleccione **Vista principal**.

1. En el menú **Aplicaciones**, elija **Aplicación de \$1\$1 nueva**. 

   Aparecerá el cuadro de diálogo **Creación de un proyecto de conversión de aplicaciones de C\$1\$1 nuevo**.   
![\[Cuadro de diálogo Proyecto de conversión de aplicaciones de C++ nuevo\]](http://docs.aws.amazon.com/es_es/SchemaConversionTool/latest/userguide/images/cplusplus-application-new-project.png)

1. En **Nombre**, escriba un nombre para el proyecto de conversión de aplicaciones de C\$1\$1. Puesto que cada proyecto de conversión de esquemas de bases de datos puede tener uno o varios proyectos secundarios de conversión de aplicaciones, elija un nombre significativo si va agrega varios proyectos. 

1. En **Ubicación**, escriba la ubicación del código fuente de su aplicación. 

1. En el árbol de origen, elija el esquema utilizado por la aplicación. Asegúrese de que este esquema forma parte de una regla de mapeo. AWS SCT resalta los esquemas que forman parte de una regla de mapeo en negrita. 

1. Seleccione **Aceptar** para crear su proyecto de conversión de aplicaciones de C\$1\$1.

1. Busque su proyecto de conversión de aplicaciones de C\$1\$1 en el nodo **Aplicaciones** del panel izquierdo.

## Convertir el código SQL de su aplicación C\$1\$1 en AWS SCT
<a name="CHAP_Converting.App.Cplusplus.Convert"></a>

Tras añadir la aplicación de C\$1\$1 al AWS SCT proyecto, convierta el código SQL de esta aplicación a un formato compatible con la plataforma de base de datos de destino. Utilice el siguiente procedimiento para analizar y convertir su código SQL incrustado en su aplicación de C\$1\$1 en AWS SCT. 

**Para convertir el código SQL**

1. Expanda el nodo **C\$1\$1** en **Aplicaciones** en el panel izquierdo y elija la aplicación que desee convertir.

1. En **Proyecto de la aplicación Oracle de origen**, seleccione **Configuración**. Revise y edite la configuración de conversión de aplicaciones de C\$1\$1 seleccionada. También puede especificar la configuración de conversión para todas las aplicaciones de C\$1\$1 que haya agregado al AWS SCT proyecto. Para obtener más información, consulte [Administración de proyectos de conversión de aplicaciones de C\$1\$1](#CHAP_Converting.App.Cplusplus.Manage).

1. En **Tipo de compilador**, elija el compilador que utilizará para el código fuente de la aplicación de C\$1\$1. AWS SCT **admite los siguientes compiladores de C\$1\$1: **Microsoft Visual C\$1\$1**, **GCC, GNU Compiler Collection** y Clang.** La opción predeterminada es **Microsoft Visual C\$1\$1**.

1. En **Macros definidas por el usuario**, introduzca la ruta al archivo que incluye las macros definidas por el usuario del proyecto de C\$1\$1. Asegúrese de que este archivo tiene la siguiente estructura: `#define name value`. Al igual que en el ejemplo anterior, el parámetro `value` es opcional. El valor predeterminado para este parámetro es `1`.

   Para crear este archivo, abra el proyecto en Microsoft Visual Studio y, a continuación, elija **Proyecto**, **Propiedades**, **C/C\$1\$1** y **Preprocesador**. En **Definiciones del preprocesador**, elija **Editar** y copie los nombres y valores en un nuevo archivo de texto. A continuación, para cada cadena del archivo, agregue el siguiente prefijo: `#define `.

1. En **Directorios de inclusión externa**, introduzca las rutas a las carpetas que incluyen las bibliotecas externas que utiliza en su proyecto de C\$1\$1.

1. En el panel izquierdo, seleccione la aplicación que desea convertir y abra el menú contextual (clic secundario).

1.  **Selecciona Convertir.** AWS SCT analiza los archivos de código fuente, determina la lógica de la aplicación y carga los metadatos del código en el proyecto. Estos metadatos de código incluyen clases, objetos, métodos, variables globales, interfaces, etc. de C\$1\$1. 

   En el panel de la base de datos de destino, AWS SCT crea una estructura de carpetas similar a la del proyecto de la aplicación de origen. Aquí puede revisar el código de la aplicación convertida, como se muestra a continuación.  
![\[Código SQL para analizar\]](http://docs.aws.amazon.com/es_es/SchemaConversionTool/latest/userguide/images/cplusplus-applications-project-analyze.png)

1. Guarde el código de la aplicación convertida. Para obtener más información, consulte [Guardado del código de la aplicación convertida](#CHAP_Converting.App.Cplusplus.Save).

## Guarde el código de la aplicación convertida con AWS SCT
<a name="CHAP_Converting.App.Cplusplus.Save"></a>

Utilice el siguiente procedimiento para guardar el código de la aplicación convertida. 

**Para guardar el código de la aplicación convertida**

1. Expanda el nodo **C\$1\$1** en **Aplicaciones** en el panel de la base de datos de destino.

1. Elija la aplicación convertida y elija **Guardar**.

1. Introduzca la ruta a la carpeta para guardar el código de la aplicación convertida y seleccione **Seleccionar carpeta**.

## Administrar proyectos de conversión de aplicaciones de C\$1\$1 en AWS SCT
<a name="CHAP_Converting.App.Cplusplus.Manage"></a>

Puede añadir varios proyectos de conversión de aplicaciones de C\$1\$1, editar la configuración de conversión, actualizar el código de la aplicación de C\$1\$1 o eliminar un proyecto de conversión de C\$1\$1 de su AWS SCT proyecto.

**Para agregar un proyecto de conversión de aplicaciones de C\$1\$1 adicional**

1. Expanda el nodo **Aplicaciones** en el panel izquierdo.

1. Seleccione el nodo **C\$1\$1** y abra el menú contextual (clic secundario).

1. Elija **Aplicación nueva**.

1. Introduzca la información necesaria para crear un proyecto de conversión de aplicaciones de C\$1\$1 nuevo. Para obtener más información, consulte [Creación de proyectos de conversión de aplicaciones de C\$1\$1](#CHAP_Converting.App.Cplusplus.Create).

Puede especificar la configuración de conversión para todos los proyectos de conversión de aplicaciones de C\$1\$1 de su AWS SCT proyecto.

**Para editar la configuración de conversión de todas las aplicaciones de C\$1\$1**

1. En el menú **Configuración**, elija **Configuración del proyecto** y, a continuación, elija **Conversión de aplicación**.

1. En **Tipo de compilador**, elija el compilador que utilizará para el código fuente de la aplicación de C\$1\$1. AWS SCT **admite los siguientes compiladores de C\$1\$1: **Microsoft Visual C\$1\$1**, **GCC, GNU Compiler Collection** y Clang.** La opción predeterminada es **Microsoft Visual C\$1\$1**.

1. En **Macros definidas por el usuario**, introduzca la ruta al archivo que incluye las macros definidas por el usuario del proyecto de C\$1\$1. Asegúrese de que este archivo tiene la siguiente estructura: `#define name value`. Al igual que en el ejemplo anterior, el parámetro `value` es opcional. El valor predeterminado para este parámetro es `1`.

   Para crear este archivo, abra el proyecto en Microsoft Visual Studio y, a continuación, elija **Proyecto**, **Propiedades**, **C/C\$1\$1** y **Preprocesador**. En **Definiciones del preprocesador**, elija **Editar** y copie los nombres y valores en un nuevo archivo de texto. A continuación, para cada cadena del archivo, agregue el siguiente prefijo: `#define `.

1. En **Directorios de inclusión externa**, introduzca las rutas a las carpetas que incluyen las bibliotecas externas que utiliza en su proyecto de C\$1\$1.

1. Pulse **Aceptar** para guardar la configuración del proyecto y cerrar la ventana.

O especifique la configuración de la conversión para cada proyecto de conversión de aplicaciones de C\$1\$1. Para obtener más información, consulte [Conversión del código SQL de la aplicación de C\$1\$1](#CHAP_Converting.App.Cplusplus.Convert).

Tras realizar los cambios en el código fuente de la aplicación, cárguelo en el proyecto. AWS SCT 

**Para actualizar el código de la aplicación actualizado**

1. Expanda el nodo **C\$1\$1** en **Aplicaciones** en el panel izquierdo.

1. Elija la aplicación que desea actualizar y abra el menú contextual (clic secundario).

1. Seleccione **Actualizar** y, a continuación, elija **Sí**.

   AWS SCT carga el código de la aplicación desde los archivos fuente y elimina los resultados de la conversión. Para conservar los cambios de código que ha realizado AWS SCT y los resultados de la conversión, cree un nuevo proyecto de conversión a C\$1\$1.

   Además, AWS SCT elimina la configuración de conversión de aplicaciones que especificó para la aplicación seleccionada. Tras cargar el código de aplicación actualizado, AWS SCT aplica los valores predeterminados de la configuración del proyecto.

**Para eliminar un proyecto de conversión de aplicaciones de C\$1\$1**

1. Expanda el nodo **C\$1\$1** en **Aplicaciones** en el panel izquierdo.

1. Elija la aplicación que desea eliminar y abra el menú contextual (clic secundario).

1. Elija **Eliminar** y a continuación haga clic en **Aceptar**.

## Crear un informe de evaluación de la conversión de aplicaciones de C\$1\$1 en AWS SCT
<a name="CHAP_Converting.App.Cplusplus.AssessmentReport"></a>

El *Informe de evaluación de la conversión de aplicaciones de C\$1\$1* proporciona información sobre cómo convertir el código SQL incrustado en su aplicación de C\$1\$1 a un formato compatible con la base de datos de destino. El informe de evaluación proporciona detalles de la conversión para todos los puntos de ejecución de SQL y todos los archivos de código fuente. El informe de evaluación también incluye elementos de acción para el código SQL que no AWS SCT se puede convertir. 

**Para crear un informe de evaluación de la conversión de aplicaciones de C\$1\$1**

1. Expanda el nodo **C\$1\$1** en **Aplicaciones** en el panel izquierdo.

1. Elija la aplicación que desea convertir y abra el menú contextual (clic secundario).

1. Seleccione **Convertir**.

1. En el menú **Ver**, seleccione **Ver informe de evaluación**.

1. Consulte la pestaña **Resumen**.

   En la pestaña **Resumen** que se muestra a continuación aparece la información resumida del informe de evaluación de la aplicación de C\$1\$1. Muestra los resultados de la conversión de todos los puntos de ejecución de SQL y de todos los archivos de código fuente. 

1. Seleccione **Guardar instrucciones en JSON** para guardar el código SQL extraído de la aplicación de Java como un archivo JSON.

1. (Opcional) Guarde una copia local del informe como archivo PDF o como un archivo de valores separados por comas (CSV):
   + Seleccione **Guardar en PDF** en la parte superior derecha para guardar el informe como un archivo PDF.

      El archivo PDF contiene el resumen ejecutivo, los elementos de acción y las recomendaciones para la conversión de aplicaciones.
   + Seleccione **Guardar en CSV** en la parte superior derecha para guardar el informe como un archivo CSV.

     El archivo CSV contiene elementos de acción, acciones recomendadas y una estimación de la complejidad del esfuerzo manual necesario para convertir el código SQL.