SnowConvert: Interface da linha de comando

Início rápido

Para executar uma conversão com SnowConvert CLI, você precisa ter um código de acesso ativo. Atualmente, os códigos de acesso para CLI são diferentes daquelas para UI, mas se você já tiver um código de acesso para UI, poderá reutilizar o mesmo código de acesso. Na seção abaixo, mostramos comoinstalar um código de acesso.

Há vários argumentos de linha de comando documentados abaixo, mas os principais são -i para a pasta de entrada e -o para a pasta de saída.

Instalar um código de acesso

Para instalar um código de acesso, basta executar o programa SnowConvert CLI com o argumento install-ac e o código de acesso.

$: 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;
``` none

```none
SELECT * FROM newSchema.myObject;
``` none

```none
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: