SnowConvert AI - How to use the SnowConvert AI CLI¶

Installation¶

En fonction de votre système d’exploitation, vous pouvez consulter le guide d’installation correspondant :

Commandes¶

Résumé¶

Chaque commande peut être utilisée avec la syntaxe suivante :

snowct [command] [arguments]

Copy

Les commandes disponibles sont listées ci-dessous. Si vous souhaitez consulter l’explication détaillée d’une commande, vous pouvez cliquer sur la commande.

Command	Alias	Description
`install-access-code`	`install-ac`	Install an access code.
`show-access-code`	`show-ac`	Show the installed access code(s).
`teradata`		Perform a Teradata conversion/assessment.
`oracle`		Perform an Oracle conversion/assessment.
`sql-server`		Perform a SQL Server conversion/assessment.
`redshift`		Perform a Redshift conversion/assessment.
`azuresynapse`		Perform an Azure Synapse conversion/assessment.
`sybase`		Perform a Sybase IQ conversion/assessment.
`greenplum`		Perform a Greenplum conversion/assessment.
`postgresql`		Perform a PostgreSQL conversion/assessment.
`netezza`		Perform a Netezza conversion/assessment.
`spark`		Perform a Spark SQL conversion/assessment.
`databricks`		Perform a Databricks SQL conversion/assessment.
`vertica`		Perform a Vertica conversion/assessment.
`hive`		Perform a Hive conversion/assessment.
`--help`	`-h`	Show help.
`--version`	`-v`	Show the version of the tool.

Installation d’un code d’accès¶

Avant de convertir votre code, vous devez installer un code d’accès. Vous pouvez le faire en spécifiant le code d’accès ou en indiquant le chemin d’accès au fichier qui contient les informations relatives au code d’accès (ce qui est utile lors de l’installation du code d’accès sans connexion Internet ou sous des paramètres de pare-feu restrictifs).

Vous pouvez utiliser la commande suivante pour installer le code d’accès en écrivant le code :

snowct install-access-code <access-code>

Copy

Cette commande est équivalente à la commande précédente :

snowct install-ac <access-code>

Copy

Si vous souhaitez installer un code d’accès à l’aide d’un fichier, vous pouvez utiliser l’option --file / -f, comme le montrent les commandes suivantes :

snowct install-access-code --file <path-to-file>
snowct install-access-code -f <path-to-file>
snowct install-a --file <path-to-file>
snowct install-ac -f <path-to-file>

Copy

Note

En cas d’erreur lors de l’installation de la licence, un message d’erreur s’affiche. Si vous avez besoin d’un code d’accès, vous pouvez contacter snowconvert-support@snowflake.com.

Conversion¶

Vous pouvez utiliser les commandes suivantes pour convertir votre code source. Vous devez fournir un chemin d’entrée (où se trouve le code source) et un chemin de sortie (où sera placé le code converti). Il existe une commande différente pour chaque produit :

SnowConvert AI Teradata: teradata
SnowConvert AI Oracle: oracle
SnowConvert AI SQL Server: sql-server
SnowConvert AI Redshift: redshift
SnowConvert AI Azure Synapse: azuresynapse
SnowConvert AI Sybase IQ: sybase
SnowConvert AI Greenplum: greenplum
SnowConvert AI PostgreSQL: postgresql
SnowConvert AI Netezza: netezza
SnowConvert AI Spark SQL: spark
SnowConvert AI Databricks SQL: databricks
SnowConvert AI Vertica: vertica
SnowConvert AI Hive: hive

snowct teradata --input <input-path> --output <output-path> <additional-parameters>
snowct oracle --input <input-path> --output <output-path> <additional-parameters>
snowct sql-server --input <input-path> --output <output-path> <additional-parameters>
snowct redshift --input <input-path> --output <output-path> <additional-parameters>
snowct azuresynapse --input <input-path> --output <output-path> <additional-parameters>
snowct sybase --input <input-path> --output <output-path> <additional-parameters>
snowct greenplum --input <input-path> --output <output-path> <additional-parameters>
snowct postgresql --input <input-path> --output <output-path> <additional-parameters>
snowct netezza --input <input-path> --output <output-path> <additional-parameters>
snowct spark --input <input-path> --output <output-path> <additional-parameters>
snowct databricks --input <input-path> --output <output-path> <additional-parameters>
snowct vertica --input <input-path> --output <output-path> <additional-parameters>
snowct hive --input <input-path> --output <output-path> <additional-parameters>

Copy

Dans chacun de ces cas, vous pouvez utiliser -i au lieu de --input ou -o au lieu de --output. Par exemple, au lieu d’écrire snowct teradata --input <input-path> --output <output-path>, vous pouvez écrire snowct teradata -i <input-path> -o <output-path>.

Each of these commands might also receive additional parameters. In the following links, you can review which additional parameters are available for each product:

Vérification des codes d’accès installés¶

Si vous souhaitez savoir quels sont les codes d’accès installés sur votre ordinateur, vous pouvez utiliser la commande suivante :

snowct show-access-code

Copy

Cette commande est équivalente à la commande précédente :

snowct show-ac

Copy

Cette commande affiche les informations relatives à chaque code d’accès installé sur votre ordinateur.

Vérification de la version de l’outil¶

You can use any of the following commands to check the version of the tool and the version for each code processing engine (SnowConvert AI Teradata, SnowConvert AI Oracle, SnowConvert AI SQL Server):

snowct --version
snowct -v

Copy

Besoin d’aide ?¶

Si vous souhaitez obtenir une aide générale pour la CLI, vous pouvez utiliser les commandes suivantes :

snowct --help
snowct -h

Copy

Vous pouvez obtenir plus d’informations sur une commande en exécutant cette commande :

snowct <command> --help

Copy

For example, you can execute snowct install-access-code --help to get more information about how to install an access code, or you can execute snowct teradata --help to get more information about how to execute conversions using SnowConvert AI Teradata. This will also show information about the additional options that are available for SnowConvert AI Teradata.