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>
Copy

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 PageNameDisplay Name
Code PageNameDisplay Name
1200utf-16Unicode
1201DunicodeFFFEUnicode (Big endian)
12000utf-32Unicode (UTF-32)
12001utf-32BEUnicode (UTF-32 Big endian)
20127us-asciiUS-ASCII
28591iso-8859-1Western European (ISO)
65000utf-7Unicode (UTF-7). Not available in .NET 5
65001utf-8Unicode (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;
Copy

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 :