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.
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.
Rubriques
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'-type
option.
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 |
|
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 |
|
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 |
|
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 |
|
Migre votre cluster Hadoop sur site vers Amazon EMR. Pour plus d’informations, consultez Utilisation d'Apache Hadoop comme source pour AWS SCT. |
HadoopResumeMigration |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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'ConversionApply
opé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'ConversionApply
opé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'ConversionApply
opération
Ouvrez le fichier
ConversionTemplate.scts
que vous avez téléchargé. Pour plus d’informations, consultez Exemples.Supprimez CreateFilter, convertissez les opérations ApplyToTarget -filter, -filter, SaveTargetSQLLbyStatement, SaveTargetSQ et SaveReportCSV de votre script.
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.
(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.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.
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.
(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ètressourceTreePath
et pour spécifier le chemin d'accès aux objets de base de données. Vous pouvez éventuellement utilisersourceNamePath
ettargetNamePath
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.
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'.scts
extension.
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'PATH
environnement de votre système d'exploitation. Après avoir mis à jour la variable d'PATH
environnement, 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