Instalação do SnowSQL¶

Configuração do diretório de download e local do arquivo de configuração¶

Por padrão, o instalador do SnowSQL baixa os binários para o seguinte diretório:

~/.snowsql

Consequentemente, o arquivo de configuração está localizado no diretório de download:

~/.snowsql/config

Para mudar tanto o diretório de download quanto o local do arquivo de configuração, defina a variável de ambiente WORKSPACE como qualquer diretório gravável pelo usuário. Isto é particularmente útil se você tiver um ambiente SnowSQL isolado para cada processo.

Além disso, você pode separar o diretório de download do arquivo de configuração definindo a variável de ambiente SNOWSQL_DOWNLOAD_DIR para que múltiplos processos SnowSQL possam compartilhar os binários. Por exemplo:

$ SNOWSQL_DOWNLOAD_DIR=/var/shared snowsql -h

Copy

Note que a variável SNOWSQL_DOWNLOAD_DIR é suportada a partir da versão bootstrap 1.1.70 do SnowSQL. Para verificar a versão que você está usando, execute o seguinte comando a partir do prompt da janela do terminal:

$ snowsql --bootstrap-version

Copy

Download do instalador do SnowSQL¶

Vá para a página de Download do SnowSQL, encontre a versão do SnowSQL que você deseja instalar e baixe os arquivos com as seguintes extensões de nome de arquivo:

• .bash (o script do instalador)

• .bash.sig (a assinatura que você pode usar para verificar o pacote baixado)

Uso do curl para baixar o instalador do SnowSQL¶

Se você quiser baixar o instalador de um script ou de uma janela de terminal (por exemplo, usando curl, em vez de seu navegador da web), você pode baixar os instaladores diretamente do Snowflake Client Repository. Para maior flexibilidade, o Snowflake oferece os pontos de extremidade Amazon Web Services (AWS) e Azure para o repositório. As contas hospedadas em qualquer plataforma de nuvem com suporte podem baixar o instalador a partir de qualquer um dos pontos de extremidade.

Execute o curl (ou uma ferramenta de linha de comando equivalente) para fazer o download do instalador. A sintaxe do curl é a seguinte:

Ponto de extremidade AWS:

$ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/<bootstrap_version>/linux_x86_64/snowsql-<version>-linux_x86_64.bash

Copy

Ponto de extremidade Microsoft Azure:

$ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/<bootstrap_version>/linux_x86_64/snowsql-<version>-linux_x86_64.bash

Copy

Onde:

• <version> é a combinação das seguintes versões do SnowSQL: principal, secundária e de patch. Por exemplo, para a versão 1.3.1, a versão principal é a 1, a versão secundária é a 3 e a versão de patch é a 1. Portanto, a versão é 1.3.1.

• <bootstrap_version> é a combinação das versões principal e secundária do SnowSQL. Por exemplo, para a versão 1.3.1, a versão principal é a 1 e a versão secundária é a 3, então a versão bootstrap é 1.3.

Por exemplo, para baixar o instalador do SnowSQL onde <bootstrap_version> é 1.3 e <version> é 1.3.2:

Ponto de extremidade AWS:

$ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/1.3/linux_x86_64/snowsql-1.3.2-linux_x86_64.bash

Ponto de extremidade Microsoft Azure:

$ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/1.3/linux_x86_64/snowsql-1.3.2-linux_x86_64.bash

Para obter mais informações sobre as versões do SnowSQL, consulte Explicação do sistema de versão do SnowSQL (neste tópico).

Verificação da assinatura do pacote¶

Para verificar a assinatura do pacote baixado:

1. Baixe e importe a última versão chave pública GPG do Snowflake a partir da Classic Console ou do servidor de chaves público.

   Download a partir da interface da Web:

   1. Na Classic Console, selecione Help » Download… para exibir a caixa de diálogo Downloads.

   2. Selecione CLI Client (snowsql) à esquerda, depois selecione o ícone Snowflake GPG Public Key à direita.

   Download a partir do servidor de chaves:

   Insira o seguinte comando, usando a chave GPG associada à versão do SnowSQL:

   • Para SnowSQL 1.2.24 e superior:

     $ gpg --keyserver hkp://keyserver.ubuntu.com --recv-keys 630D9F3CAB551AF3

   • Para as versões de 1.2.11 a 1.2.23 do SnowSQL:

     $ gpg --keyserver hkp://keyserver.ubuntu.com --recv-keys 37C7086698CB005C

   • Para as versões de 1.1.75 a 1.2.10 do SnowSQL:

     $ gpg --keyserver hkp://keyserver.ubuntu.com --recv-keys EC218558EABB25A1

   • Para as versões 1.1.74 e inferiores do SnowSQL:

     $ gpg --keyserver hkp://keyserver.ubuntu.com --recv-keys 93DB296A69BE019A

   Nota

   Se esse comando falhar com o seguinte erro:

   gpg: keyserver receive failed: Server indicated a failure
   

   Copy

   depois especifique que você deseja usar a porta 80 para o servidor de chaves:

   gpg --keyserver hkp://keyserver.ubuntu.com:80  ...
   

   Copy

2. Faça o download da assinatura GPG e verifique a assinatura:

   # If you prefer to use curl to download the signature file, run this command:
   curl -O \https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/1.3/linux_x86_64/snowsql-\ |snowsql-version|\ -linux_x86_64.bash.sig
   
   # Verify the package signature.
   gpg --verify snowsql-\ |snowsql-version|\ -linux_x86_64.bash.sig snowsql-\ |snowsql-version|\ -linux_x86_64.bash
   

   Copy

   ou, se você estiver baixando o arquivo de assinatura do ponto de extremidade do Azure:

   # If you prefer to use curl to download the signature file, run this command:
   curl -O \https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/1.3/linux_x86_64/snowsql-\ |snowsql-version|\ -linux_x86_64.bash.sig
   
   # Verify the package signature.
   gpg --verify snowsql-\ |snowsql-version|\ -linux_x86_64.bash.sig snowsql-\ |snowsql-version|\ -linux_x86_64.bash
   

   Copy

   Nota

   A verificação da assinatura produz um aviso semelhante ao seguinte:

   gpg: Signature made Mon 24 Sep 2018 03:03:45 AM UTC using RSA key ID <gpg_key_id>
   gpg: Good signature from "Snowflake Computing <snowflake_gpg@snowflake.net>" unknown
   gpg: WARNING: This key is not certified with a trusted signature!
   gpg: There is no indication that the signature belongs to the owner.
   

   Copy

   Para evitar o aviso, você pode conceder confiança implícita à chave pública GPG do Snowflake.

3. Seu ambiente local pode conter múltiplas chaves GPG. Entretanto, por razões de segurança, o Snowflake alterna periodicamente a chave pública GPG. Nossa prática recomendada é excluir a chave pública existente depois de confirmar que a última chave funciona com o último pacote assinado. Por exemplo:

   gpg --delete-key "Snowflake Computing"
   

   Copy

Instalação do SnowSQL usando o instalador¶

1. Abra uma janela de terminal.

2. Execute o instalador do script Bash a partir do local de download:

   bash snowsql-linux_x86_64.bash
   

   Copy

3. Siga as instruções fornecidas pelo instalador.

SNOWSQL_DEST=~/bin SNOWSQL_LOGIN_SHELL=~/.profile bash snowsql-linux_x86_64.bash

Quando você instala uma nova versão principal ou secundária, o SnowSQL não se atualiza imediatamente. Em vez disso, você deve entrar na sua conta Snowflake usando o SnowSQL e permanecer conectado por um período de tempo suficiente para que o recurso de atualização automática atualize o cliente para a versão mais recente. Para verificar qual versão do SnowSQL está sendo iniciada quando você executa o cliente, use a opção -v sem um valor:

snowsql -v

Copy

Version: 1.3.1

Para forçar o SnowSQL a instalar e usar uma versão específica, use a opção -v e especifique a versão que você deseja instalar. Por exemplo, execute o seguinte comando para a versão 1.3.0:

snowsql -v 1.3.0

Copy

Download do pacote RPM do SnowSQL¶

Vá para a página de Download do SnowSQL, encontre a versão do SnowSQL que você deseja instalar e baixe o arquivo com a extensão do nome de arquivo .rpm.

Instalação do pacote RPM do SnowSQL¶

O arquivo RPM baixado pode ser instalado da mesma forma que outros pacotes RPM são instalados:

rpm -i <package_name>

Configuração do diretório de download e local do arquivo de configuração¶

Por padrão, o instalador do SnowSQL baixa os binários para o seguinte diretório:

~/.snowsql

Consequentemente, o arquivo de configuração está localizado no diretório de download:

~/.snowsql/config

Você pode mudar tanto o diretório de download quanto o local do arquivo de configuração definindo a variável de ambiente WORKSPACE para qualquer diretório gravável pelo usuário. Isto é particularmente útil se você tiver um ambiente SnowSQL isolado para cada processo.

Além disso, você pode separar o diretório de download do arquivo de configuração definindo a variável de ambiente SNOWSQL_DOWNLOAD_DIR para que múltiplos processos SnowSQL possam compartilhar os binários. Por exemplo:

SNOWSQL_DOWNLOAD_DIR=/var/shared snowsql -h

Copy

Note que a variável SNOWSQL_DOWNLOAD_DIR é suportada a partir da versão bootstrap 1.1.70 do SnowSQL. Para verificar a versão que você está usando, execute o seguinte comando a partir do prompt da janela do terminal:

snowsql --bootstrap-version

Copy

Download do instalador do SnowSQL¶

Para baixar o instalador do SnowSQL, vá para a página de Download do SnowSQL. Esta versão do instalador do SnowSQL permite a atualização automática de patches.

Uso do curl para baixar o instalador do SnowSQL¶

Se você quiser baixar o instalador de um script ou de uma janela de terminal (por exemplo, usando curl, em vez de seu navegador da web), você pode baixar os instaladores diretamente do Snowflake Client Repository. Para maior flexibilidade, o Snowflake oferece os pontos de extremidade Amazon Web Services (AWS) e Azure para o repositório. As contas hospedadas em qualquer plataforma de nuvem com suporte podem baixar o instalador a partir de qualquer um dos pontos de extremidade.

Execute o curl (ou uma ferramenta de linha de comando equivalente) para fazer o download do instalador. A sintaxe do curl é a seguinte:

Ponto de extremidade AWS:

curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/<bootstrap_version>/darwin_x86_64/snowsql-<version>-darwin_x86_64.pkg

Copy

Ponto de extremidade Microsoft Azure:

curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/<bootstrap_version>/darwin_x86_64/snowsql-<version>-darwin_x86_64.pkg

Copy

onde:

• <version> é a combinação das seguintes versões do SnowSQL: principal, secundária e de patch. Por exemplo, para a versão 1.3.1, a versão principal é a 1, a versão secundária é a 3 e a versão de patch é a 1. Portanto, a versão é 1.3.1.

• <bootstrap_version> é a combinação das versões principal e secundária do SnowSQL. Por exemplo, para a versão 1.3.1, a versão principal é a 1 e a versão secundária é a 3, então a versão bootstrap é 1.3.

Por exemplo, para baixar o instalador do SnowSQL onde <bootstrap_version> é 1.3 e <version> é 1.3.2:

Ponto de extremidade AWS:

curl -O \https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/1.3/darwin_x86_64/snowsql-\ |snowsql-version|\ -darwin_x86_64.pkg

Copy

Ponto de extremidade Microsoft Azure:

curl -O \https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/1.3/darwin_x86_64/snowsql-\ |snowsql-version|\ -darwin_x86_64.pkg

Copy

Para obter mais informações sobre as versões do SnowSQL, consulte Explicação do sistema de versão do SnowSQL (neste tópico).

O sistema operacional macOS pode verificar a assinatura do instalador automaticamente, portanto a verificação da assinatura GPG não é necessária.

Instalação do SnowSQL usando o instalador¶

1. Abra snowsql-darwin_x86_64.pkg no local de download para executar o arquivo do instalador PKG.

2. Siga as instruções fornecidas pelo instalador.

installer -pkg snowsql-darwin_x86_64.pkg -target CurrentUserHomeDirectory

Quando você instala uma nova versão principal ou secundária, o SnowSQL não se atualiza imediatamente. Em vez disso, você deve entrar na sua conta Snowflake usando o SnowSQL e permanecer conectado por um período de tempo suficiente para que o recurso de atualização automática atualize o cliente para a versão mais recente. Para verificar qual versão do SnowSQL está sendo iniciada quando você executa o cliente, use a opção -v sem um valor:

snowsql -v

Copy

Version: 1.3.0

Para forçar o SnowSQL a instalar e usar uma versão específica, use a opção -v e especifique a versão que você deseja instalar. Por exemplo, execute o seguinte comando para a versão 1.3.1:

snowsql -v 1.3.1

Copy

Configuração do alias Z Shell (apenas macOS)¶

Se o Z shell (também conhecido como zsh) for seu shell de terminal padrão, defina um alias para o executável SnowSQL para que você possa executar o SnowSQL na linha de comando no Terminal. O instalador do SnowSQL instala o executável em /Applications/SnowSQL.app/Contents/MacOS/snowsql e anexa este caminho à entrada PATH ou alias em ~/.profile. Como o zsh normalmente não lê este arquivo, adicione um alias a este caminho em ~/.zshrc, que o zsh pode ler.

Para adicionar um alias ao executável SnowSQL:

1. Abra (ou crie, se inexistente) o arquivo ~/.zshrc.

2. Adicione a seguinte linha:

   alias snowsql=/Applications/SnowSQL.app/Contents/MacOS/snowsql
   

   Copy

3. Salve o arquivo.

Configuração do diretório de download e local do arquivo de configuração¶

Por padrão, o instalador do SnowSQL baixa os binários para o seguinte diretório:

%USERPROFILE%\.snowsql

Consequentemente, o arquivo de configuração está localizado no diretório de download:

%USERPROFILE%\.snowsql\config

Você pode mudar tanto o diretório de download quanto o local do arquivo de configuração definindo a variável de ambiente WORKSPACE para qualquer diretório gravável pelo usuário. Isto é particularmente útil se você tiver um ambiente SnowSQL isolado para cada processo.

Além disso, você pode separar o diretório de download do arquivo de configuração definindo a variável de ambiente SNOWSQL_DOWNLOAD_DIR para que múltiplos processos SnowSQL possam compartilhar os binários. Por exemplo:

SNOWSQL_DOWNLOAD_DIR=/var/shared snowsql -h

Copy

Note que a variável SNOWSQL_DOWNLOAD_DIR é suportada a partir da versão bootstrap 1.1.70 do SnowSQL. Para verificar a versão que você está usando, execute o seguinte comando a partir do prompt da janela do terminal:

snowsql --bootstrap-version

Copy

Download do instalador do SnowSQL¶

Para baixar o instalador do SnowSQL, vá para a página de Download do SnowSQL. Esta versão do instalador do SnowSQL permite a atualização automática de patches.

Uso do curl para baixar o instalador do SnowSQL¶

Se você quiser baixar o instalador de um script ou de uma janela de terminal (por exemplo, usando curl, em vez de seu navegador da web), você pode baixar os instaladores diretamente do Snowflake Client Repository. Para maior flexibilidade, o Snowflake oferece os pontos de extremidade Amazon Web Services (AWS) e Azure para o repositório. As contas hospedadas em qualquer plataforma de nuvem com suporte podem baixar o instalador a partir de qualquer um dos pontos de extremidade.

Execute o curl (ou uma ferramenta de linha de comando equivalente) para fazer o download do instalador. A sintaxe do curl é a seguinte:

Ponto de extremidade AWS:

curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/<bootstrap_version>/windows_x86_64/snowsql-<version>-windows_x86_64.msi

Copy

Ponto de extremidade Microsoft Azure:

curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/<bootstrap_version>/windows_x86_64/snowsql-<version>-windows_x86_64.msi

Copy

Onde:

• <version> é a combinação das seguintes versões do SnowSQL: principal, secundária e de patch. Por exemplo, para a versão 1.3.1, a versão principal é a 1, a versão secundária é a 3 e a versão de patch é a 1. Portanto, a versão é 1.3.1.

• <bootstrap_version> é a combinação das versões principal e secundária do SnowSQL. Por exemplo, para a versão 1.3.1, a versão principal é a 1 e a versão secundária é a 3, então a versão bootstrap é 1.3.

Por exemplo, para baixar o instalador do SnowSQL onde <bootstrap_version> é 1.3 e <version> é 1.3.2:

Ponto de extremidade AWS:

curl -O \https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/1.3/windows_x86_64/snowsql-\ |snowsql-version|\ -windows_x86_64.msi

Copy

Ponto de extremidade Microsoft Azure:

curl -O \https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/1.3/windows_x86_64/snowsql-\ |snowsql-version|\ -windows_x86_64.msi

Copy

Para obter mais informações sobre as versões do SnowSQL, consulte Explicação do sistema de versão do SnowSQL (neste tópico).

O sistema operacional Windows pode verificar a assinatura do instalador automaticamente, portanto a verificação da assinatura GPG não é necessária.

Instalação do SnowSQL usando o instalador¶

1. Abra snowsql-windows_x86_64.msi no local de download para executar o arquivo do instalador MSI.

2. Siga as instruções fornecidas pelo instalador.

C:\Users\<username> msiexec /i snowsql-windows_x86_64.msi /q

Quando você instala uma nova versão principal ou secundária, o SnowSQL não se atualiza imediatamente. Em vez disso, você deve entrar na sua conta Snowflake usando o SnowSQL e permanecer conectado por um período de tempo suficiente para que o recurso de atualização automática atualize o cliente para a versão mais recente. Para verificar qual versão do SnowSQL está sendo iniciada quando você executa o cliente, use a opção -v sem um valor:

snowsql -v

Copy

Version: 1.3.1

Para forçar o SnowSQL a instalar e usar uma versão específica, use a opção -v e especifique a versão que você deseja instalar. Por exemplo, execute o seguinte comando para a versão 1.3.0:

snowsql -v 1.3.0

Copy

O que é a atualização automática?¶

Se você optar por habilitar atualizações automáticas para o SnowSQL, o SnowSQL baixa automaticamente o novo binário em um processo em segundo plano e executa a versão atual. Na próxima vez que você executar o SnowSQL, a nova versão será iniciada.

Para ilustrar o processo:

1. Para fazer uma nova instalação, você baixa o instalador do SnowSQL (por exemplo, a versão 1.3.0) usando a interface da Web do Snowflake e instala o cliente.

2. Cada vez que você executa o SnowSQL, o cliente verifica se uma versão mais recente está disponível no repositório de atualização do SnowSQL.

3. Se uma nova versão (por exemplo, a versão 1.3.1) estiver disponível, o SnowSQL faz o download em segundo plano enquanto a versão instalada atualmente é executada.

4. Na próxima vez que você executar o SnowSQL, o cliente executa a versão 1.3.1 e verifica se uma versão mais recente está disponível.

Habilitar a atualização automática¶

A opção de -o noup=<valor > permite que você substitua o comportamento padrão do SnowSQL de exigir instalações manuais para novas versões, em que:

• True habilita o comportamento sem atualização (valor padrão para a versão 1.3.0 e superior). SnowSQL não verifica atualizações automaticamente e atualiza-se automaticamente.

• False desabilita o comportamento de não atualização (valor padrão para a versão 1.2.32 e inferiores). O SnowSQL verifica automaticamente se há atualizações e atualiza-se automaticamente se houver alguma nova atualização disponível na mesma versão major.minor

Você pode especificar esta opção ao fazer login no Snowflake para habilitar uma atualização automática durante aquela sessão específica.

Por exemplo:

snowsql - o noup=False

Copy

Como alternativa, adicione a opção noup = False ao arquivo de configuração para habilitar atualizações automáticas para o SnowSQL.

Como executar uma versão anterior do SnowSQL¶

Se você encontrar um problema com a versão mais recente do SnowSQL, como a versão 1.3.1, você pode executar temporariamente outra versão 1.3.x.

Para determinar a versão do SnowSQL que está sendo inicializada quando você executa o cliente, use a opção -v sem um valor:

$ snowsql -v

  Version: 1.3.1

Copy

Para exibir uma lista das versões disponíveis do SnowSQL, use a opção --versions:

$ snowsql --versions

 1.3.1
 1.3.0

Copy

Para instalar uma versão anterior do SnowSQL da lista, use a opção -v e especifique a versão que você deseja instalar. Por exemplo, para instalar a versão 1.3.0 se você estiver executando uma versão mais recente, como a 1.3.1:

$ snowsql -v 1.3.0

  Installing version: 1.3.0 [####################################]  100%

Copy

Use a mesma opção para especificar a versão que você deseja executar ao iniciar o SnowSQL:

$ snowsql -v 1.3.0

Copy

Novos usuários¶

Para especificar o ponto de extremidade Microsoft Azure do Snowflake Client Repository como um novo usuário do SnowSQL, execute o seguinte comando:

snowsql -o repository_base_url=https://sfc-repo.azure.snowflakecomputing.com/snowsql

Verifique se o arquivo de configuração (isto é, ~/.snowsql/config ou %USERPROFILE%\.snowsql\config) inclui a seguinte linha.

repository_base_url=https://sfc-repo.azure.snowflakecomputing.com/snowsql

Usuários existentes¶

Para especificar o ponto de extremidade Microsoft Azure do Snowflake Client Repository como um usuário existente do SnowSQL, adicione a seguinte linha ao arquivo de configuração (isto é, ~/.snowsql/config ou %USERPROFILE%\.snowsql\config):

repository_base_url=https://sfc-repo.azure.snowflakecomputing.com/snowsql