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.
# Referencia CLI para AWS Schema Conversion Tool
En esta sección se describe cómo empezar a utilizar la interfaz de línea de AWS SCT comandos (CLI). Además, en esta sección se proporciona información sobre los comandos de teclado y los modos de uso. Para obtener una referencia completa de los comandos AWS SCT CLI, consulte[Material de referencia](#CHAP_Reference.Download).
**Topics**
+ [Requisitos previos para usar la interfaz de línea de AWS SCT comandos](#CHAP_Reference.Prerequisites)
+ [AWS SCT Modo interactivo CLI](#CHAP_Reference.InteractiveMode)
+ [Obtener escenarios de AWS SCT CLI](#CHAP_Reference.Scenario)
+ [Edición de escenarios AWS SCT CLI](#CHAP_Reference.Editing)
+ [AWS SCT Modo de script CLI](#CHAP_Reference.ScriptMode)
+ [AWS SCT Material de referencia CLI](#CHAP_Reference.Download)
## Requisitos previos para usar la interfaz de línea de AWS SCT comandos
Descargue e instale la versión más reciente de Amazon Corretto 11. Para obtener más información, consulte [Descargas para Amazon Corretto 11](https://docs.aws.amazon.com/corretto/latest/corretto-11-ug/downloads-list.html) en la *Guía del Usuario de Amazon Corretto 11*.
Descargue e instale la versión más reciente de AWS SCT. Para obtener más información, consulte [Instalando AWS Schema Conversion Tool](CHAP_Installing.Procedure.md).
## AWS SCT Modo interactivo CLI
Puede utilizar la interfaz de línea de AWS SCT comandos en el modo interactivo. En este modo, los comandos se introducen en la consola uno a uno. Puede usar este modo interactivo para obtener más información sobre los comandos de la CLI o descargar los escenarios de la CLI más utilizados.
Para convertir el esquema de la base de datos de origen en un esquema AWS SCT, ejecute una operación secuencial: cree un nuevo proyecto, conéctese a las bases de datos de origen y destino, cree reglas de mapeo y convierta los objetos de la base de datos. Dado que este flujo de trabajo puede ser complejo, se recomienda utilizar scripts en el modo AWS SCT CLI. Para obtener más información, consulte [Modo script](#CHAP_Reference.ScriptMode).
Puede ejecutar los comandos AWS SCT CLI desde la `app` carpeta de la ruta de AWS SCT instalación. En Windows, la ruta de instalación predeterminada es `C:\Program Files\AWS Schema Conversion Tool\`. Asegúrese de que esta carpeta incluya el archivo `AWSSchemaConversionToolBatch.jar`.
Para entrar en el modo interactivo AWS SCT CLI, utilice el siguiente comando después de completar los requisitos previos.
```
java -jar AWSSchemaConversionToolBatch.jar -type interactive
```
Ahora puede ejecutar comandos AWS SCT CLI. Asegúrese de terminar los comandos con `/` en una línea nueva. Además, debe utilizar comillas simples rectas (`'`) antes y después de los valores de los parámetros de los comandos.
**nota**
Si el comando anterior devuelve un `Unexpected error`, pruebe lo siguiente:
```
java -Djdk.jar.maxSignatureFileSize=20000000 -jar AWSSchemaConversionToolBatch.jar
```
Para ver la lista de comandos disponibles en el modo interactivo AWS SCT CLI, ejecute el siguiente comando.
```
help
/
```
Para ver información sobre un comando AWS SCT CLI, utilice el siguiente comando.
```
help -command: 'command_name'
/
```
En el ejemplo anterior, *command\$1name* sustitúyalo por el nombre de un comando.
Para ver información sobre los parámetros de un comando AWS SCT CLI, utilice el siguiente comando.
```
help -command: 'command_name' -parameters: 'parameters_list'
/
```
En el ejemplo anterior, *command\$1name* sustitúyalo por el nombre de un comando. A continuación, *parameters\$1list* sustitúyalo por una lista de nombres de parámetros separados por una coma.
Para ejecutar un script desde un archivo en el modo interactivo AWS SCT CLI, utilice el siguiente comando.
```
ExecuteFile -file: 'file_path'
/
```
En el ejemplo anterior, *file\$1path* sustituya la ruta del archivo por un script. El archivo debe tener la extensión `.scts`.
Para salir del modo interactivo AWS SCT CLI, ejecute el `quit` comando.
### Ejemplos
En el siguiente ejemplo se muestra información sobre el comando `Convert`.
```
help -command: 'Convert'
/
```
En el siguiente ejemplo se muestra información sobre los parámetros del comando `Convert`.
```
help -command: 'Convert' -parameters: 'filter, treePath'
/
```
## Obtener escenarios de AWS SCT CLI
Para obtener los AWS SCT escenarios más utilizados, puede usar el `GetCliScenario` comando. Puede ejecutar este comando en modo interactivo y, a continuación, editar las plantillas descargadas. Utilice los archivos editados en modo script.
El comando `GetCliScenario` guarda la plantilla seleccionada o todas las plantillas disponibles en el directorio especificado. La plantilla contiene el conjunto completo de comandos para ejecutar un script. Edite las rutas de los archivos, las credenciales de la base de datos, los nombres de los objetos y otros datos de estas plantillas. Además, asegúrese de eliminar los comandos que no utilice y de añadir nuevos comandos al script cuando sea necesario.
Para ejecutar el comando `GetCliScenario`, complete los requisitos previos y acceda al modo interactivo de la CLI de AWS SCT . Para obtener más información, consulte [Modo interactivo](#CHAP_Reference.InteractiveMode).
A continuación, utilice la siguiente sintaxis para ejecutar el comando `GetCliScenario` y obtener los escenarios de AWS SCT .
```
GetCliScenario -type: 'template_type' -directory: 'file_path'
/
```
En el ejemplo anterior, *template\$1type* sustitúyalo por uno de los tipos de plantilla de la siguiente tabla. A continuación, *file\$1path* sustituya por la ruta la carpeta en la que desee descargar los scripts. Asegúrese de que AWS SCT puede acceder a esta carpeta sin solicitar derechos de administrador. Además, debe utilizar comillas simples rectas (`'`) antes y después de los valores de los parámetros de los comandos.
Para descargar todas las plantillas AWS SCT CLI, ejecute el comando anterior sin la `-type` opción.
La siguiente tabla incluye los tipos de plantillas AWS SCT CLI que puede descargar. Para cada plantilla, se incluye en la tabla el nombre del archivo y la descripción de las operaciones que se pueden ejecutar mediante el script.
| Tipo de plantilla | Nombre de archivo | Description (Descripción) |
| --- | --- | --- |
| BTEQScriptConversión | `BTEQScriptConversionTemplate.scts` | Convierte Teradata Basic Teradata Query (BTEQ) y FastLoad scripts a MultiLoad Amazon FastExport Redshift RSQL. Para obtener más información, consulte [Conversión de datos mediante ETL](CHAP-converting-etl.md). |
| ConversionApply | `ConversionTemplate.scts` | Convierte los esquemas de la base de datos de origen y aplica el código convertido a la base de datos de destino. Si lo desea, guarda el código convertido como un script de SQL y guarda el informe de evaluación. Para obtener más información, consulte [Conversión de esquemas](CHAP_Converting.md). |
| GenericAppConversion | `GenericApplicationConversionTemplate.scts` | Convierte el código SQL integrado en sus aplicaciones con el conversor de aplicaciones genérico. AWS SCT Para obtener más información, consulte [Código SQL](CHAP_Converting.App.Generic.md). |
| HadoopMigration | `HadoopMigrationTemplate.scts` | Migra sus clústeres de Hadoop en las instalaciones a Amazon EMR. Para obtener más información, consulte [Conectarse a las bases de datos de Apache Hadoop con el AWS Schema Conversion Tool](CHAP_Source.Hadoop.md). |
| HadoopResumeMigration | `HadoopResumeMigrationTemplate.scts` | Reanuda una migración interrumpida del clúster de Hadoop en las instalaciones a Amazon EMR. Para obtener más información, consulte [Conectarse a las bases de datos de Apache Hadoop con el AWS Schema Conversion Tool](CHAP_Source.Hadoop.md). |
| Informatica | `InformaticaConversionTemplate.scts` | Convierte el código SQL incrustado en los scripts de extracción, transformación y carga (ETL) de Informatica. Configura las conexiones a las bases de datos de origen y destino en los scripts de ETL y guarda los scripts convertidos tras la conversión. Para obtener más información, consulte [Scripts de ETL de Informatica](CHAP-converting-informatica.md). |
| LanguageSpecificAppConversion | `LanguageSpecificAppConversionTemplate.scts` | Convierte el código SQL incrustado en sus aplicaciones de C\$1, C\$1\$1, Java y Pro\$1C con el conversor de aplicaciones de AWS SCT . Para obtener más información, consulte [Conversión de SQL de las aplicaciones](CHAP_Converting.App.md). |
| OozieConversion | `OozieConversionTemplate.scts` | Convierte sus flujos de trabajo de Apache Oozie en AWS Step Functions. Para obtener más información, consulte [Conexión a los flujos de trabajo de Apache Oozie con AWS Schema Conversion Tool](CHAP_Source.Oozie.md). |
| RedshiftAgent | `DWHDataMigrationTemplate.scts` | Convierte los esquemas de almacenamiento de datos de origen y aplica el código convertido a la base de datos de Amazon Redshift de destino. A continuación, registra un agente de extracción de datos, crea e inicia una tarea de migración de datos. Para obtener más información, consulte [Migración desde un almacenamiento de datos](agents.md). |
| ReportCreation | `ReportCreationTemplate.scts` | Crea un informe de migración de bases de datos para varios esquemas de bases de datos de origen. A continuación, guarda este informe como un archivo CSV o PDF. Para obtener más información, consulte [Informes de evaluación](CHAP_AssessmentReport.md). |
| SQLScriptConversión | `SQLScriptConversionTemplate.scts` | Convierte los scripts de SQL\$1Plus o TSQL en scripts convertidos PL/SQL y los guarda. Además, guarda un informe de evaluación. |
Después de descargar la plantilla AWS SCT CLI, utilice el editor de texto para configurar el script para que se ejecute en las bases de datos de origen y destino. A continuación, utilice el modo de script AWS SCT CLI para ejecutar el script. Para obtener más información, consulte [AWS SCT Modo de script CLI](#CHAP_Reference.ScriptMode).
### Ejemplos
En el siguiente ejemplo, se descargan todas las plantillas a la carpeta `C:\SCT\Templates`.
```
GetCliScenario -directory: 'C:\SCT\Templates'
/
```
En el siguiente ejemplo, se descarga la plantilla para la operación `ConversionApply` a la carpeta `C:\SCT\Templates`.
```
GetCliScenario -type: 'ConversionApply' -directory: 'C:\SCT\Templates'
/
```
## Edición de escenarios AWS SCT CLI
Después de descargar las plantillas de escenarios, configúrelas para obtener scripts funcionales que puedan ejecutarse en sus bases de datos.
Para todas las plantillas, asegúrese de proporcionar la ruta a los controladores de las bases de datos de origen y destino. Para obtener más información, consulte [Instalación de controladores JDBC para AWS Schema Conversion Tool](CHAP_Installing.JDBCDrivers.md).
Debe incluir las credenciales de las bases de datos de origen y destino. Además, debe configurar reglas de asignación para describir un par origen-destino para su proyecto de conversión. Para obtener más información, consulte [Asignación de tipos de datos](CHAP_Mapping.md).
A continuación, configure el alcance de las operaciones que se van a ejecutar. Puede eliminar los comandos que no utilice o añadir nuevos comandos al script.
Por ejemplo, supongamos que planea convertir todos los esquemas de la base de datos Oracle de origen a PostgreSQL. A continuación, tiene pensado guardar el informe de evaluación de la migración de la base de datos en formato PDF y aplicar el código convertido a la base de datos de destino. En este caso, puede utilizar la plantilla para la operación `ConversionApply`. Utilice el siguiente procedimiento para editar la plantilla AWS SCT CLI.
**Para editar la plantilla AWS SCT CLI de la `ConversionApply` operación**
1. Abra el `ConversionTemplate.scts` que descargó. Para obtener más información, consulte [Ejemplos](#CHAP_Reference.Scenario.Examples).
1. Elimine **CreateFilter**y **convierta las operaciones -filter**, **ApplyToTarget -filter**, **SaveTargetSQL**, **SaveTargetSQLbyStatement** y **SaveReportCSV** del script.
1. Para **oracle\$1driver\$1file** en la **SetGlobalSettings**operación, introduzca la ruta del controlador de Oracle. A continuación, en **postgresql\$1driver\$1file**, introduzca la ruta al controlador de PostgreSQL.
Si utiliza otros motores de bases de datos, utilice los nombres correspondientes para la configuración. **Para obtener una lista completa de los ajustes globales que puede configurar en la **SetGlobalSettings**operación, consulte la matriz de ajustes globales del.** [Material de referencia](#CHAP_Reference.Download)
1. (Opcional) Para **CreateProject**, introduzca el nombre del proyecto y la ubicación del archivo de proyecto local. Si decide continuar con los valores predeterminados, asegúrese de que AWS SCT pueda crear archivos en la carpeta `C:\temp` sin solicitar derechos de administrador.
1. Para **AddSource**, introduzca la dirección IP del servidor de la base de datos de origen. Introduzca también el nombre de usuario, la contraseña y el puerto para conectarse al servidor de base de datos de origen.
1. Para **AddTarget**, introduzca la dirección IP del servidor de base de datos de destino. Introduzca también el nombre de usuario, la contraseña y el puerto para conectarse al servidor de base de datos de destino.
1. (Opcional) Para **AddServerMapping**, introduzca los objetos de base de datos de origen y destino que desee añadir a una regla de mapeo. Puede utilizar los parámetros `sourceTreePath` y `targetTreePath` para especificar la ruta a los objetos de la base de datos. Si lo desea, puede utilizar `sourceNamePath` y `targetNamePath` para especificar los nombres de los objetos de la base de datos. Para más información, consulte **Comandos de asignación de servidor** en la [Material de referencia](#CHAP_Reference.Download).
Los valores predeterminados de la **AddServerMapping**operación asignan todos los esquemas de origen a la base de datos de destino.
1. Guarde el archivo y, a continuación, utilice el modo script para ejecutarlo. Para obtener más información, consulte [Modo script](#CHAP_Reference.ScriptMode).
## AWS SCT Modo de script CLI
Tras crear un script AWS SCT CLI o editar una plantilla, puede ejecutarlo con el `RunSCTBatch` comando. Guarde el archivo con el script de CLI como extensión `.scts`.
Puede ejecutar scripts AWS SCT CLI desde la `app` carpeta de la ruta de AWS SCT instalación. En Windows, la ruta de instalación predeterminada es `C:\Program Files\AWS Schema Conversion Tool\`. Asegúrese de que esta carpeta incluya el archivo `RunSCTBatch.cmd` o `RunSCTBatch.sh`. Además, esta carpeta debe incluir el archivo `AWSSchemaConversionToolBatch.jar`.
Como alternativa, puede añadir la ruta al archivo `RunSCTBatch` en la variable de entorno `PATH` de su sistema operativo. Tras actualizar la variable de `PATH` entorno, puede ejecutar scripts AWS SCT CLI desde cualquier carpeta.
Para ejecutar un script AWS SCT CLI, utilice el siguiente comando en Windows.
```
RunSCTBatch.cmd --pathtoscts "file_path"
```
En el ejemplo anterior, *file\$1path* sustituya la ruta del archivo por un script.
Para ejecutar un script AWS SCT CLI, utilice el siguiente comando en Linux.
```
RunSCTBatch.sh --pathtoscts "file_path"
```
En el ejemplo anterior, *file\$1path* sustituya la ruta del archivo por un script.
Puede proporcionar parámetros opcionales en este comando, como las credenciales de la base de datos, el nivel de detalles de la salida de la consola y otros. Para obtener más información, descargue la referencia de la interfaz de línea de AWS SCT comandos en[Material de referencia](#CHAP_Reference.Download).
### Ejemplos
En el ejemplo siguiente se ejecuta el script de `ConversionTemplate.scts` en la carpeta `C:\SCT\Templates`. Puede usar este ejemplo en Windows.
```
RunSCTBatch.cmd --pathtoscts "C:\SCT\Templates\ConversionTemplate.scts"
```
En el ejemplo siguiente se ejecuta el script de `ConversionTemplate.scts` en el directorio `/home/user/SCT/Templates`. Puede usar este ejemplo en Linux.
```
RunSCTBatch.sh --pathtoscts "/home/user/SCT/Templates/ConversionTemplate.scts"
```
## AWS SCT Material de referencia CLI
Puede encontrar material de referencia sobre la interfaz de línea de AWS Schema Conversion Tool comandos (CLI) en la siguiente guía: [AWS Schema Conversion Tool CLI Reference](https://s3.amazonaws.com/publicsctdownload/AWS+SCT+CLI+Reference.pdf).