Diferenças entre sfsql e SnowSQL¶

SnowSQL (snowsql) provides many improvements and enhancements over the sfsql command-line interface, including more intuitive option and command names. This topic lists differences in usage between the two command-line clients.

Neste tópico:

Command-line options¶

Many of the command-line options in SnowSQL are backward-compatible with the corresponding options in sfsql; however, there are key differences, as described in the following table:

Opção	`sfsql`	SnowSQL (`snowsql`)
Identificador da conta	`-a`	`-a` , `--accountname`
Nome do usuário	`-u`	`-u` , `--username`
Senha	`-c`	N/D (use a variável de ambiente SNOWSQL_PWD)
Solicitação de senha	N/A	`-P`
Banco de dados	`-d`	`-d` , `--dbname`
Esquema	`-s`	`-s` , `--schemaname`
Warehouse	`-w`	`-w` , `--warehouse`
Função	`-r`	`-r` , `--rolename`
Nome do host	`-g`	`-h` , `--host`
Número da porta	`-p`	`-p` , `--port`
Código MFA	`-m`	`-m` , `--mfa-passcode`
Código MFA na senha	`-n`	`--mfa-passcode-in-password`
Explicar instrução SQL	`-e` (sem suporte)	N/A
Explicar SQL em formato de ponto	`-x` (sem suporte)	N/A
Executar um arquivo SQL.	`-f`	`-f` , `--filename`
Parar no erro	N/A	`-o stop_on_error=true`
Sair no erro	`-k`	`-o exit_on_error=true`
Autenticador	`-b`	`--authenticator`
Usar uma conexão definida pelo usuário	N/A	`-c` , `--connection`
Nível de rastreamento	`-t`	`-o log_level=(INFO\|DEBUG)`
Mostrar a versão do CLI	N/A	`-v` , `--version`
Usar configuração especificada	N/A	`--config`
Definir opções	N/A	`-o` , `--option`
Definir variáveis	N/A	`-D` , `--variable`
Ajuda	`-h`	`-?` , `--help`

Comandos¶

Nos comandos, a principal diferença é que todos os comandos no SnowSQL devem ter um ponto de exclamação como prefixo (por exemplo, !exit). Além disso, os nomes de alguns comandos foram alterados.

Comando	`sfsql`	SnowSQL (`snowsql`)
Carregar e executar um arquivo SQL.	`load` , `@`	`!source`, `!load`
Imprimir uma mensagem	`echo`	`!print`
Definir uma opção	N/A	`!set`
Mostrar todas as opções	N/A	`!options`
Definir uma variável	`set-var`	`!define`
Remover definição de uma variável	`unset-var`	N/A
Mostrar todas as variáveis	N/A	`!variables`
Conectar e iniciar uma nova sessão	`connect`	`!connect`
Sair da sessão atual	N/A	`!exit`, `!disconnect` (consulte também `!quit`)
Spool da saída para um arquivo	`spool`	`!spool`
Sair do CLI	`exit` , `quit`	`!quit`
Executar um comando de sistema	`system`	`!system`
Ajuda	`help`	`!help`

Caracteres especiais¶

Os seguintes caracteres têm um significado especial nos dois clientes:

Uso	`sfsql`	SnowSQL (`snowsql`)
Prefixo de nomes de variáveis	`$`	`&&`
Incluir comentários no código	`#`	`--` e `/* ... */`