Diferenças entre sfsql e SnowSQL¶

O SnowSQL (snowsql) oferece muitas melhorias e aperfeiçoamentos em relação à interface de linha de comando sfsql, incluindo nomes de opções e de comandos mais intuitivos. Este tópico lista as diferenças de uso entre os dois clientes de linha de comando.

Neste tópico:

Opções de linha de comando¶

Muitas das opções de linha de comando no SnowSQL são compatíveis com as opções correspondentes no sfsql. No entanto, existem diferenças importantes, conforme mostrado na tabela a seguir:

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 `/* ... */`