SnowConvert AI - Command Line Interface

Início rápido

To execute a conversion with the SnowConvert AI CLI you have to have an active access code. Currently, the access codes for the CLI are different than the UI, but if you already have an access code for the UI you should be able to reuse the same access code. In the section below we show how to install an access code.

There are several Command Line Arguments documented below, but the main ones are -i for the input folder and -o for the output folder.

Instalar um código de acesso

To install an access code just execute SnowConvert AI CLI program with the install-ac argument and the access code.

$: snowct install-ac <access-code>
Copy

Comandos úteis da CLI

  • snowct --help ou snowct -h: Mostrará a ajuda.

  • snowct --version ou snowct -v : Mostrará a versão da CLI (e os processadores de código).

  • snowct install-ac <access-code>: Instalará o código de acesso correspondente fornecido.

  • snowct install-ac --file <file-with-access-code>: Instalará o código de acesso correspondente na máquina (usando um arquivo de código de acesso).

  • snowct show-ac: Mostra os códigos de acesso ativos instalados no momento.

  • snowct {Language} -i ./input -o ./output: Converterá o código de entrada.

    • Linguagens compatíveis: Teradata, Oracle, SQL Server.

  • Você pode verificar a ajuda de um comando específico usando a opção -h ou –help. Por exemplo:

    • snowct install-ac –help

    • snowct show-ac –help

    • snowct teradata –help

Argumentos comuns da CLI

Os seguintes argumentos podem ser usados em todas as linguagens

-i, --input <PATH> (obrigatório)

O caminho para a pasta ou arquivo que contém o código-fonte de entrada.

-o, --output <PATH> (obrigatório)

O caminho para a pasta de saída onde o código e os relatórios convertidos serão armazenados.

-t, --PLTargetLanguage <TARGET_LANGUAGE>

Valor de cadeia de caracteres que especifica a linguagem de destino para converter procedimentos armazenados e macros. As opções atualmente suportadas são: SnowScript e JavaScript. O valor padrão é definido como SnowScript.

-e, --encoding <CODE PAGE>

O número da página do código de codificação é usado para analisar os arquivos de origem. Só aceitamos codificações compatíveis com o .NET Core. Aqui estão os que são suportados no momento:

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>

O valor da cadeia de caracteres especifica o nome do esquema personalizado a ser aplicado. Se não for especificado, será usado o nome original do banco de dados. Exemplo: DB1._ MyCustomSchema _.Table1.

-d, --database <DB_NAME>

O valor da cadeia de caracteres especifica o nome do banco de dados personalizado a ser aplicado. Exemplo: _ MyCustomDB _.PUBLIC.Table1.

--useExistingNameQualification

Esse sinalizador deve ser usado em conjunto com os parâmetros -d ou -s. Quando usado, ele preserva a qualificação de nome existente no código de entrada quando os parâmetros anteriores são usados. \ Vamos dar uma olhada neste exemplo em que -s newSchema foi incluído:

SELECT * FROM mySchema.myObject;
Copy
SELECT * FROM newSchema.myObject;
Copy
SELECT * FROM mySchema.myObject;
Copy

O mesmo se aplica aos bancos de dados.

--rate

O valor da string especifica o modo da taxa de conversão. Atualmente, são suportados: LoC (Lines of Code) e Character. O valor padrão é definido como LoC.

-m, --comments

Sinalizador para indicar se o usuário deseja comentar sobre nós que têm dependências ausentes.

--disableEWIsGeneration

Sinalizador para indicar se os comentários de EWIs (Erros, Avisos e Problemas) não serão gerados no código convertido. O padrão é false.

--terms

Mostra informações sobre os termos do código de acesso.

--help

Exibe as informações de ajuda.

Parâmetros adicionais

Cada ferramenta tem seus próprios parâmetros opcionais que você pode fornecer para personalizar a conversão/avaliação.

Acesse os links a seguir para saber mais sobre os parâmetros adicionais disponíveis para cada ferramenta: