SnowSQL のインストール

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

SnowSQL インストーラーをダウンロードするには、 SnowSQL ダウンロード ページに移動します。

注釈

SnowSQL 1.3.0リリースでは自動アップグレードが無効になっているため、新バージョンごとに手動でダウンロードして再インストールする必要があります。

このトピックの内容:

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

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

SnowSQL を手動でアップグレードする場合（例えば、ソフトウェアインストールポリシーで自動アップグレードが禁止されている場合）は、 RPM パッケージを使用して SnowSQL をインストールします。RPM パッケージは、 SnowSQL を自動的にアップグレードするようには設定しません。手順については、 RPM パッケージを使用したLinuxへの SnowSQL のインストール （このトピック内）をご参照ください。

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

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

~/.snowsql

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

~/.snowsql/config

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

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

$ SNOWSQL_DOWNLOAD_DIR=/var/shared snowsql -h
Copy

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

$ snowsql --bootstrap-version
Copy

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

SnowSQL ダウンロード ページに移動し、インストールする SnowSQL のバージョンを見つけて、次のファイル名の拡張子が付いたファイルをダウンロードします。

Curlを使用した SnowSQL インストーラーのダウンロード

スクリプトまたはターミナルウィンドウからインストーラーをダウンロードする場合（例えば、ウェブブラウザーではなく curl を使用）は、インストーラーを Snowflakeクライアントリポリトジ から直接ダウンロードできます。柔軟性を高めるため、Snowflakeはリポジトリ用に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
Copy
Microsoft Azureエンドポイント:
$ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/<bootstrap_version>/linux_x86_64/snowsql-<version>-linux_x86_64.bash
Copy

条件：

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

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

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

AWS エンドポイント:
$ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/1.3/linux_x86_64/snowsql-1.3.2-linux_x86_64.bash
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

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

パッケージの署名の確認

ダウンロードしたパッケージの署名を検証するには、

  1. Classic Console または公開キーサーバーから、最新のSnowflake GPG 公開キーをダウンロードして、インポートします。

    ウェブインターフェイスからのダウンロード:

    1. Classic Console で、 Help ヘルプタブ » Download... を選択し、 Downloads ダイアログを表示します。

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

    キーサーバーからのダウンロード:

    SnowSQL バージョンに関連付けられている GPG キーを使用して、次のコマンドを入力します。

    • SnowSQL 1.2.24以上の場合、

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

    • SnowSQL バージョン1.2.11から1.2.23までの場合:

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

    • SnowSQL バージョン1.1.75から1.2.10までの場合:

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

    • SnowSQL バージョン1.1.74以下の場合:

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

    注釈

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

    gpg: keyserver receive failed: Server indicated a failure
    Copy

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

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

  2. GPG 署名をダウンロードし、署名を検証します。

    # 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

    または、 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

    注釈

    署名の検証により、次のような警告が生成されます。

    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

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

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

    gpg --delete-key "Snowflake Computing"
    Copy

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

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

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

    bash snowsql-linux_x86_64.bash
    Copy

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

注釈

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

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

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

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

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

snowsql -v
Copy
Version: 1.3.1

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

snowsql -v 1.3.0
Copy

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

ソフトウェアを手動でアップグレードする場合は、 RPM パッケージ（インストーラー ではなく）を使用して SnowSQL をインストールできます。RPM パッケージは自動アップグレードをサポートしていません。

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

SnowSQL ダウンロード ページに移動し、インストールする SnowSQL のバージョンを見つけて、ファイル名の拡張子が .rpm のファイルをダウンロードします。

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

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

rpm -i <package_name>
Copy

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

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

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

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

~/.snowsql

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

~/.snowsql/config

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

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

SNOWSQL_DOWNLOAD_DIR=/var/shared snowsql -h
Copy

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

snowsql --bootstrap-version
Copy

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

SnowSQL インストーラーをダウンロードするには、 SnowSQL ダウンロード ページに移動します。このバージョンの SnowSQL インストーラーは、パッチの自動アップグレードを有効にします。

Curlを使用した SnowSQL インストーラーのダウンロード

スクリプトまたはターミナルウィンドウからインストーラーをダウンロードする場合（例えば、ウェブブラウザーではなく curl を使用）は、インストーラーを Snowflakeクライアントリポリトジ から直接ダウンロードできます。柔軟性を高めるため、Snowflakeはリポジトリ用にAmazon Web Services（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
Copy
Microsoft Azureエンドポイント:
curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/<bootstrap_version>/darwin_x86_64/snowsql-<version>-darwin_x86_64.pkg
Copy

条件:

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

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

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

AWS エンドポイント:
curl -O \https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/1.3/darwin_x86_64/snowsql-\ |snowsql-version|\ -darwin_x86_64.pkg
Copy
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

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
Copy

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

snowsql -v
Copy
Version: 1.3.0

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

snowsql -v 1.3.1
Copy

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
    Copy

  3. ファイルを保存します。

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

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

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

$ brew install --cask snowflake-snowsql
Copy

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
    Copy

  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
Copy

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

snowsql --bootstrap-version
Copy

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

SnowSQL インストーラーをダウンロードするには、 SnowSQL ダウンロード ページに移動します。このバージョンの SnowSQL インストーラーは、パッチの自動アップグレードを有効にします。

Curlを使用した SnowSQL インストーラーのダウンロード

スクリプトまたはターミナルウィンドウからインストーラーをダウンロードする場合（例えば、ウェブブラウザーではなく curl を使用）は、インストーラーを Snowflakeクライアントリポリトジ から直接ダウンロードできます。柔軟性を高めるため、Snowflakeはリポジトリ用にAmazon Web Services（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
Copy
Microsoft Azureエンドポイント:
curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/<bootstrap_version>/windows_x86_64/snowsql-<version>-windows_x86_64.msi
Copy

条件：

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

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

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

AWS エンドポイント:
curl -O \https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/1.3/windows_x86_64/snowsql-\ |snowsql-version|\ -windows_x86_64.msi
Copy
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

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
Copy

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

snowsql -v
Copy
Version: 1.3.1

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

snowsql -v 1.3.0
Copy

SnowSQL バージョン管理について

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

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

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

snowsql -v
Copy
Version: 1.3.1

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

メジャーバージョン:

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

マイナーバージョン:

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

パッチバージョン:

パッチバージョンの変更は、小さな拡張またはバグ修正が適用されたことを示します。

自動アップグレード機能は、すべてのパッチバージョンを自動的にインストールします。自動アップグレード機能の詳細については、 自動アップグレードとは （このトピック内）をご参照ください。

注釈

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

自動アップグレードとは

重要

バージョン1.3.0以降、 SnowSQL はデフォルトで自動アップグレードを無効にし、自動アップグレードが発生した場合に実稼働環境に影響を及ぼす可能性のある問題を回避しています。アップグレードするには、できれば非実稼働環境で、新しいバージョンを手動でダウンロードし、インストールする必要があります。Snowflakeでは、この設定を無効にしておくことを強く推奨していますが、新しいバージョンがリリースされたときに自動的にインストールしたい場合は、 SnowSQL --noup オプション を無効にすることができます。

SnowSQL の自動アップグレードを有効にした場合、 SnowSQL は自動的にバックグラウンドプロセスで新しいバイナリをダウンロードし、現在のバージョンを実行します。次回 SnowSQL を実行すると、新しいバージョンが起動します。

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

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

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

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

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

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

-o noup=<value> オプションは、新しいバージョンに手動インストールを要求する SnowSQL デフォルトの動作を上書きすることができます。

  • True は、アップグレードしない動作を有効にします（バージョン1.3.0以降のデフォルト値）。SnowSQL は自動的にアップグレードをチェックせず、自動的にアップグレードします。

  • False はアップグレードしない動作を無効にします（バージョン1.2.32以下のデフォルト値）。SnowSQL はアップグレードの有無を自動的にチェックし、同じ major.minor バージョン内で新しいアップグレードが利用可能な場合は、自動的にアップグレードを行います

Snowflakeにログイン中にこのオプションを指定すると、特定のセッション中の自動アップグレードを有効にすることができます。

例:

snowsql - o noup=False
Copy

あるいは、 設定ファイル に noup = False オプションを追加して、 SnowSQL の自動アップグレードを有効にします。

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

注釈

SnowSQL バージョン1.3.0以降を使用している場合、このプロセスを使用して1.2.xバージョンを実行することはできません。1.2.xバージョンを実行したい場合は、手動で以前のバージョンをダウンロードしてインストールする必要があります。

バージョン1.3.1など、 SnowSQL の最新バージョンで問題が発生した場合、一時的に別の1.3.xバージョンを実行することができます。

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

$ snowsql -v

  Version: 1.3.1
Copy

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

$ snowsql --versions

 1.3.1
 1.3.0
Copy

リストから以前の SnowSQL バージョンをインストールするには、 -v オプションを使用して、インストールするバージョンを指定します。たとえば、1.3.1などの新しいバージョンを使用している場合に、バージョン1.3.0をインストールするには、次のようにします。

$ snowsql -v 1.3.0

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

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

$ snowsql -v 1.3.0
Copy

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

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

新しいユーザー

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

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

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

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

既存のユーザー

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

repository_base_url=https://sfc-repo.azure.snowflakecomputing.com/snowsql
Copy
言語: 日本語