SnowConvert : interface de ligne de commande¶
Démarrage rapide¶
Pour exécuter une conversion avec la CLI SnowConvert, vous devez disposer d’un code d’accès actif. Actuellement, les codes d’accès de la CLI sont différents de ceux de l’UI, mais si vous avez déjà un code d’accès pour l’UI, vous devriez pouvoir le réutiliser. Dans la section ci-dessous, nous montrons commentinstaller un code d’accès.
Il existe plusieurs Arguments de ligne de commande documentés ci-dessous, mais les principaux sont -i
pour le dossier d’entrée et -o
pour le dossier de sortie.
Installation d’un code d’accès¶
Pour installer un code d’accès, il suffit d’exécuter le programme de la CLI SnowConvert avec l’argument install-ac
et le code d’accès.
$: snowct install-ac <access-code>
Commandes utiles de la CLI¶
snowct --help ou snowct -h
: affiche l’aide.snowct --version ou snowct -v
:
affiche la version de la CLI (et des processeurs de code).snowct install-ac <access-code> :
installe le code d’accès correspondant fourni.snowct install-ac --file <file-with-access-code> :
installe le code d’accès correspondant dans la machine (à l’aide d’un fichier de code d’accès).snowct show-ac :
affiche les codes d’accès actifs actuellement installés.snowct {Language} -i ./input -o ./output :
convertit le code d’entrée.Langages pris en charge : Teradata, Oracle, SQL-server.
Vous pouvez consulter l’aide pour une commande spécifique en utilisant les options -h ou –help. Par exemple :
snowct install-ac –help
snowct show-ac –help
snowct teradata –help
Arguments courants de la CLI¶
Les arguments suivants peuvent être utilisés dans toutes les langages
-i, --input <PATH>
(Obligatoire)¶
Le chemin d’accès au dossier ou au fichier contenant le code source de l’entrée.
-o, --output <PATH>
(Obligatoire)¶
Le chemin vers le dossier de sortie où seront stockés le code et les rapports convertis.
-t, --PLTargetLanguage <TARGET_LANGUAGE>
¶
Valeur de chaîne spécifiant le langage cible pour la conversion des procédures stockées et des macros. Ceux pris en charge actuellement sont : SnowScript et JavaScript. La valeur par défaut est définie sur SnowScript.
-e, --encoding <CODE PAGE>
¶
Le numéro de page du code d’encodage est utilisé pour l’analyse des fichiers sources. Nous n’acceptons que les encodages pris en charge par .NET Core. Voici ceux qui sont pris en charge actuellement :
Code Page | Name | Display Name |
---|---|---|
Code Page | Name | Display Name |
1200 | utf-16 | Unicode |
1201D | unicodeFFFE | Unicode (Big endian) |
12000 | utf-32 | Unicode (UTF-32) |
12001 | utf-32BE | Unicode (UTF-32 Big endian) |
20127 | us-ascii | US-ASCII |
28591 | iso-8859-1 | Western European (ISO) |
65000 | utf-7 | Unicode (UTF-7). Not available in .NET 5 |
65001 | utf-8 | Unicode (UTF-8). Default encoding |
-s, --customschema <SCHEMA_NAME>
¶
La valeur de chaîne spécifie le nom du schéma personnalisé à appliquer. S’il n’est pas spécifié, le nom de la base de données d’origine sera utilisé. Exemple : DB1. _ MyCustomSchema _.Table1.
-d, --database <DB_NAME>
¶
La valeur de chaîne indique le nom de la base de données personnalisée à appliquer. Exemple : _ MyCustomDB _.PUBLIC Table1.
--useExistingNameQualification
Cet indicateur doit être utilisé conjointement avec les paramètres -d
ou -s
. Lorsqu’il est utilisé, il préserve la qualification du nom existant dans le code d’entrée lors de l’utilisation des paramètres précédents. \ Jetons un coup d’œil à cet exemple où -s newSchema
a été inclus :
SELECT * FROM mySchema.myObject;
``` none
```none
SELECT * FROM newSchema.myObject;
``` none
```none
SELECT * FROM mySchema.myObject;
Il en va de même pour les bases de données.
--rate
¶
La valeur de chaîne spécifie le mode du taux de conversion. Les éléments actuellement pris en charge sont les suivants : LoC (Lignes de code) et Caractère. La valeur par défaut est définie sur LoC.
-m, --comments
¶
Indicateur signalant si l’utilisateur souhaite commenter les nœuds dont les dépendances sont manquantes.
--disableEWIsGeneration
¶
Indicateur signalant si les commentaires EWIs (erreurs, avertissements et problèmes) ne seront pas générés sur le code converti. La valeur par défaut est false.
--terms
¶
Afficher les informations relatives aux conditions d’accès.
--help
¶
Affichez les informations d’aide.
Paramètres supplémentaires¶
Chaque outil dispose de ses propres paramètres facultatifs que vous pouvez fournir afin de personnaliser la conversion/l’évaluation.
Consultez les liens suivants pour en savoir plus sur les paramètres supplémentaires disponibles pour chaque outil :