SnowSQL のインストール

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

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

注釈

  • 新しいパッチバージョンにアップグレードするためにインストーラーをダウンロードして実行する必要はありません。SnowSQL は自動的にアップグレードされます。詳細については、 自動アップグレードとは (このトピック内)をご参照ください。

このトピックの内容:

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

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

デフォルトでは、インストーラーはパッチバージョンが自動的にアップグレードされるように 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.2.3の場合、メジャーバージョンは1、マイナーバージョンは2、パッチバージョンは3です。したがって、バージョンは1.2.3になります。

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

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

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

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

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

    注釈

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

    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_DESTsnowsql 実行可能ファイルのターゲットディレクトリ。

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

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

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

$ snowsql -v

  Version: 1.2.3
Copy

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

$ snowsql -v 1.2.5
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.2.3の場合、メジャーバージョンは1、マイナーバージョンは2、パッチバージョンは3です。したがって、バージョンは1.2.3になります。

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

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

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

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

  Version: 1.2.3
Copy

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

$ snowsql -v 1.2.5
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.2.3の場合、メジャーバージョンは1、マイナーバージョンは2、パッチバージョンは3です。したがって、バージョンは1.2.3になります。

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

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

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

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

  Version: 1.2.3
Copy

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

$ snowsql -v 1.2.5
Copy

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

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

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

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

$ snowsql -v

  Version: 1.2.3
Copy

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

メジャーバージョン:

メジャーバージョンの変更は、基になる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
Copy

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

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

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

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

$ snowsql -v

  Version: 1.2.2
Copy

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

$ snowsql --versions

  1.2.3
  1.2.2
  1.2.1
  1.2.0
Copy

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

$ snowsql -v 1.2.3

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

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

$ snowsql -v 1.2.3
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