SnowSQL のインストール

このトピックでは、 SnowSQL をダウンロードして、サポートされているすべてのプラットフォームにインストールする方法について説明します。

プライマリ SnowSQL インストーラーは、 Snowflakeクライアントリポリトジ からダウンロードできるファイルとして提供されています。

注釈

  • SnowSQL のダウンロードとインストールは、メジャーバージョンとマイナーバージョンにのみ必要です。パッチバージョン(およびビルド)の場合、SnowSQL はデフォルトで自動的にアップグレードされます。詳細については、 自動アップグレードとは何ですか? (このトピック)をご参照ください。

  • Amazon S3アーティファクトリポジトリは、 SnowSQL バージョン1.1.86以前のアップデートを提供するために引き続き利用できます。 SnowSQL 1.2.0以降から新しい機能とバグ修正を入手するには、以下の手順に従って SnowSQL インストーラーをダウンロードしてください。

このトピックの内容:

インストーラーを使用した、Linuxへの SnowSQL のインストール

このセクションでは、インストーラーパッケージをダウンロード、検証、実行して、Linuxに SnowSQL をインストールする方法について説明します。

デフォルトでは、 SnowSQL はパッチバージョンを自動的にアップグレードします。自動アップグレード機能の情報については、 自動アップグレードとは (このトピック内)をご参照ください。Linuxユーザーは、この機能をサポートしない代替 RPM パッケージを使用して、 SnowSQL をインストールできます。手順については、 RPMパッケージを使用して、Linuxに SnowSQL をインストールする (このトピック内)をご参照ください。

ダウンロードディレクトリと構成ファイルの場所の設定

デフォルトでは、 SnowSQL インストーラーはバイナリを次のディレクトリにダウンロードします。

~/.snowsql

このため、 構成ファイル はダウンロードディレクトリの下にあります。

~/.snowsql/config

WORKSPACE 環境変数をユーザーが書き込み可能なディレクトリに設定することにより、ダウンロードディレクトリと構成ファイルの場所の両方を変更できます。これは、各プロセスに独立した SnowSQL 環境がある場合に特に便利です。

さらに、 SNOWSQL_DOWNLOAD_DIR 環境変数を設定して、複数の SnowSQL プロセスがバイナリを共有できるようにすることで、ダウンロードディレクトリを構成ファイルから分離できます。例:

$ SNOWSQL_DOWNLOAD_DIR=/var/shared snowsql -h

SnowSQL 1.1.70ブートストラップバージョンから SNOWSQL_DOWNLOAD_DIR がサポートされるようになります。使用しているバージョンを確認するには、ターミナルウィンドウのプロンプトから次のコマンドを実行します。

$ snowsql --bootstrap-version

SnowSQL インストーラーのダウンロード

SnowSQL インストーラーは、 Snowflakeクライアントリポリトジ からダウンロードできます。認証は不要です。このバージョンの SnowSQL インストーラーは、パッチの自動アップグレードを有効にします。

柔軟性を高めるため、Snowflakeは SnowSQL インストーラーのダウンロード用にAmazon Web Services(AWS)とAzureエンドポイントの両方を提供しています。サポートされている任意のクラウドプラットフォームでホストされているアカウントでは、いずれのエンドポイントからもインストーラーをダウンロードできます。

curl (または同等のコマンドラインツール)を実行して、インストーラーをダウンロードします。 curl 構文は次のとおりです。

AWS エンドポイント
$ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/<bootstrap_version>/linux_x86_64/snowsql-<version>-linux_x86_64.bash
Microsoft Azureエンドポイント
$ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/<bootstrap_version>/linux_x86_64/snowsql-<version>-linux_x86_64.bash

条件:

  • <バージョン> は SnowSQL のメジャー、マイナー、およびパッチバージョンを組み合わせたものです。たとえば、バージョン1.2.3の場合、メジャーバージョンは1、マイナーバージョンは2、パッチバージョンは3です。したがって、バージョンは1.2.3になります。

  • <ブートストラップバージョン> は SnowSQL のメジャーおよびマイナーバージョンを組み合わせたものです。たとえば、バージョン1.2.3の場合、メジャーバージョンは1、マイナーバージョンは2であるため、ブートストラップバージョンは1.2になります。

たとえば、 <ブートストラップ> が1.2で <バージョン> が 1.2.10 の SnowSQL インストーラーをダウンロードするには、次を実行します。

AWS エンドポイント
$ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/1.2/linux_x86_64/snowsql-1.2.10-linux_x86_64.bash
Microsoft Azureエンドポイント
$ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/1.2/linux_x86_64/snowsql-1.2.10-linux_x86_64.bash

SnowSQL バージョンの詳細については、 SnowSQL バージョニングの理解 (このトピック内)をご参照ください。

パッケージの署名の確認

オプションで、ダウンロードしたパッケージの署名を確認するには、

  1. Snowflakeウェブインターフェイスまたは公開鍵サーバーから最新のSnowflake GPG 公開鍵をダウンロードしてインポートします。

    ウェブインターフェイスからのダウンロード
    1. Snowflakeウェブインターフェイスで、 Help Help tab » Download... をクリックして Downloads ダイアログを表示します。

    2. 左側の CLI Client (snowsql) を選択し、右側の Snowflake GPG Public Key アイコンをクリックします。

    キーサーバーからのダウンロード
    $ gpg --keyserver hkp://keys.gnupg.net --recv-keys <GPG_KEY_ID>
    

    <GPG_KEY_ID> には、次のキー IDs のいずれかを指定します。

    SnowSQL バージョン

    GPG キー ID

    1.2.11以上

    37C7086698CB005C

    1.1.75 から 1.2.10

    EC218558EABB25A1

    1.1.74まで

    93DB296A69BE019A

  2. bashインストーラーとともに GPG 署名をダウンロードし、署名を検証します。

    $ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/1.2/linux_x86_64/snowsql-1.2.10-linux_x86_64.bash
    $ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/1.2/linux_x86_64/snowsql-1.2.10-linux_x86_64.bash.sig
    $ gpg --verify snowsql-1.2.10-linux_x86_64.bash.sig snowsql-1.2.10-linux_x86_64.bash

    または

    $ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/1.2/linux_x86_64/snowsql-1.2.10-linux_x86_64.bash
    $ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/1.2/linux_x86_64/snowsql-1.2.10-linux_x86_64.bash.sig
    $ gpg --verify snowsql-1.2.10-linux_x86_64.bash.sig snowsql-1.2.10-linux_x86_64.bash

    注釈

    署名を確認すると、次のような警告が生成されます。

    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.
    

    警告を回避するため、Snowflake GPG 公開鍵の暗黙的な信頼を付与できます。

  3. ローカル環境には複数の GPG キーを含めることができます。ただし、セキュリティ上の理由から、Snowflakeは定期的に公開 GPG キーをローテーションします。ベストプラクティスとして、最新の署名済みパッケージで最新のキーが機能することを確認した後、既存の公開キーを削除することをお勧めします。例:

    $ gpg --delete-key "Snowflake Computing"
    

インストーラーを使用した SnowSQL のインストール

  1. ターミナルウィンドウを開きます。

  2. ダウンロード場所からBashスクリプトインストーラーを実行します。

    $ bash snowsql-linux_x86_64.bash
    
  3. インストーラーの指示に従います。

注釈

次の環境変数を設定することにより、インストールを自動化できます。

  • SNOWSQL_DESTsnowsql 実行可能ファイルのターゲットディレクトリ。

  • SNOWSQL_LOGIN_SHELLPATH 環境の更新を含むログインシェル初期化ファイル。

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

新しいメジャーバージョンまたはマイナーバージョンをインストールしても、 SnowSQL はすぐにはアップグレードされません。代わりに、 SnowSQL を使用してSnowflakeアカウントにログインし、自動アップグレード機能がクライアントを最新リリースにアップグレードするために、十分な時間接続を維持する必要があります。クライアントの実行時に現在起動している SnowSQL バージョンを確認するには、値なしで -v オプションを使用します。

$ snowsql -v

  Version: 1.2.3

SnowSQL に特定のバージョンのインストールと使用を強制するには、 -v オプションを使用して、インストールするバージョンを指定します。たとえば、バージョン1.2.5に対して次のコマンドを実行します。

$ snowsql -v 1.2.5

RPM パッケージを使用した、Linuxへの SnowSQL のインストール

このパッケージは、パッチの自動アップグレードをサポートしていません。自動アップグレード機能の情報については、 自動アップグレードとは (このトピック内)をご参照ください。

SnowSQL RPM パッケージのダウンロード

一部の組織のソフトウェアインストールポリシーでは、自動アップグレードが禁止されています。この理由とともに、ソフトウェアを手動でアップグレードすることを好むユーザーにより多くの選択肢を提供するために、Snowflakeは、自動アップグレードをサポートしないLinux用 SnowSQL インストーラーの代替バージョンを提供します。このバージョンのインストーラーは RPM パッケージとして提供されており、次からダウンロードできます。

https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/1.2/linux_x86_64/index.html

SnowSQL RPM パッケージのインストール

ダウンロードした RPM ファイルは、他の RPM パッケージをインストールするのと同じ方法でインストールできます。

rpm -i <package_name>

インストーラーを使用した、 macOS への SnowSQL のインストール

このセクションでは、インストーラーパッケージをダウンロードして実行し、 macOS に SnowSQL をインストールする方法について説明します。

ダウンロードディレクトリと構成ファイルの場所の設定

デフォルトでは、 SnowSQL インストーラーはバイナリを次のディレクトリにダウンロードします。

~/.snowsql

このため、 構成ファイル はダウンロードディレクトリの下にあります。

~/.snowsql/config

WORKSPACE 環境変数をユーザーが書き込み可能なディレクトリに設定することにより、ダウンロードディレクトリと構成ファイルの場所の両方を変更できます。これは、各プロセスに独立した SnowSQL 環境がある場合に特に便利です。

さらに、 SNOWSQL_DOWNLOAD_DIR 環境変数を設定して、複数の SnowSQL プロセスがバイナリを共有できるようにすることで、ダウンロードディレクトリを構成ファイルから分離できます。例:

$ SNOWSQL_DOWNLOAD_DIR=/var/shared snowsql -h

SnowSQL 1.1.70ブートストラップバージョンから SNOWSQL_DOWNLOAD_DIR がサポートされるようになります。使用しているバージョンを確認するには、ターミナルウィンドウのプロンプトから次のコマンドを実行します。

$ snowsql --bootstrap-version

SnowSQL インストーラーのダウンロード

SnowSQL インストーラーは、 Snowflakeクライアントリポリトジ からダウンロードできます。認証は不要です。このバージョンの SnowSQL インストーラーは、パッチの自動アップグレードを有効にします。

柔軟性を高めるため、Snowflakeは SnowSQL インストーラーのダウンロード用に AWS とAzureエンドポイントの両方を提供しています。サポートされている任意のクラウドプラットフォームでホストされているアカウントでは、いずれのエンドポイントからもインストーラーをダウンロードできます。

curl (または同等のコマンドラインツール)を実行して、インストーラーをダウンロードします。 curl 構文は次のとおりです。

AWS エンドポイント
$ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/<bootstrap_version>/darwin_x86_64/snowsql-<version>-darwin_x86_64.pkg
Microsoft Azureエンドポイント
$ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/<bootstrap_version>/darwin_x86_64/snowsql-<version>-darwin_x86_64.pkg

条件:

  • <バージョン> は SnowSQL のメジャー、マイナー、およびパッチバージョンを組み合わせたものです。たとえば、バージョン1.2.3の場合、メジャーバージョンは1、マイナーバージョンは2、パッチバージョンは3です。したがって、バージョンは1.2.3になります。

  • <ブートストラップバージョン> は SnowSQL のメジャーおよびマイナーバージョンを組み合わせたものです。たとえば、バージョン1.2.3の場合、メジャーバージョンは1、マイナーバージョンは2であるため、ブートストラップバージョンは1.2になります。

たとえば、 <ブートストラップ> が1.2で <バージョン> が 1.2.10 の SnowSQL インストーラーをダウンロードするには、次を実行します。

AWS エンドポイント
$ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/1.2/darwin_x86_64/snowsql-1.2.10-darwin_x86_64.pkg
Microsoft Azureエンドポイント
$ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/1.2/darwin_x86_64/snowsql-1.2.10-darwin_x86_64.pkg

SnowSQL バージョンの詳細については、 SnowSQL バージョニングの理解 (このトピック内)をご参照ください。

macOS オペレーティングシステムはインストーラーの署名を自動的に確認できるため、 GPG 署名の検証は不要です。

インストーラーを使用した SnowSQL のインストール

  1. ダウンロード場所の snowsql-darwin_x86_64.pkg をダブルクリックして、インストーラー PKG ファイルを実行します。

  2. インストーラーの指示に従います。

注釈

コマンドラインからインストーラーを実行することにより、インストールを自動化できます。ターゲットディレクトリは、 CurrentUserHomeDirectory~/Applications ディレクトリ)または LocalSystem/Applications ディレクトリ)に設定できます。

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

新しいメジャーバージョンまたはマイナーバージョンをインストールしても、 SnowSQL はすぐにはアップグレードされません。代わりに、 SnowSQL を使用してSnowflakeアカウントにログインし、自動アップグレード機能がクライアントを最新リリースにアップグレードするために、十分な時間接続を維持する必要があります。クライアントの実行時に現在起動している SnowSQL バージョンを確認するには、値なしで -v オプションを使用します。

$ snowsql -v

  Version: 1.2.3

SnowSQL に特定のバージョンのインストールと使用を強制するには、 -v オプションを使用して、インストールするバージョンを指定します。たとえば、バージョン1.2.5に対して次のコマンドを実行します。

$ snowsql -v 1.2.5

Zシェルエイリアスの設定(macOSのみ)

Zシェル(zshとも呼ばれます)がデフォルトのターミナルシェルである場合は、ターミナルのコマンドラインで SnowSQL を実行できるように、エイリアスを SnowSQL 実行可能ファイルに設定します。SnowSQL インストーラーは実行可能ファイルを /Applications/SnowSQL.app/Contents/MacOS/snowsql にインストールし、このパスを PATH または ~/.profile のエイリアスエントリに追加します。zshは通常このファイルを読み取らないため、 ~/.zshrc のこのパスにエイリアスを追加します。これはzsh が読み取ります

SnowSQL 実行可能ファイルにエイリアスを追加するには:

  1. ~/.zshrc ファイルを開きます(ない場合は作成します)。

  2. 次の行を追加します。

    alias snowsql=/Applications/SnowSQL.app/Contents/MacOS/snowsql
    
  3. ファイルを保存します。

Homebrew Caskを使用した、macOS への SnowSQL のインストール

Homebrew Cask は、パッケージの配布、インストール、およびメンテナンスに使用される Homebrew の一般的な拡張機能です。ダウンロードする個別の SnowSQL インストーラーはありません。Homebrew Caskが macOS プラットフォームにインストールされている場合は、Snowflakeを直接インストールできます。

brew cask コマンドを実行します。

$ brew cask install snowflake-snowsql

Zシェルエイリアスの設定(macOSのみ)

Zシェル(zshとも呼ばれます)がデフォルトのターミナルシェルである場合は、ターミナルのコマンドラインで SnowSQL を実行できるように、エイリアスを SnowSQL 実行可能ファイルに設定します。SnowSQL インストーラーは実行可能ファイルを /Applications/SnowSQL.app/Contents/MacOS/snowsql にインストールし、このパスを PATH または ~/.profile のエイリアスエントリに追加します。zshは通常このファイルを読み取らないため、 ~/.zshrc のこのパスにエイリアスを追加します。これはzsh が読み取ります

SnowSQL 実行可能ファイルにエイリアスを追加するには:

  1. ~/.zshrc ファイルを開きます(ない場合は作成します)。

  2. 次の行を追加します。

    alias snowsql=/Applications/SnowSQL.app/Contents/MacOS/snowsql
    
  3. ファイルを保存します。

インストーラーを使用した、Microsoft Windowsへの SnowSQL のインストール

このセクションでは、インストーラーパッケージをダウンロードして実行し、Microsoft Windowsに SnowSQL をインストールする方法について説明します。

ダウンロードディレクトリと構成ファイルの場所の設定

デフォルトでは、 SnowSQL インストーラーはバイナリを次のディレクトリにダウンロードします。

%USERPROFILE%\.snowsql

このため、 構成ファイル はダウンロードディレクトリの下にあります。

%USERPROFILE%\.snowsql\config

WORKSPACE 環境変数をユーザーが書き込み可能なディレクトリに設定することにより、ダウンロードディレクトリと構成ファイルの場所の両方を変更できます。これは、各プロセスに独立した SnowSQL 環境がある場合に特に便利です。

さらに、 SNOWSQL_DOWNLOAD_DIR 環境変数を設定して、複数の SnowSQL プロセスがバイナリを共有できるようにすることで、ダウンロードディレクトリを構成ファイルから分離できます。例:

$ SNOWSQL_DOWNLOAD_DIR=/var/shared snowsql -h

SnowSQL 1.1.70ブートストラップバージョンから SNOWSQL_DOWNLOAD_DIR がサポートされるようになります。使用しているバージョンを確認するには、ターミナルウィンドウのプロンプトから次のコマンドを実行します。

$ snowsql --bootstrap-version

SnowSQL インストーラーのダウンロード

SnowSQL インストーラーは、 Snowflakeクライアントリポリトジ からダウンロードできます。認証は不要です。このバージョンの SnowSQL インストーラーは、パッチの自動アップグレードを有効にします。

柔軟性を高めるため、Snowflakeは SnowSQL インストーラーのダウンロード用に AWS とAzureエンドポイントの両方を提供しています。サポートされている任意のクラウドプラットフォームでホストされているアカウントでは、いずれのエンドポイントからもインストーラーをダウンロードできます。

curl (または同等のコマンドラインツール)を実行して、インストーラーをダウンロードします。 curl 構文は次のとおりです。

AWS エンドポイント
$ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/<bootstrap_version>/windows_x86_64/snowsql-<version>-windows_x86_64.msi
Microsoft Azureエンドポイント
$ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/<bootstrap_version>/windows_x86_64/snowsql-<version>-windows_x86_64.msi

条件:

  • <バージョン> は SnowSQL のメジャー、マイナー、およびパッチバージョンを組み合わせたものです。たとえば、バージョン1.2.3の場合、メジャーバージョンは1、マイナーバージョンは2、パッチバージョンは3です。したがって、バージョンは1.2.3になります。

  • <ブートストラップバージョン> は SnowSQL のメジャーおよびマイナーバージョンを組み合わせたものです。たとえば、バージョン1.2.3の場合、メジャーバージョンは1、マイナーバージョンは2であるため、ブートストラップバージョンは1.2になります。

たとえば、 <ブートストラップ> が1.2で <バージョン> が 1.2.10 の SnowSQL インストーラーをダウンロードするには、次を実行します。

AWS エンドポイント
$ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/1.2/windows_x86_64/snowsql-1.2.10-windows_x86_64.msi
Microsoft Azureエンドポイント
$ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/1.2/windows_x86_64/snowsql-1.2.10-windows_x86_64.msi

SnowSQL バージョンの詳細については、 SnowSQL バージョニングの理解 (このトピック内)をご参照ください。

Windowsオペレーティングシステムはインストーラーの署名を自動的に確認できるため、 GPG 署名の検証は不要です。

インストーラーを使用した SnowSQL のインストール

  1. ダウンロード場所の snowsql-windows_x86_64.msi をダブルクリックして、インストーラー MSI ファイルを実行します。

  2. インストーラーの指示に従います。

注釈

コマンドラインから MSI インストーラー msiexec を実行することにより、インストールを自動化できます。ターゲットディレクトリは %ProgramFiles%\Snowflake SnowSQL から変更できません。例:

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

新しいメジャーバージョンまたはマイナーバージョンをインストールしても、 SnowSQL はすぐにはアップグレードされません。代わりに、 SnowSQL を使用してSnowflakeアカウントにログインし、自動アップグレード機能がクライアントを最新リリースにアップグレードするために、十分な時間接続を維持する必要があります。クライアントの実行時に現在起動している SnowSQL バージョンを確認するには、値なしで -v オプションを使用します。

$ snowsql -v

  Version: 1.2.3

SnowSQL に特定のバージョンのインストールと使用を強制するには、 -v オプションを使用して、インストールするバージョンを指定します。たとえば、バージョン1.2.5に対して次のコマンドを実行します。

$ snowsql -v 1.2.5

SnowSQL バージョニングの理解

SnowSQL バージョン番号は3桁で構成されています。 <メジャーバージョン>.<マイナーバージョン>.<パッチバージョン>

たとえば、バージョン1.2.3は、メジャーバージョンが1、マイナーバージョンが2、パッチバージョンが3であることを示します。

クライアントの実行時に現在起動している SnowSQL バージョンを確認するには、値なしで -v オプションを使用します。

$ snowsql -v

  Version: 1.2.3

通常は、次のガイドラインがさまざまなバージョンタイプに適用されます。

メジャーバージョン

メジャーバージョンの変更は、基になるSnowflakeサービスの大きな改善を示しています。新しいメジャーバージョンによって、後方互換性はなくなります。ウェブインターフェイスから最新の SnowSQL バージョンをダウンロードしてインストールする必要があります。

マイナーバージョン

マイナーバージョンの変更は、SnowSQL または基になるSnowflakeサービスのいずれかで前方互換性をサポートするための改善を示しています。新しいマイナーバージョンによって後方互換性はなくなりませんが、ウェブインターフェイスから最新の SnowSQL バージョンをダウンロードしてインストールすることを強くお勧めします。

パッチバージョン

パッチバージョンの変更は、小さな拡張またはバグ修正が適用されたことを示します。自動アップグレード機能は、すべてのパッチバージョンを自動的にインストールします。自動アップグレード機能の詳細については、 自動アップグレードとは (このトピック内)をご参照ください。

注釈

マイナーバージョンがリリースされた場合、現在のバージョンの機能は引き続き動作しますが、新しくリリースされたバグ修正および機能は、自動アップグレード機能経由では 利用できません。したがって、マイナーバージョンが増加した場合は、最新の SnowSQL バージョンをダウンロードしてインストールすることを強くお勧めします。

自動アップグレードとは何ですか?

デフォルトでは、SnowSQL は自動的に最新のパッチバージョンにアップグレードします。新しいメジャーバージョンまたはマイナーバージョンを使用するには、手動でダウンロードしてインストールする必要があります。

新しいパッチバージョンが利用可能になると、SnowSQL はバックグラウンドプロセスで新しいバイナリをダウンロードし、現在のバージョンを実行します。次回 SnowSQL を実行すると、新しいバージョンが起動します。

以下でこのプロセスを説明します。

  1. 新規インストールの場合は、Snowflakeウェブインターフェイスを使用して SnowSQL インストーラー(バージョン1.2.0など)をダウンロードし、クライアントをインストールします。

  2. SnowSQL を実行するたびに、クライアントは SnowSQL アップグレードリポジトリで新しいバージョンが利用可能かどうかを確認します。

  3. 新しいバージョン(バージョン1.2.1など)が利用可能な場合、 SnowSQL は、現在インストールされているバージョンのバックグラウンドプロセスとしてダウンロードします。

  4. 次回 SnowSQLを実行すると、クライアントは新しいバージョンが利用可能かどうかを確認しながらバージョン1.2.1を実行します。

自動アップグレードの無効化

--noup オプションは、SnowSQL が新しいバージョンをダウンロードできないようにします(利用可能な場合)。Snowflakeへのログイン中にこのオプションを指定して、特定のセッション中の自動アップグレードを防ぐことができます。

例:

$ snowsql --noup

または、 構成ファイルnoup = true オプションを追加して、オプションが削除されるか false に設定されるまで SnowSQL が自動アップグレードしないようにします。

以前の SnowSQL バージョンの実行

最新の SnowSQL バージョン(例:バージョン1.2.2)で問題が発生した場合、以前のバージョンを一時的に実行できます。

クライアントの実行時に現在起動している SnowSQL バージョンを確認するには、値なしで -v オプションを使用します。

$ snowsql -v

  Version: 1.2.2

利用可能な SnowSQL バージョンのリストを表示するには、 --versions オプションを使用します。

$ snowsql --versions

  1.2.3
  1.2.2
  1.2.1
  1.2.0

リストから以前の SnowSQL バージョンをインストールするには、 -v オプションを使用して、インストールするバージョンを指定します。たとえば、バージョン1.2.3をインストールするには、次を実行します。

$ snowsql -v 1.2.3

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

同じオプションを使用して、 SnowSQL の起動時に実行するバージョンを指定します。

$ snowsql -v 1.2.3

SnowSQL 自動アップグレード機能で使用するSnowflakeクライアントリポジトリエンドポイントの変更

デフォルトでは、 SnowSQL 自動アップグレード機能はSnowflakeクライアントリポジトリの AWS エンドポイントを使用します。 SnowSQL 構成ファイルのエンドポイントを変更するには、このセクションのステップを完了します。

新しいユーザー

SnowflakeクライアントリポジトリのMicrosoft Azureエンドポイントを新しい SnowSQL ユーザーとして指定するには、次のコマンドを実行します。

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

構成ファイル(つまり、 ~/.snowsql/config または %USERPROFILE%\.snowsql\config)に次の行が含まれていることを確認します。

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

既存のユーザー

SnowflakeクライアントリポジトリのMicrosoft Azureエンドポイントを既存の SnowSQL ユーザーとして指定するには、構成ファイルに次の行を追加します(つまり、 ~/.snowsql/config または %USERPROFILE%\.snowsql\config)。

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