Configuração do SnowSQL¶

Seção de parâmetros de conexão¶

Na seção [connections] do arquivo config, você tem a opção de definir os parâmetros de conexão padrão do SnowSQL, por exemplo: identificador de conta, credenciais de login de usuário, e banco de dados e warehouse padrão. Você também pode definir conexões nomeadas para fazer múltiplas conexões simultâneas ao Snowflake ou armazenar conjuntos diferentes de configurações de conexões.

Para obter mais informações, consulte Conexão por meio do SnowSQL.

Seção de opções de configuração¶

Defina o comportamento do SnowSQL adicionando configurações na seção [options] do arquivo config:

[options]
<option_name> = <option_value>

Copy

Onde:

• <nome_opção> é o nome da opção (não diferencia maiúsculas de minúsculas). Se um nome inválido for especificado, o SnowSQL exibe um erro.

• <valor_opção> especifica um valor com suporte (não diferencia maiúsculas de minúsculas) para a opção, conforme descrito abaixo.

+----------------------------+---------------------+------------------------------------------------------------------------------------+
| Name                       | Value               | Help                                                                               |
+----------------------------+---------------------+------------------------------------------------------------------------------------+
| auto_completion            | True                | Displays auto-completion suggestions for commands and Snowflake objects.           |
| client_session_keep_alive  | False               | Keeps the session active indefinitely, even if there is no activity from the user. |
| echo                       | False               | Outputs the SQL command to the terminal when it is executed.                       |
| editor                     | vim                 | Changes the editor to use for the !edit command.                                   |
| empty_for_null_in_tsv      | False               | Outputs an empty string for NULL values in TSV format.                             |
| environment_variables      | ['PATH']            | Specifies the environment variables that can be referenced as SnowSQL variables.   |
|                            |                     | The variable names should be comma separated.                                      |
| execution_only             | False               | Executes queries only.                                                             |
| exit_on_error              | False               | Quits when SnowSQL encounters an error.                                            |
| fix_parameter_precedence   | True                | Controls the precedence of the environment variable and the config file entries    |
|                            |                     | for password, proxy password, and private key phrase.                              |
| force_put_overwrite        | False               | Force PUT command to stage data files without checking whether already exists.     |
| friendly                   | True                | Shows the splash text and goodbye messages.                                        |
| header                     | True                | Outputs the header in query results.                                               |
| insecure_mode              | False               | Turns off OCSP certificate checks.                                                 |
| key_bindings               | emacs               | Changes keybindings for navigating the prompt to emacs or vi.                      |
| log_bootstrap_file         | ~/.snowsql/log_...  | SnowSQL bootstrap log file location.                                               |
| log_file                   | ~/.snowsql/log      | SnowSQL main log file location.                                                    |
| log_level                  | CRITICAL            | Changes the log level (critical, debug, info, error, warning).                     |
| login_timeout              | 120                 | Login timeout in seconds.                                                          |
| noup                       | False               | Turns off auto upgrading SnowSQL.                                                  |
| output_file                | None                | Writes output to the specified file in addition to the terminal.                   |
| output_format              | psql                | Sets the output format for query results.                                          |
| paging                     | False               | Enables paging to pause output per screen height.                                  |
| progress_bar               | True                | Shows progress bar while transferring data.                                        |
| prompt_format              | [user]#[warehou...] | Sets the prompt format. Experimental feature, currently not documented.            |
| sfqid                      | False               | Turns on/off Snowflake query id in the summary.                                    |
| sfqid_in_error             | False               | Turns on/off Snowflake query id in the error message.                              |
| quiet                      | False               | Hides all output.                                                                  |
| remove_comments            | False               | Removes comments before sending query to Snowflake.                                |
| remove_trailing_semicolons | True                | Removes trailing semicolons from SQL text before sending queries to Snowflake.     |
| results                    | True                | If set to off, queries will be sent asynchronously, but no results will be fetched.|
|                            |                     | Use !queries to check the status.                                                  |
| rowset_size                | 1000                | Sets the size of rowsets to fetch from the server.                                 |
|                            |                     | Set the option low for smooth output, high for fast output.                        |
| stop_on_error              | False               | Stops all queries yet to run when SnowSQL encounters an error.                     |
| syntax_style               | default             | Sets the colors for the text of SnowSQL.                                           |
| timing                     | True                | Turns on/off timing for each query.                                                |
| timing_in_output_file      | False               | Includes timing in the output file.                                                |
| variable_substitution      | False               | Substitutes variables (starting with '&') with values.                             |
| version                    | 1.1.70              | Returns SnowSQL version.                                                           |
| wrap                       | True                | Truncates lines at the width of the terminal screen.                               |
+----------------------------+---------------------+------------------------------------------------------------------------------------+

Para ver as descrições de todas as opções válidas, consulte Referência de opções de configuração do SnowSQL (neste tópico).

Seção de variáveis¶

Na seção [variables] do arquivo config, você pode armazenar valores como variáveis para reutilização. Esse recurso permite o uso de valores de banco de dados e definidos pelo usuário e em consultas.

Para obter mais informações, consulte Uso de variáveis.

auto_completion¶

Tipo

Booleano

Descrição

Permite o preenchimento automático contextual. Se habilitada, as funções, nomes de tabelas e variáveis armazenadas no SnowSQL são preenchidas automaticamente no modo interativo.

Padrão

auto_completion=True

client_session_keep_alive¶

Tipo

Booleano

Descrição

Indica se é para forçar um usuário a fazer login novamente após um período de inatividade em uma sessão JDBC ou ODBC. Quando definida como True, o Snowflake mantém a sessão ativa indefinidamente, mesmo que não haja atividade do usuário. Quando definida como False, o usuário deve fazer o login novamente após quatro horas de inatividade.

Padrão

client_session_keep_alive=False

echo¶

Tipo

Booleano

Descrição

Ecoa a entrada local. Quando definida como True, ecoa tanto para stdout como para o arquivo de saída.

Padrão

echo=False

editor¶

Tipo

Cadeia de caracteres (constante)

Descrição

Especifica o editor a ser invocado quando o comando !edit é emitido no SnowSQL. Valores com suporte:

• emacs

• vi

• vim

Padrão

editor=vim

empty_for_null_in_tsv¶

Tipo

Booleano

Descrição

Se habilitada, quando output_format é definida como TSV, o SnowSQL gera uma cadeia de caracteres vazia para cada valor NULL.

Exemplo

empty_for_null_in_tsv=True

environment_variables¶

Tipo

Lista

Descrição

Especifica as variáveis de ambiente a serem definidas nas variáveis do SnowSQL.

Exemplo

environment_variables=PATH,USER,AWS_ACCESS_KEY_ID,AWS_SECRET_ACCESS_KEY

execution_only¶

Tipo

Booleano

Descrição

Se habilitada, o SnowSQL executa consultas sem buscar dados. Essa opção é útil quando você só quer medir os tempos de execução. Observe que os valores retornados incluem a latência de rede e não são os tempos de execução puros no servidor.

Exemplo

execution_only=True

exit_on_error¶

Tipo

Booleano

Descrição

Se habilitada, o SnowSQL é encerrado quando ocorre um erro. Este comportamento é útil para interromper a execução de consultas quando um erro é encontrado.

Exemplo

exit_on_error=True

fix_parameter_precedence¶

Tipo

Booleano

Descrição

Controla a precedência entre as possíveis fontes da senha, da senha de proxy e dos parâmetros da frase-chave privada.

Se o valor for Verdadeiro, a precedência (da mais alta para a mais baixa) é:

• A variável de ambiente ou o parâmetro de linha de comando do SnowSQL.

• Os parâmetros de conexão específicos da conexão, que são os parâmetros na seção de conexão nomeada do arquivo de configuração, por exemplo, a seção [connections.myconnection].

• Os parâmetros de conexão padrão, que são os parâmetros na seção [connections] do arquivo de configuração.

Se o valor for Falso, a precedência (da mais alta para a mais baixa) é:

• Os parâmetros de conexão específicos da conexão, que são os parâmetros na seção de conexão nomeada do arquivo de configuração, por exemplo, a seção [connections.myconnection].

• A variável de ambiente ou o parâmetro de linha de comando do SnowSQL.

• Os parâmetros de conexão padrão, que são os parâmetros na seção [connections] do arquivo de configuração.

Padrão

True

force_put_overwrite¶

Tipo

Booleano

Descrição

Se habilitada, o SnowSQL força o comando PUT a carregar (ou seja, preparar) arquivos de dados de um diretório/pasta local em uma máquina cliente para o estágio interno especificado (ou seja, o Snowflake) sem verificar se os arquivos já existem no estágio. Se os arquivos já estiverem presentes no estágio de destino, o comando PUT substitui os arquivos existentes.

Padrão

force_put_overwrite=False

friendly¶

Tipo

Booleano

Descrição

Se desabilitada, o SnowSQL suprime as mensagens de inicialização e encerramento.

Padrão

friendly=True

header¶

Tipo

Booleano

Descrição

Exibe o cabeçalho na tabela de resultados gerada pelo SnowSQL. Desabilitar essa opção é útil quando você deseja recuperar somente os dados nos resultados.

Pode ser usada com output_format e timing para produzir saída somente de dados.

Padrão

header=True

insecure_mode¶

Tipo

Booleano

Descrição

Ignora as verificações de revogação de certificado usando o OCSP(Online Certificate Status Protocol). Essa opção pode ser utilizada em uma situação de emergência em que nenhum serviço OCSP esteja acessível. O Snowflake recomenda fortemente que você não habilite essa opção, a menos que receba instruções do suporte Snowflake.

Padrão

insecure_mode=False

key_bindings¶

Tipo

Cadeia de caracteres (constante)

Descrição

Atalhos a serem usadas. Possíveis valores:

• emacs: [CTRL]-a é a home (início da linha), [CTRL]-e é end (fim da linha). Todas os atalhos do Emacs para o ambiente REPL estão disponíveis.

• vi: você pode usar todos os recursos de edição modal oferecidos por vi no ambiente REPL.

Observação

O valor não pode ser alterado pelo comando !set durante a sessão do SnowSQL. Em vez disso, defina o valor no arquivo de configuração ou na linha de comando ao conectar-se ao Snowflake.

Padrão

key_bindings=vi

log_bootstrap_file¶

Tipo

Cadeia de caracteres (caminho)

Descrição

Localização do arquivo de log Bootstrap. Se não especificado, log_file é usado como o nome base seguido por _bootstrap. Por exemplo, por padrão, o nome do arquivo de log é log_bootstrap.

Padrão

log_bootstrap_file=~/.snowsql/bootlog

log_file¶

Tipo

Cadeia de caracteres (caminho)

Descrição

Localização de log_file.

Nota

Você deve ter permissões para gravar no diretório pai do arquivo de log ou para modificar a localização do arquivo de log.

Padrão

log_file=~/.snowsql/log

log_level¶

Tipo

Cadeia de caracteres (constante)

Descrição

Nível de log padrão. Possíveis valores: CRITICAL, ERROR, WARNING, INFO, DEBUG.

login_timeout¶

Tipo

Número

Descrição

Tempo limite para login em segundos.

Padrão

login_timeout=120

noup¶

Tipo

Booleano

Descrição

Impede o SnowSQL de baixar e instalar uma nova versão se True. Por padrão, o SnowSQL é atualizado automaticamente para a versão mais recente se nenhuma versão for especificada.

Padrão

noup=False

output_file¶

Tipo

Cadeia de caracteres (caminho e nome do arquivo)

Descrição

Grava a saída no arquivo especificado, além da saída do terminal.

Padrão

Nenhum

output_format¶

Tipo

Cadeia de caracteres (constante)

Descrição

Especifica o formato dos resultados exibidos no terminal. Possíveis valores:

• csv

• expanded

• fancy_grid

• grid

• html

• json

• latex

• latex_booktabs

• mediawiki

• orgtbl

• pipe

• plain

• psql

• rst

• simple

• tsv

Valores recomendados para os resultados tabulares: psql, grid ou fancy_grid

Valores recomendados para resultados somente de dados (usados em combinação com header, timing e friendly definido como False): plain, csv ou tsv

Padrão

output_format=psql

paging¶

Tipo

Booleano

Descrição

Quando a opção está habilitada, pausa a saída pela altura da tela. Esse recurso é útil para a navegação em grandes conjuntos de resultados. Para rolar para baixo, pressione a tecla [ENTER]/[RETURN].

Padrão

paging=False

progress_bar¶

Tipo

Booleano

Descrição

Mostra a barra de progresso durante a transferência de dados.

Padrão

progress_bar=True

prompt_format¶

Tipo

cadeia de caracteres

Descrição

Muda o formato do prompt do SnowSQL.

O prompt do SnowSQL exibe dinamicamente o usuário atual, o warehouse, o banco de dados e o esquema, por padrão. Os tokens dinâmicos são escritos como [<token>], por exemplo [usuário] ou [warehouse]. Você pode alterar a ordem, o delimitador e a cor do objeto Snowflake. Altere a cor do objeto definindo um símbolo de pigmento entre colchetes.

Por exemplo, altere a ordem dos objetos para usuário, banco de dados e esquema e, em seguida, warehouse. Altere o delimitador para um ponto final. Altere o nome do objeto [usuário] para vermelho, os nomes [banco de dados] e [esquema] para verde, e o nome [warehouse] para azul:

prompt_format="[#FF0000][user]@[#00FF00][database][schema][#0000FF][warehouse]"

Copy

Coloque o valor entre aspas para evitar que caracteres «#» sejam interpretados como o início de um comentário.

Padrão

None

quiet¶

Tipo

Booleano

Descrição

Remove todos os dados de saída do terminal, mas continua a exibir mensagens de erro e dados de diagnóstico.

Padrão

quiet=True

remove_comments¶

Tipo

Booleano

Descrição

Retira comentários da saída.

Padrão

remove_comments=False

remove_trailing_semicolons¶

Tipo

Booleano

Descrição

Remove os ponto-e-vírgula finais do texto SQL antes de enviar as consultas para o Snowflake. Observe que a remoção dos ponto-e-vírgula pode impedir que o Snowflake use resultados em cache de diferentes clientes quando o parâmetro de sessão USE_CACHED_RESULT estiver habilitado.

Padrão

remove_trailing_semicolons=True

results¶

Tipo

Booleano

Descrição

Retorna os resultados da consulta. Se False, a consulta é executada de forma assíncrona. Nenhum resultado, inclusive mensagens de erro, é retornado.

Padrão

results=True

rowset_size¶

Tipo

Número

Descrição

Número de linhas a serem buscadas de uma só vez no modo interativo. Em seguida, os resultados são buscado para a saída um conjunto de linhas de cada vez.

Padrão

rowset_size=1000

sfqid¶

Tipo

Booleano

Descrição

Inclui a ID de consulta do Snowflake no resumo do resultado.

Nota: Você também deve definir timing_in_output_file=True para adicionar sqfid ao arquivo de spool.

Padrão

sfqid=False

sfqid_in_error¶

Tipo

Booleano

Descrição

Inclui a ID de consulta do Snowflake em mensagens de erro.

Padrão

sfqid_in_error=False

stop_on_error¶

Tipo

Booleano

Descrição

Quando um erro é encontrado, interrompe a execução da consulta, mas não é encerrado.

Padrão

stop_on_error=False

syntax_style¶

Tipo

Cadeia de caracteres (constante)

Descrição

Define as cores do texto no SnowSQL. Atualmente, o único valor suportado é default.

Padrão

syntax_style=default

timing¶

Tipo

Booleano

Descrição

Especifica se deve exibir o número de linhas produzidas e o tempo consumido pelas instruções SQL executadas. Essa informação é exibida como uma linha de texto sob a tabela de resultados gerada pelo SnowSQL. Se definida como False, a linha de texto sob a tabela de resultados não é exibida.

Pode ser usada em conjunto com header e output_format para produzir saídas somente de dados.

Padrão

timing=True

timing_in_output_file¶

Tipo

Booleano

Descrição

Especifica se os detalhes do tempo de execução devem ser incluídos no arquivo de saída, se a opção output_file estiver configurada. Requer também a definição da opção timing como True.

Se definida como False, a linha de texto sob a tabela de resultados não é incluída no arquivo de saída.

Padrão

timing_in_output_file=False

variable_substitution¶

Tipo

Booleano

Descrição

Substitui as variáveis pelos valores. Consulte Uso de variáveis.

Padrão

variable_substitution=False

wrap¶

Tipo

Booleano

Descrição

Ajusta a saída pela largura do terminal. Se False, as saídas são truncadas.

Padrão

wrap=True