Instalação do SnowSQL¶

Este tópico descreve como fazer o download e instalar o SnowSQL em todas as plataformas suportadas.

Para baixar o instalador do SnowSQL, vá para a página de Download do SnowSQL.

Nota

Para atualizar para uma nova versão de patch, você não precisa baixar e executar o instalador. SnowSQL é atualizado automaticamente. Para obter mais informações, consulte O que é a atualização automática? (neste tópico).

Neste tópico:

Instalação do SnowSQL no Linux usando o instalador¶

Esta seção descreve como baixar, verificar e executar o pacote do instalador para instalar o SnowSQL no Linux.

Por padrão, o instalador configura SnowSQL para atualizar para versões de patch automaticamente. Para obter mais informações sobre o recurso de atualização automática, consulte O que é a atualização automática? (neste tópico).

Se você preferir atualizar o SnowSQL manualmente (por exemplo, se sua política de instalação de software proibir a atualização automática), use o pacote RPM para instalar o SnowSQL. O pacote RPM não configura o SnowSQL para atualizar automaticamente. Para instruções, consulte Instalação do SnowSQL no Linux usando o pacote RPM (neste tópico).

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 suportada podem baixar o instalador de qualquer ponto 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.2.3, a versão principal é a 1, a versão secundária é a 2 e a versão de patch é a 3. Portanto, a versão é 1.2.3.
<bootstrap_version> é a combinação das versões principal e secundária do SnowSQL. Por exemplo, para a versão 1.2.3, a versão principal é a 1 e a versão secundária é a 2, então a versão bootstrap é 1.2.

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

Ponto de extremidade AWS:

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

Ponto de extremidade Microsoft Azure:

$ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/1.2/linux_x86_64/snowsql-1.2.32-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:

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, clique em Help » Download… para exibir a caixa de diálogo Downloads.
2. Selecione CLI Client (snowsql) à esquerda, depois clique no í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

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.2/linux_x86_64/snowsql-1.2.32-linux_x86_64.bash.sig

# Verify the package signature.
$ gpg --verify snowsql-1.2.32-linux_x86_64.bash.sig snowsql-1.2.32-linux_x86_64.bash

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.2/linux_x86_64/snowsql-1.2.32-linux_x86_64.bash.sig

# Verify the package signature.
$ gpg --verify snowsql-1.2.32-linux_x86_64.bash.sig snowsql-1.2.32-linux_x86_64.bash

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.

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¶

Abra uma janela de terminal.
Execute o instalador do script Bash a partir do local de download:
$ bash snowsql-linux_x86_64.bash
Copy
Siga as instruções fornecidas pelo instalador.

Nota

A instalação pode ser automatizada através da definição das seguintes variáveis de ambiente:

SNOWSQL_DEST: diretório de destino do executável snowsql.
SNOWSQL_LOGIN_SHELL: o arquivo de inicialização do shell de login, que inclui a atualização de ambiente PATH.

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

Copy

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

  Version: 1.2.3

Copy

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.2.5:

$ snowsql -v 1.2.5

Copy

Instalação do SnowSQL no Linux usando o pacote RPM¶

Em algumas organizações, a política de instalação de software proíbe a atualização automática. Se sua organização tiver esta política ou se preferir atualizar o software manualmente, você pode usar o pacote RPM (em vez do instalador) para instalar o SnowSQL. O pacote RPM não oferece suporte a upgrades automáticos.

Para obter mais informações sobre o recurso de atualização automática, consulte O que é a atualização automática? (neste tópico).

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>

Copy

Instalação do SnowSQL no macOS usando o instalador¶

Esta seção descreve como baixar e executar o pacote do instalador para instalar o SnowSQL no macOS.

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.

$ SNOWSQL_DOWNLOAD_DIR=/var/shared snowsql -h

Copy

$ 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¶

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.2.3, a versão principal é a 1, a versão secundária é a 2 e a versão de patch é a 3. Portanto, a versão é 1.2.3.
<bootstrap_version> é a combinação das versões principal e secundária do SnowSQL. Por exemplo, para a versão 1.2.3, a versão principal é a 1 e a versão secundária é a 2, então a versão bootstrap é 1.2.

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

Ponto de extremidade AWS:

$ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/1.2/darwin_x86_64/snowsql-1.2.32-darwin_x86_64.pkg

Ponto de extremidade Microsoft Azure:

$ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/1.2/darwin_x86_64/snowsql-1.2.32-darwin_x86_64.pkg

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¶

Clique duas vezes em snowsql-darwin_x86_64.pkg no local de download para executar o arquivo PKG do instalador.
Siga as instruções fornecidas pelo instalador.

Nota

Para automatizar a instalação, execute o instalador a partir da linha de comando. O diretório de destino pode ser definido como CurrentUserHomeDirectory (diretório ~/Applications) ou LocalSystem (diretório /Applications):

$ installer -pkg snowsql-darwin_x86_64.pkg -target CurrentUserHomeDirectory

Copy

$ snowsql -v

  Version: 1.2.3

Copy

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.2.5:

$ snowsql -v 1.2.5

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:

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

Adicione a seguinte linha:

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

Copy

Salve o arquivo.

Instalação do SnowSQL no macOS usando o Homebrew Cask¶

O Homebrew Cask é uma extensão popular do Homebrew usada para distribuição, instalação e manutenção de pacotes. Não é preciso baixar um instalador separado do SnowSQL. Se o Homebrew Cask estiver instalado na sua plataforma macOS, você pode instalar o Snowflake diretamente.

Execute o comando brew install, especificando snowflake-snowsql como o cask a ser instalado:

$ brew install --cask snowflake-snowsql

Copy

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

Para adicionar um alias ao executável SnowSQL:

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

Adicione a seguinte linha:

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

Copy

Salve o arquivo.

Instalação do SnowSQL no Microsoft Windows usando o instalador¶

Esta seção descreve como baixar e executar o pacote do instalador para instalar o SnowSQL no Microsoft Windows.

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

$ SNOWSQL_DOWNLOAD_DIR=/var/shared snowsql -h

Copy

$ 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¶

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.2.3, a versão principal é a 1, a versão secundária é a 2 e a versão de patch é a 3. Portanto, a versão é 1.2.3.
<bootstrap_version> é a combinação das versões principal e secundária do SnowSQL. Por exemplo, para a versão 1.2.3, a versão principal é a 1 e a versão secundária é a 2, então a versão bootstrap é 1.2.

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

Ponto de extremidade AWS:

$ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/1.2/windows_x86_64/snowsql-1.2.32-windows_x86_64.msi

Ponto de extremidade Microsoft Azure:

$ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/1.2/windows_x86_64/snowsql-1.2.32-windows_x86_64.msi

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¶

Clique duas vezes em snowsql-windows_x86_64.msi no local de download para executar o arquivo MSI do instalador.
Siga as instruções fornecidas pelo instalador.

Nota

Para automatizar a instalação, execute o instalador MSI msiexec a partir da linha de comando. O diretório de destino não pode ser alterado a partir de %ProgramFiles%Snowflake SnowSQL. Por exemplo:

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

Copy

$ snowsql -v

  Version: 1.2.3

Copy

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.2.5:

$ snowsql -v 1.2.5

Copy

Explicação do sistema de versão do SnowSQL¶

SnowSQL Os números de versão consistem em três dígitos: <versão principal>.<versão secundária>.<versão de patch>.

Por exemplo, a versão 1.2.3 indica que a versão principal é a 1, a versão secundária é a 2 e a versão de patch é a 3.

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.2.3

Copy

Em geral, as seguintes diretrizes se aplicam aos diferentes tipos de versões:

Versão principal:: Uma mudança na versão principal indica melhorias dramáticas no serviço subjacente do Snowflake. Uma nova versão principal quebra a compatibilidade retroativa. Você precisará baixar e instalar a última versão do SnowSQL a partir da interface da Web.
Versão secundária:: Uma mudança na versão secundária indica melhorias para oferecer suporte à compatibilidade progressiva com o SnowSQL ou com o serviço subjacente do Snowflake. Uma nova versão secundária não quebra a compatibilidade retroativa, mas recomendamos fortemente que você baixe e instale a última versão do SnowSQL a partir da interface da Web.
Versão de patch:: Uma mudança na versão de patch indica que pequenas melhorias ou correções de bugs foram aplicadas. O recurso de atualização automática instala automaticamente todas as versões de patch. Para obter mais informações sobre o recurso de atualização automática, consulte O que é a atualização automática? (neste tópico).

Nota

Se uma versão secundária for lançada, a funcionalidade da sua versão atual deverá continuar a funcionar, mas as correções de erros e os recursos recém-lançados não estarão disponíveis através do recurso de atualização automática. Portanto, recomendamos fortemente que você baixe e instale a última versão do SnowSQL se houver uma nova versão secundária.

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

Por padrão, o SnowSQL é atualizado automaticamente com a última versão de patch. Uma nova versão principal ou secundária exige um download e uma instalação manual.

Quando uma nova versão de patch está disponível, o SnowSQL faz o download do 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:

Para fazer uma nova instalação, você baixa o instalador do SnowSQL (por exemplo, a versão 1.2.0) usando a interface da Web do Snowflake e instala o cliente.
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.
Se uma nova versão (por exemplo, a versão 1.2.1) estiver disponível, o SnowSQL faz o download em segundo plano enquanto a versão instalada atualmente é executada.
Na próxima vez que você executar o SnowSQL, o cliente executa a versão 1.2.1 e verifica se uma versão mais recente está disponível.

Desativação da atualização automática¶

A opção --noup impede o SnowSQL de baixar uma nova versão, se houver uma disponível. Você pode especificar esta opção ao fazer login no Snowflake para evitar uma atualização automática durante aquela sessão específica.

Por exemplo:

$ snowsql --noup

Copy

Como alternativa, adicione a opção noup = true ao arquivo de configuração para que o SnowSQL só faça uma atualização automática quando a opção for removida ou definida como false.

Como executar uma versão anterior do SnowSQL¶

Se você encontrar um problema com a última versão do SnowSQL, por exemplo, a versão 1.2.2, você pode executar temporariamente uma versão anterior.

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.2.2

Copy

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

$ snowsql --versions

2.3
2.2
2.1
2.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.2.3:

$ snowsql -v 1.2.3

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

Copy

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

$ snowsql -v 1.2.3

Copy

Mudança do ponto de extremidade do Snowflake Client Repository usado pelo recurso de atualização automática do SnowSQL¶

Por padrão, o recurso de atualização automática do SnowSQL utiliza o ponto de extremidade AWS do Snowflake Client Repository. Para alterar o ponto de extremidade no arquivo de configuração do SnowSQL, execute os passos nesta seção.

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

Copy

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

Copy

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

Copy