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

Ponto de extremidade AWS

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

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.2/linux_x86_64/snowsql-1.2.31-linux_x86_64.bash.sig
   
   # Verify the package signature.
   $ gpg --verify snowsql-1.2.31-linux_x86_64.bash.sig snowsql-1.2.31-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.31-linux_x86_64.bash.sig
   
   # Verify the package signature.
   $ gpg --verify snowsql-1.2.31-linux_x86_64.bash.sig snowsql-1.2.31-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.

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

  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

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 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>/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.31:

Ponto de extremidade AWS

$ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/1.2/darwin_x86_64/snowsql-1.2.31-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.31-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¶

1. Clique duas vezes em snowsql-darwin_x86_64.pkg no local de download para executar o arquivo PKG do instalador.

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

  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:

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 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>/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.31:

Ponto de extremidade AWS

$ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/1.2/windows_x86_64/snowsql-1.2.31-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.31-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¶

1. Clique duas vezes em snowsql-windows_x86_64.msi no local de download para executar o arquivo MSI do instalador.

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

  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

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:

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

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

  1.2.3
  1.2.2
  1.2.1
  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

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