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.16 の SnowSQL インストーラーをダウンロードするには、次を実行します。

AWS エンドポイント
$ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/1.2/linux_x86_64/snowsql-1.2.16-linux_x86_64.bash
Microsoft Azureエンドポイント
$ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/1.2/linux_x86_64/snowsql-1.2.16-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://keyserver.ubuntu.com --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

    注釈

    このコマンドが次のエラーを発生して失敗した場合、

    gpg: keyserver receive failed: Server indicated a failure

    次に、キーサーバーにポート80を使用することを指定します。

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

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

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

    または

    $ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/1.2/linux_x86_64/snowsql-1.2.16-linux_x86_64.bash
$ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/1.2/linux_x86_64/snowsql-1.2.16-linux_x86_64.bash.sig
$ gpg --verify snowsql-1.2.16-linux_x86_64.bash.sig snowsql-1.2.16-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_DEST ： snowsql 実行可能ファイルのターゲットディレクトリ。

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

$ 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.16 の SnowSQL インストーラーをダウンロードするには、次を実行します。

AWS エンドポイント
$ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/1.2/darwin_x86_64/snowsql-1.2.16-darwin_x86_64.pkg
Microsoft Azureエンドポイント
$ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/1.2/darwin_x86_64/snowsql-1.2.16-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を直接インストールできます。

インストールするキャスクとして snowflake-snowsql を指定して、 brew install コマンドを実行します。

$ brew install --cask 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.16 の SnowSQL インストーラーをダウンロードするには、次を実行します。

AWS エンドポイント
$ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/1.2/windows_x86_64/snowsql-1.2.16-windows_x86_64.msi
Microsoft Azureエンドポイント
$ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/1.2/windows_x86_64/snowsql-1.2.16-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