CLIRéférence pour AWS Schema Conversion Tool - AWS Schema Conversion Tool
PrérequisMode interactifObtenir CLI des scénariosCLIScénarios d'éditionMode scriptMatériel de référence

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

CLIRéférence pour AWS Schema Conversion Tool

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 AWS SCT CLI commandes, 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 de plus amples informations, veuillez consulter Installation AWS Schema Conversion Tool.

AWS SCT CLImode interactif

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 CLI les commandes ou télécharger les CLI scénarios les plus courants.

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 dans ce AWS SCT CLI mode. Pour de plus amples informations, veuillez consulter Mode script.

Vous pouvez exécuter les AWS SCT CLI commandes depuis le app dossier correspondant à 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 passer en mode AWS SCT CLI interactif, utilisez la commande suivante après avoir rempli les conditions requises.

java -jar AWSSchemaConversionToolBatch.jar -type interactive

Vous pouvez maintenant exécuter AWS SCT CLI des commandes. 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 AWS SCT CLI interactif, exécutez la commande suivante.

help
/

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

help -command: 'command_name'
/

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

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

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

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

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

ExecuteFile -file: 'file_path'
/

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

Pour quitter le mode AWS SCT CLI interactif, 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 AWS SCT CLI des scénarios

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 AWS SCT CLI interactif. Pour de plus amples informations, veuillez consulter 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 avec l'un des types de modèles du tableau suivant. Ensuite, remplacez file_path avec 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 AWS SCT CLI modèles, exécutez la commande précédente sans l'-typeoption.

Le tableau suivant indique les types de AWS SCT CLI modèles 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

BTEQScriptConversion

BTEQScriptConversionTemplate.scts

Convertit Teradata Basic Teradata Query (BTEQ), FastExport FastLoad, et les MultiLoad scripts en Amazon Redshift. RSQL Pour de plus amples informations, veuillez consulter Conversion de données à l'aide de 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 SQL script et enregistre le rapport d'évaluation. Pour de plus amples informations, veuillez consulter Conversion de schémas.

GenericAppConversion

GenericApplicationConversionTemplate.scts

Convertit SQL le code intégré à vos applications à l'aide du convertisseur AWS SCT d'applications générique. Pour de plus amples informations, veuillez consulter SQLcode.

HadoopMigration

HadoopMigrationTemplate.scts

Migre votre cluster Hadoop sur site vers Amazon. EMR Pour de plus amples informations, veuillez consulter Connexion aux bases de données Apache Hadoop à l'aide du AWS Schema Conversion Tool.

HadoopResumeMigration

HadoopResumeMigrationTemplate.scts

Reprend une migration interrompue de votre cluster Hadoop sur site vers Amazon. EMR Pour de plus amples informations, veuillez consulter Connexion aux bases de données Apache Hadoop à l'aide du AWS Schema Conversion Tool.

Informatica

InformaticaConversionTemplate.scts

Convertit SQL le code intégré dans vos scripts Informatica extract, transform et load (ETL). Configure les connexions à vos bases de données source et cible dans vos ETL scripts, et enregistre les scripts convertis après la conversion. Pour de plus amples informations, veuillez consulter Scripts Informatica ETL.

LanguageSpecificAppConversion

LanguageSpecificAppConversionTemplate.scts

Convertit SQL le code intégré dans vos applications C#, C++, Java et Pro*C à l'aide du AWS SCT convertisseur d'applications. Pour de plus amples informations, veuillez consulter Application de conversion SQL.

OozieConversion

OozieConversionTemplate.scts

Convertit vos flux de travail Apache Oozie en. AWS Step Functions Pour de plus amples informations, veuillez consulter Connexion aux flux de travail Apache Oozie à l'aide du AWS Schema Conversion Tool.

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 de plus amples informations, veuillez consulter Migration depuis un entrepôt de données.

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 en tant que PDF fichier CSV of. Pour de plus amples informations, veuillez consulter Rapport d’évaluation.

SQLScriptConversion

SQLScriptConversionTemplate.scts

Convertit les TSQL scripts SQL *Plus ou en PL/ SQL et enregistre les scripts convertis. Enregistre également un rapport d'évaluation.

Après avoir téléchargé le AWS SCT CLI modèle, 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 AWS SCT CLI script pour exécuter votre script. Pour de plus amples informations, veuillez consulter AWS SCT CLImode script.

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'
/

AWS SCT CLIScénarios d'édition

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 de plus amples informations, veuillez consulter Installation de JDBC pilotes pour AWS Schema Conversion Tool.

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 de plus amples informations, veuillez consulter Cartographie des types de données.

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 SQL Postgre. Vous prévoyez ensuite d'enregistrer votre rapport d'évaluation de la migration de base de données sous forme de PDF fichier 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. Pour modifier votre AWS SCT CLI modèle, procédez comme suit.

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

  1. Ouvrez le fichier ConversionTemplate.scts que vous avez téléchargé. Pour de plus amples informations, veuillez consulter Exemples.

  2. Supprimez CreateFilter, convertissez -filter, ApplyToTarget -filter et SaveTargetSQLbyStatementles SaveReportCSVopérations de votre script. SaveTargetSQL

  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 Postgre. SQL

    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 des targetTreePath 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 de plus amples informations, veuillez consulter Mode script.

AWS SCT CLImode script

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

Vous pouvez exécuter AWS SCT CLI des scripts depuis le app dossier correspondant à 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 AWS SCT CLI des scripts depuis n'importe quel dossier.

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

RunSCTBatch.cmd --pathtoscts "file_path"

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

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

RunSCTBatch.sh --pathtoscts "file_path"

Dans l'exemple précédent, remplacez file_path avec le chemin d'accès à votre fichier à l'aide d'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 CLImatériel de référence

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