Como iniciar e encerrar o sfsql — Obsoleto¶

Este tópico descreve como usar o sfsql para se conectar ao Snowflake, iniciar uma sessão para executar consultas e instruções DDL/DML e encerrar a sessão quando você terminar.

Neste tópico:

Como se conectar ao Snowflake e iniciar uma sessão¶

Para se conectar ao Snowflake e iniciar uma sessão, navegue até o diretório onde o script sfsql está localizado e execute o script usando a seguinte sintaxe.

sfsql [ -u <user> ] [ -c <password> ] [ -d <database> ] [ -s <schema> ] ... [ -h ]

Copy

Nota

Em um ambiente Linux, você deve preceder o nome do script com uma barra pontilhada, por exemplo, ./sfsql. Se você iniciar o cliente a partir de qualquer diretório que não seja o diretório de instalação do client, você também deve incluir o caminho após a barra (/).

Parâmetros¶

Parâmetro de conexão	Equivalente em `login.defaults`	Descrição
`-g <host>`	`GSIP=<host>`	Host/IP para se conectar. Definido como padrão em `login.defaults` quando o cliente foi baixado do Snowflake.
		Formato de `<host>` para contas na região Oeste dos US: `<nome_da_conta>.snowflakecomputing.com`
		Formato de `<host>` para contas em todas as outras regiões: `<nome_conta>.<id_região>.snowflakecomputing.com`
`-a <nome_da_conta>`	`ACCOUNT=<nome>`	Conta Snowflake que será acessada. Definido como padrão em `login.defaults` quando o cliente foi baixado do Snowflake.
`-u <usuário>`	`USER=<nome_de_login>`	Nome de login do usuário que irá se conectar. Se esse parâmetro for especificado, o parâmetro `-c` também deve ser.
`-c <senha>`	`PASSWORD=<senha>`	Senha do usuário.
`-b <autenticador>`	`AUTHENTICATOR=<autenticador>`	Use um IdP em conformidade com o SAML 2.0, em vez do Snowflake, para autenticar.
`-r <função>`	`ROLE=<nome>`	Função a ser usada por padrão para acessar objetos no Snowflake (pode ser alterada após o login).
`-d <banco de dados>`	`DATABASE=<nome>`	Banco de dados a ser usado por padrão (pode ser alterado após o login).
`-s <esquema>`	`SCHEMA=<nome>`	Esquema do banco de dados a ser usado por padrão (pode ser alterado após o login).
`-w <warehouse>`	`WAREHOUSE=<nome>`	Warehouse virtual a ser usado por padrão para consultas, carregamento, etc. (pode ser alterado após o login).
`-f <sqlfile>`	N/A	Executar o arquivo SQL especificado. Se esse parâmetro não for especificado, o cliente se conecta em modo interativo.
`-t`	`TRACING=<nível>`	Nível de registro em log.
`-y <host de proxy>`	`PROXY_HOST=<host>`	Host de proxy HTTP
`-z <porta de proxy>`	`PROXY_PORT=<porta>`	Porta de porta de proxy HTTP.
`-m <código_mfa>`	`PASSCODE=<código_mfa>`	Código MFA.
`-n`	`PASSCODEINPASSWORD=true`	Código MFA embutido na senha.
`-k`	`EXITONERROR=true`	Sair do cliente quando um erro é encontrado.
`-h`	N/A	Ajuda para os parâmetros de login (ou seja, esta lista).

Nota

Se você não especificar um nome de login nem uma senha em login.defaults ou na linha de comando, o cliente solicita que você os insira durante o login.

Se você informar um nome de login ou senha incorretos, o cliente não se conecta ao Snowflake e sai para a linha de comando do shell HenPlus. Você deve então sair do shell (digitando exit, quit ou usando a combinação de teclado [CTRL]-d) antes de tentar entrar novamente no sistema. Ou, no shell HenPlus, você pode digitar connect seguido de uma cadeia de conexão JDBC válida para fazer o login.

Durante o login, o cliente exibe a versão do driver JDBC usado pelo cliente, bem como a última versão disponível do driver (se for diferente da versão em uso). Essas informações podem ser úteis na solução de problemas de clientes.

Após o login bem sucedido, a linha de comando exibe o nome de login de usuário e o host ao qual a sessão está conectada no formulário <nome_de_login>@snowflake:<nome_da_conta>.snowflakecomputing.com.

Exemplo¶

O seguinte exemplo inicia o cliente instalado em um ambiente Linux ou macOS em um diretório chamado /Users/user1 com um usuário Snowflake chamado user1 e a senha 1234567a para a conta xy12345:

$ cd /Users/user1/client
$ ./sfsql -u user1 -c 1234567a

using GNU readline (Brian Fox, Chet Ramey), Java wrapper by Bernhard Bablok
henplus config at /Users/ybrenman/.henplus
----------------------------------------------------------------------------
 HenPlus II 0.9.8 "Yay Labor Day"
 Copyright(C) 1997..2009 Henner Zeller <H.Zeller@acm.org>
 HenPlus is provided AS IS and comes with ABSOLUTELY NO WARRANTY
 This is free software, and you are welcome to redistribute it under the
 conditions of the GNU Public License <http://www.gnu.org/licenses/gpl2.txt>
----------------------------------------------------------------------------
HenPlus II connecting
 url 'jdbc:snowflake://xy12345.snowflakecomputing.com:443/?account=xy12345&user=user1&ssl=on'
 driver version 2.3
 Snowflake - 1.0 (driver change version: 2.3.1, latest change version: 2.4.38)
no transactions.
 No Transaction *

user1@snowflake:xy12345.snowflakecomputing.com>

Copy

Como encerrar uma sessão e sair do cliente¶

Para encerrar a sessão atual do Snowflake e sair do sfsql, digite exit ou quit na linha de comando.

Quando você encerra uma sessão do Snowflake:

Todas as consultas e instruções DDL/DML em processamento são canceladas.
Todas as tabelas temporárias criadas durante a sessão são descartadas.

Nota

Ao digitar [CTRL]-d, você sai do sfsql, mas não fecha o shell HenPlus. Você precisa digitar exit ou quit (ou digitar [CTRL]-d novamente) para fechar a shell HenPlus.