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.
CLIReferencia 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 AWS SCT CLI los comandos, 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 Schema Conversion Tool.
AWS SCT CLImodo interactivo
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 utilizar este modo interactivo para obtener más información sobre CLI los comandos o descargar los CLI escenarios 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 este AWS SCT CLI modo. Para obtener más información, consulte Modo script.
Puede ejecutar los AWS SCT CLI comandos 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 AWS SCT CLI interactivo, utilice el siguiente comando después de completar los requisitos previos.
java -jar AWSSchemaConversionToolBatch.jar -type interactive
Ahora puede ejecutar AWS SCT CLI comandos. 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 AWS SCT CLI interactivo, ejecute el siguiente comando.
help /
Para ver información sobre un AWS SCT CLI comando, 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 AWS SCT CLI comando, 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 con una lista de nombres de parámetros separados por una coma.
Para ejecutar un script desde un archivo en modo AWS SCT CLI interactivo, 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 AWS SCT CLI interactivo, 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' /
Obtención de AWS SCT CLI escenarios
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 GetCliScenario comando, complete los requisitos previos y entre en el modo AWS SCT CLI interactivo. 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 con la ruta de la carpeta en la que desea 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 AWS SCT CLI plantillas, ejecute el comando anterior sin la -type opción.
La siguiente tabla incluye los tipos de AWS SCT CLI plantillas 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 |
|---|---|---|
|
BTEQScriptConversion |
|
Convierte Teradata Basic Query (BTEQ), FastExport, FastLoad y los scripts de Teradata a MultiLoad Amazon Redshift. RSQL Para obtener más información, consulte Conversión de datos mediante 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 SQL script y guarda el informe de evaluación. Para obtener más información, consulte Conversión de esquemas. |
GenericAppConversion |
|
Convierte el SQL código incrustado en sus aplicaciones con el conversor de AWS SCT aplicaciones genérico. Para obtener más información, consulte SQLcódigo. |
HadoopMigration |
|
Migra tu clúster de Hadoop local 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. |
HadoopResumeMigration |
|
Reanuda una migración interrumpida del clúster de Hadoop local 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. |
Informatica |
|
Convierte el SQL código incrustado en sus scripts de extracción, transformación y carga () de Informatica. ETL Configura las conexiones a las bases de datos de origen y destino en los ETL scripts y guarda los scripts convertidos tras la conversión. Para obtener más información, consulte Secuencias de comandos de Informatica ETL. |
LanguageSpecificAppConversion |
|
Convierte el SQL código incrustado en sus aplicaciones de C#, C++, Java y Pro*C con el conversor de aplicaciones. AWS SCT Para obtener más información, consulte Aplicación de conversión SQL. |
OozieConversion |
|
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. |
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 desde un almacén de datos. |
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 PDF archivo CSV de datos. Para obtener más información, consulte Informes de evaluación. |
SQLScriptConversion |
|
Convierte SQL *Plus o TSQL scripts a PL/ SQL y guarda los scripts convertidos. Además, guarda un informe de evaluación. |
Tras descargar la AWS SCT CLI plantilla, 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 AWS SCT CLI script para ejecutar el script. Para obtener más información, consulte AWS SCT CLImodo script.
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 AWS SCT CLI escenarios
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 JDBC controladores para AWS Schema Conversion Tool.
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 Mapeo de tipos de datos.
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 SQL Postgre. A continuación, tiene pensado guardar el informe de evaluación de la migración de la base de datos como un 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 AWS SCT CLI plantilla.
Para editar la AWS SCT CLI plantilla de la ConversionApply operación
Abra el
ConversionTemplate.sctsque descargó. Para obtener más información, consulte Ejemplos.Elimine CreateFiltery convierta las SaveReportCSVoperaciones ApplyToTarget -filter SaveTargetSQLSaveTargetSQLbyStatement, -filter y del script.
Para oracle_driver_file en la SetGlobalSettingsoperación, introduzca la ruta del controlador de Oracle. A continuación, para postgresql_driver_file, introduzca la ruta del controlador de Postgre. SQL
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 operación, consulte la matriz de ajustes globales del. SetGlobalSettingsMaterial 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 CLImodo script
Tras crear un AWS SCT CLI script o editar una plantilla, puede ejecutarlo con el RunSCTBatch comando. Asegúrese de guardar el archivo con el CLI script como .scts extensión.
Puede ejecutar AWS SCT CLI scripts 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 los AWS SCT CLI scripts desde cualquier carpeta.
Para ejecutar un AWS SCT CLI script, 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 AWS SCT CLI script, 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 CLImaterial de referencia
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 CLIReferencia
