AWS SCT Référence CLI

Cette section décrit comment démarrer avec l'interface de ligne de AWS SCT commande (CLI). Cette section fournit également des informations sur les raccourcis clavier et les modes d'utilisation. Pour une référence complète des commandes AWS SCT CLI, voirMatériel de référence.

Conditions préalables à l'utilisation de l'interface de ligne de AWS SCT commande

Téléchargez et installez la dernière version d'Amazon Corretto 11. Pour plus d'informations, consultez la section Téléchargements pour Amazon Corretto 11 dans le guide de l'utilisateur d'Amazon Corretto 11.

Téléchargez et installez la dernière version de AWS SCT. Pour plus d’informations, consultez Installation AWS SCT.

AWS SCT Mode interactif CLI

Vous pouvez utiliser l'interface de ligne de AWS SCT commande en mode interactif. Dans ce mode, vous entrez les commandes une par une dans la console. Vous pouvez utiliser ce mode interactif pour en savoir plus sur les commandes de la CLI ou pour télécharger les scénarios de CLI les plus couramment utilisés.

Pour convertir le schéma de votre base de données source AWS SCT, exécutez une opération séquentielle : créez un nouveau projet, connectez-vous aux bases de données source et cible, créez des règles de mappage et convertissez des objets de base de données. Ce flux de travail pouvant être complexe, nous vous recommandons d'utiliser des scripts en mode AWS SCT CLI. Pour plus d’informations, consultez Mode script.

Vous pouvez exécuter les commandes AWS SCT CLI depuis le app dossier de votre chemin AWS SCT d'installation. Sous Windows, le chemin d'installation par défaut estC:\Program Files\AWS Schema Conversion Tool\. Assurez-vous que ce dossier inclut le AWSSchemaConversionToolBatch.jar fichier.

Pour accéder au mode interactif de la AWS SCT CLI, utilisez la commande suivante après avoir rempli les conditions requises.

java -jar AWSSchemaConversionToolBatch.jar -type interactive

Vous pouvez maintenant exécuter des commandes AWS SCT CLI. Assurez-vous de terminer vos commandes par / une nouvelle ligne. Assurez-vous également d'utiliser des guillemets simples (') avant et après les valeurs des paramètres de commande.

Note

Si la commande précédente revientUnexpected error, essayez ce qui suit :

java -Djdk.jar.maxSignatureFileSize=20000000 -jar AWSSchemaConversionToolBatch.jar

Pour voir la liste des commandes disponibles en mode interactif de la AWS SCT CLI, exécutez la commande suivante.

help
/

Pour afficher les informations relatives à une commande AWS SCT CLI, utilisez la commande suivante.

help -command: 'command_name'
/

Dans l'exemple précédent, remplacez command_name par le nom d'une commande.

Pour afficher les informations relatives aux paramètres d'une commande AWS SCT CLI, utilisez la commande suivante.

help -command: 'command_name' -parameters: 'parameters_list'
/

Dans l'exemple précédent, remplacez command_name par le nom d'une commande. Remplacez ensuite parameters_list par une liste de noms de paramètres séparés par une virgule.

Pour exécuter un script à partir d'un fichier en mode interactif AWS SCT CLI, utilisez la commande suivante.

ExecuteFile -file: 'file_path'
/

Dans l'exemple précédent, remplacez file_path par le chemin d'accès à votre fichier par un script. Assurez-vous que votre fichier possède une .scts extension.

Pour quitter le mode interactif de la AWS SCT CLI, exécutez la quit commande.

Exemples

L'exemple suivant affiche les informations relatives à la Convert commande.

help -command: 'Convert'
/

L'exemple suivant affiche les informations relatives à deux paramètres de la Convert commande.

help -command: 'Convert' -parameters: 'filter, treePath'
/

Obtenir des scénarios AWS SCT CLI

Pour obtenir les AWS SCT scénarios les plus couramment utilisés, vous pouvez utiliser la GetCliScenario commande. Vous pouvez exécuter cette commande en mode interactif, puis modifier les modèles téléchargés. Utilisez les fichiers édités en mode script.

La GetCliScenario commande enregistre le modèle sélectionné ou tous les modèles disponibles dans le répertoire spécifié. Le modèle contient l'ensemble complet des commandes permettant d'exécuter un script. Assurez-vous de modifier les chemins de fichiers, les informations d'identification de base de données, les noms des objets et les autres données de ces modèles. Assurez-vous également de supprimer les commandes que vous n'utilisez pas et d'ajouter de nouvelles commandes au script si nécessaire.

Pour exécuter la GetCliScenario commande, remplissez les conditions requises et passez en mode interactif AWS SCT CLI. Pour plus d’informations, consultez Mode interactif.

Ensuite, utilisez la syntaxe suivante pour exécuter la GetCliScenario commande et obtenir les AWS SCT scénarios.

GetCliScenario -type: 'template_type' -directory: 'file_path'
/

Dans l'exemple précédent, remplacez template_type par l'un des types de modèles du tableau suivant. Remplacez ensuite file_path par le chemin du dossier dans lequel vous souhaitez télécharger les scripts. Assurez-vous qu'il AWS SCT peut accéder à ce dossier sans demander de droits d'administrateur. Assurez-vous également d'utiliser des guillemets simples (') avant et après les valeurs des paramètres de commande.

Pour télécharger tous les modèles de AWS SCT CLI, exécutez la commande précédente sans l'-typeoption.

Le tableau suivant indique les types de modèles de AWS SCT CLI que vous pouvez télécharger. Pour chaque modèle, le tableau inclut le nom du fichier et la description des opérations que vous pouvez exécuter à l'aide du script.

Type de modèle	Nom de fichier	Description
BTEQ ScriptConversion	BTEQScriptConversionTemplate.scts	Convertit les requêtes Teradata Basic (BTEQ), FastExport, FastLoad et les scripts Teradata Query en MultiLoad Amazon Redshift RSQL. Pour plus d’informations, consultez Conversion de processus ETL.
ConversionApply	ConversionTemplate.scts	Convertit les schémas de base de données source et applique le code converti à la base de données cible. Le cas échéant, enregistre le code converti sous forme de script SQL et enregistre le rapport d'évaluation. Pour plus d’informations, consultez Conversion de schémas de base de données.
GenericAppConversion	GenericApplicationConversionTemplate.scts	Convertit le code SQL intégré à vos applications à l'aide du convertisseur AWS SCT d'applications générique. Pour plus d’informations, consultez Conversion de code SQL dans vos applications.
HadoopMigration	HadoopMigrationTemplate.scts	Migre votre cluster Hadoop sur site vers Amazon EMR. Pour plus d’informations, consultez Utilisation d'Apache Hadoop comme source pour AWS SCT.
HadoopResumeMigration	HadoopResumeMigrationTemplate.scts	Reprend une migration interrompue de votre cluster Hadoop sur site vers Amazon EMR. Pour plus d’informations, consultez Utilisation d'Apache Hadoop comme source pour AWS SCT.
Informatica	InformaticaConversionTemplate.scts	Convertit le code SQL intégré dans vos scripts d'extraction, de transformation et de chargement (ETL) Informatica. Configure les connexions à vos bases de données source et cible dans vos scripts ETL, et enregistre les scripts convertis après la conversion. Pour plus d’informations, consultez Conversion de scripts ETL Informatica.
LanguageSpecificAppConversion	LanguageSpecificAppConversionTemplate.scts	Convertit le code SQL intégré dans vos applications C#, C++, Java et Pro*C à l'aide du AWS SCT convertisseur d'applications. Pour plus d’informations, consultez Nom de l'application..
OozieConversion	OozieConversionTemplate.scts	Convertit vos flux de travail Apache Oozie en. AWS Step Functions Pour plus d’informations, consultez Utiliser Apache Oozie comme source pour AWS SCT.
RedshiftAgent	DWHDataMigrationTemplate.scts	Convertit les schémas d'entrepôt de données source et applique le code converti à la base de données Amazon Redshift cible. Enregistre ensuite un agent d'extraction de données, crée et lance une tâche de migration de données. Pour plus d’informations, consultez Migration d'un entrepôt de données vers Amazon Redshift.
ReportCreation	ReportCreationTemplate.scts	Crée un rapport de migration de base de données pour plusieurs schémas de base de données source. Enregistre ensuite ce rapport au format CSV ou PDF. Pour plus d’informations, consultez Rapports d'évaluation des migrations.
SQL ScriptConversion	SQLScriptConversionTemplate.scts	Convertit les scripts SQL*Plus ou TSQL en PL/SQL et enregistre les scripts convertis. Enregistre également un rapport d'évaluation.

Après avoir téléchargé le modèle de AWS SCT CLI, utilisez l'éditeur de texte pour configurer le script afin qu'il s'exécute sur vos bases de données source et cible. Utilisez ensuite le mode script AWS SCT CLI pour exécuter votre script. Pour plus d’informations, consultez AWS SCT Mode script CLI.

Exemples

L'exemple suivant télécharge tous les modèles dans le C:\SCT\Templates dossier.

GetCliScenario -directory: 'C:\SCT\Templates'
/

L'exemple suivant télécharge le modèle de l'ConversionApplyopération dans le C:\SCT\Templates dossier.

GetCliScenario -type: 'ConversionApply' -directory: 'C:\SCT\Templates'
/

Modification de scénarios AWS SCT CLI

Après avoir téléchargé les modèles de scénario, configurez-les pour obtenir des scripts fonctionnels pouvant être exécutés sur vos bases de données.

Pour tous les modèles, assurez-vous de fournir le chemin d'accès aux pilotes de vos bases de données source et cible. Pour plus d’informations, consultez Téléchargement des pilotes de base de données requis.

Assurez-vous d'inclure les informations d'identification de base de données pour les bases de données source et cible. Assurez-vous également de configurer des règles de mappage pour décrire une paire source-cible pour votre projet de conversion. Pour plus d’informations, consultez Création de règles de mappage.

Configurez ensuite l'étendue des opérations à exécuter. Vous pouvez supprimer les commandes que vous n'utilisez pas ou ajouter de nouvelles commandes au script.

Supposons, par exemple, que vous envisagiez de convertir tous les schémas de votre base de données Oracle source en PostgreSQL. Vous prévoyez ensuite d'enregistrer le rapport d'évaluation de la migration de votre base de données au format PDF et d'appliquer le code converti à la base de données cible. Dans ce cas, vous pouvez utiliser le modèle pour l'ConversionApplyopération. Utilisez la procédure suivante pour modifier votre modèle de AWS SCT CLI.

Pour modifier le modèle de AWS SCT CLI pour l'ConversionApplyopération

1. Ouvrez le fichier ConversionTemplate.scts que vous avez téléchargé. Pour plus d’informations, consultez Exemples.

2. Supprimez CreateFilter, convertissez les opérations ApplyToTarget -filter, -filter, SaveTargetSQLLbyStatement, SaveTargetSQ et SaveReportCSV de votre script.

3. Pour oracle_driver_file dans l'SetGlobalSettingsopération, entrez le chemin d'accès à votre pilote Oracle. Ensuite, pour postgresql_driver_file, entrez le chemin d'accès à votre pilote PostgreSQL.

   Si vous utilisez d'autres moteurs de base de données, utilisez des noms appropriés pour les paramètres. Pour obtenir la liste complète des paramètres globaux que vous pouvez définir dans le cadre de l'SetGlobalSettingsopération, voir la matrice des paramètres globaux dans leMatériel de référence.

4. (Facultatif) Pour CreateProject, entrez le nom de votre projet et l'emplacement de votre fichier de projet local. Si vous choisissez de continuer avec les valeurs par défaut, assurez-vous qu'il est AWS SCT possible de créer des fichiers dans le C:\temp dossier sans demander de droits d'administrateur.

5. Pour AddSource, entrez l'adresse IP de votre serveur de base de données source. Entrez également le nom d'utilisateur, le mot de passe et le port pour vous connecter à votre serveur de base de données source.

6. Pour AddTarget, entrez l'adresse IP de votre serveur de base de données cible. Entrez également le nom d'utilisateur, le mot de passe et le port pour vous connecter à votre serveur de base de données cible.

7. (Facultatif) Pour AddServerMapping, entrez les objets de base de données source et cible que vous souhaitez ajouter à une règle de mappage. Vous pouvez utiliser targetTreePath les paramètres sourceTreePath et pour spécifier le chemin d'accès aux objets de base de données. Vous pouvez éventuellement utiliser sourceNamePath et targetNamePath pour spécifier les noms des objets de base de données. Pour plus d'informations, consultez la section Commandes de mappage de serveurs dans leMatériel de référence.

   Les valeurs par défaut de l'AddServerMappingopération mappent tous les schémas source avec votre base de données cible.

8. Enregistrez le fichier, puis utilisez le mode script pour l'exécuter. Pour plus d’informations, consultez Mode script.

AWS SCT Mode script CLI

Après avoir créé un script AWS SCT CLI ou modifié un modèle, vous pouvez l'exécuter à l'aide de la RunSCTBatch commande. Assurez-vous d'enregistrer votre fichier avec le script CLI en tant qu'.sctsextension.

Vous pouvez exécuter des scripts AWS SCT CLI depuis le app dossier de votre chemin AWS SCT d'installation. Sous Windows, le chemin d'installation par défaut estC:\Program Files\AWS Schema Conversion Tool\. Assurez-vous que ce dossier inclut le RunSCTBatch.sh fichier RunSCTBatch.cmd ou. Ce dossier doit également inclure le AWSSchemaConversionToolBatch.jar fichier.

Vous pouvez également ajouter le chemin du RunSCTBatch fichier dans la variable d'PATHenvironnement de votre système d'exploitation. Après avoir mis à jour la variable d'PATHenvironnement, vous pouvez exécuter des scripts AWS SCT CLI à partir de n'importe quel dossier.

Pour exécuter un script AWS SCT CLI, utilisez la commande suivante sous Windows.

RunSCTBatch.cmd --pathtoscts "file_path"

Dans l'exemple précédent, remplacez file_path par le chemin d'accès à votre fichier par un script.

Pour exécuter un script AWS SCT CLI, utilisez la commande suivante sous Linux.

RunSCTBatch.sh --pathtoscts "file_path"

Dans l'exemple précédent, remplacez file_path par le chemin d'accès à votre fichier par un script.

Vous pouvez fournir des paramètres facultatifs dans cette commande, tels que les informations d'identification de la base de données, le niveau de détail dans la sortie de la console, etc. Pour plus d'informations, téléchargez la référence de l'interface de ligne de AWS SCT commande à l'adresseMatériel de référence.

Exemples

L'exemple suivant exécute le ConversionTemplate.scts script dans le C:\SCT\Templates dossier. Vous pouvez utiliser cet exemple sous Windows.

RunSCTBatch.cmd --pathtoscts "C:\SCT\Templates\ConversionTemplate.scts"

L'exemple suivant exécute le ConversionTemplate.scts script dans le /home/user/SCT/Templates répertoire. Vous pouvez utiliser cet exemple sous Linux.

RunSCTBatch.sh --pathtoscts "/home/user/SCT/Templates/ConversionTemplate.scts"

AWS SCT Matériel de référence CLI

Vous trouverez des informations de référence sur l'interface de ligne de AWS Schema Conversion Tool commande (CLI) dans le guide suivant : Référence de la AWS Schema Conversion Tool CLI.