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.
AWS SCT Referencia CLI
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, consulteMaterial de referencia.
Temas
Requisitos previos para usar la interfaz de la línea de comandos de AWS SCT
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 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 SCT.
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.
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, sustituya command_name 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, sustituya command_name por el nombre de un comando. A continuación, sustituya parameters_list 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, sustituya file_path por la ruta del archivo con 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.
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, sustituya template_type por uno de los tipos de plantilla de la tabla siguiente. A continuación, sustituya file_path por la ruta de 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 | Descripción |
|---|---|---|
|
BTEQ ScriptConversion |
|
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 procesos ETL. |
ConversionApply |
|
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 Convertir esquemas de bases de datos. |
GenericAppConversion |
|
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 Conversión del código SQL de sus aplicaciones. |
HadoopMigration |
|
Migra sus clústeres de Hadoop en las instalaciones a Amazon EMR. Para obtener más información, consulte Uso de Apache Hadoop como origen para AWS SCT. |
HadoopResumeMigration |
|
Reanuda una migración interrumpida del clúster de Hadoop en las instalaciones a Amazon EMR. Para obtener más información, consulte Uso de Apache Hadoop como origen para AWS SCT. |
Informatica |
|
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 Convertir los scripts de ETL de Informatica. |
LanguageSpecificAppConversion |
|
Convierte el código SQL incrustado en sus aplicaciones de C#, C++, Java y Pro*C con el conversor de aplicaciones de AWS SCT . Para obtener más información, consulte Convertir el SQL de las aplicaciones. |
OozieConversion |
|
Convierte sus flujos de trabajo de Apache Oozie en AWS Step Functions. Para obtener más información, consulte Usar Apache Oozie como origen para AWS SCT. |
RedshiftAgent |
|
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 de un almacén de datos a Amazon Redshift. |
ReportCreation |
|
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 de migración. |
SQL ScriptConversion |
|
Convierte los scripts de SQL*Plus o TSQL a PL/SQL y guarda los scripts convertidos. 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.
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 Descarga de los controladores de base de datos necesarios.
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 Creación de reglas de asignación.
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
Abra el
ConversionTemplate.sctsque descargó. Para obtener más información, consulte Ejemplos.Elimine CreateFiltery convierta las operaciones ApplyToTarget -filter, -filter, SaveTargetSQLLbyStatement, SaveTargetSQ y SaveReportCSV del script.
Para oracle_driver_file en la SetGlobalSettingsoperación, introduzca la ruta del controlador de Oracle. A continuación, en postgresql_driver_file, 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 SetGlobalSettingsoperación, consulte la matriz de ajustes globales del. Material de referencia
(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:\tempsin solicitar derechos de administrador.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.
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.
(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
sourceTreePathytargetTreePathpara especificar la ruta a los objetos de la base de datos. Si lo desea, puede utilizarsourceNamePathytargetNamePathpara 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.Los valores predeterminados de la AddServerMappingoperación asignan todos los esquemas de origen a la base de datos de destino.
Guarde el archivo y, a continuación, utilice el modo script para ejecutarlo. Para obtener más información, consulte Modo script.
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, sustituya file_path por la ruta del archivo con un script.
Para ejecutar un script AWS SCT CLI, utilice el siguiente comando en Linux.
RunSCTBatch.sh --pathtoscts "file_path"
En el ejemplo anterior, sustituya file_path por la ruta del archivo con 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 enMaterial de referencia.
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
