Installieren von SnowSQL

Unter diesem Thema wird beschrieben, wie Sie SnowSQL herunterladen und auf allen unterstützten Plattformen installieren.

Um das SnowSQL-Installationsprogramm herunterzuladen, gehen Sie auf die Seite SnowSQL-Download.

Bemerkung

  • Zur Aktualisierung auf eine neue Patch-Version müssen Sie das Installationsprogramm nicht herunterladen und ausführen. SnowSQL führt das Upgrade automatisch aus. Weitere Informationen dazu finden Sie unter Was ist ein Auto-Upgrade? (unter diesem Thema).

Unter diesem Thema:

Installieren von SnowSQL unter Linux mithilfe des Installers

In diesem Abschnitt wird beschrieben, wie Sie das Installationspaket herunterladen, verifizieren und ausführen, um SnowSQL unter Linux zu installieren.

Standardmäßig richtet das Installationsprogramm SnowSQL so ein, dass Patch-Versionen automatisch aktualisiert werden. Weitere Informationen zum Auto-Upgrade-Feature finden Sie unter Was ist ein Auto-Upgrade? (unter diesem Thema).

Wenn Sie es vorziehen, SnowSQL manuell zu aktualisieren (z. B. wenn Ihre Software-Installationsrichtlinie automatische Upgrades verbietet), verwenden Sie für die Installation von SnowSQL das RPM-Paket. Mit dem RPM-Paket wird SnowSQL nicht für automatische Upgrades eingerichtet. Eine Anleitung dazu finden Sie unter Installieren von SnowSQL unter Linux mithilfe des RPM-Pakets (unter diesem Thema).

Festlegen des Downloadverzeichnisses und des Speicherorts für die Konfigurationsdatei

Standardmäßig lädt der SnowSQL-Installer die Binärdateien in das folgende Verzeichnis herunter:

~/.snowsql

Daher befindet sich die Konfigurationsdatei im Downloadverzeichnis:

~/.snowsql/config

Um sowohl das Downloadverzeichnis als auch den Speicherort der Konfigurationsdatei zu ändern, setzen Sie die Umgebungsvariable WORKSPACE auf ein beliebiges vom Benutzer beschreibbares Verzeichnis. Dieser Ansatz ist besonders nützlich, wenn Sie für jeden Prozess eine isolierte SnowSQL-Umgebung verwenden.

Außerdem können Sie das Downloadverzeichnis von der Konfigurationsdatei trennen, indem Sie die Umgebungsvariable SNOWSQL_DOWNLOAD_DIR festlegen, sodass die Binärdateien von mehreren SnowSQL-Prozessen gemeinsam genutzt werden können. Beispiel:

$ SNOWSQL_DOWNLOAD_DIR=/var/shared snowsql -h
Copy

Beachten Sie, dass SNOWSQL_DOWNLOAD_DIR erst ab SnowSQL-Bootstrap-Version 1.1.70 unterstützt wird. Um die von Ihnen verwendete Version zu überprüfen, führen Sie über die Eingabeaufforderung des Terminalfensters den folgenden Befehl aus:

$ snowsql --bootstrap-version
Copy

Herunterladen des SnowSQL-Installers

Gehen Sie auf die Seite SnowSQL-Download, suchen Sie die Version von SnowSQL, die Sie installieren möchten, und laden Sie die Dateien mit den folgenden Dateinamenerweiterungen herunter:

Verwenden von Curl zum Herunterladen des SnowSQL-Installationsprogramm

Wenn Sie das Installationsprogramm über ein Skript oder ein Terminalfenster herunterladen möchten (z. B. mit curl anstelle des Webbrowsers), können Sie die Installationsprogramme direkt aus dem Snowflake Client Repository herunterladen. Für mehr Flexibilität stellt Snowflake für das Repository sowohl Endpunkte für Amazon Web Services (AWS) als auch für Azure bereit. Auf einer unterstützten Cloudplattform gehostete Konten können das Installationsprogramm von beiden Endpunkten herunterladen.

Führen Sie curl (oder ein gleichwertiges Befehlszeilentool) aus, um den Installer herunterzuladen. Die curl-Syntax lautet wie folgt:

AWS-Endpunkt
$ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/<bootstrap_version>/linux_x86_64/snowsql-<version>-linux_x86_64.bash
Copy
Microsoft Azure-Endpunkt
$ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/<bootstrap_version>/linux_x86_64/snowsql-<version>-linux_x86_64.bash
Copy

Wobei:

  • <Version> ist die kombinierte Haupt-, Neben- und Patchversion von SnowSQL. Beispielsweise ist bei Version 1.2.3 die Hauptversion 1, die Nebenversion 2 und die Patch-Version 3. Die Version ist also 1.2.3.

  • <Bootstrap-Version> ist die kombinierte Haupt- und Nebenversion von SnowSQL. Beispielsweise ist bei Version 1.2.3 die Hauptversion 1 und die Nebenversion 2, sodass die Bootstrap-Version 1.2 ist.

So laden Sie beispielsweise den SnowSQL-Installer herunter, wobei <Bootstrap-Version> den Wert „1.2“ und <Version> den Wert 1.2.31 hat:

AWS-Endpunkt
$ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/1.2/linux_x86_64/snowsql-1.2.31-linux_x86_64.bash
Microsoft Azure-Endpunkt
$ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/1.2/linux_x86_64/snowsql-1.2.31-linux_x86_64.bash

Weitere Informationen zu SnowSQL-Versionen finden Sie unter Erläuterungen zur SnowSQL-Versionierung (unter diesem Thema).

Überprüfen der Paketsignatur

So überprüfen Sie die Signatur des heruntergeladenen Pakets:

  1. Laden Sie den neuesten öffentlichen Snowflake-GPG-Schlüssel über die klassische Weboberfläche oder vom öffentlichen Keyserver herunter, und importieren Sie diesen:

    Download über die Weboberfläche
    1. Klicken Sie auf der klassischen Weboberfläche auf Help Help tab » Download…, um das Dialogfeld Downloads anzuzeigen.

    2. Wählen Sie auf der linken Seite CLI Client (snowsql) aus, und klicken Sie dann auf der rechten Seite auf das Symbol Snowflake GPG Public Key.

    Download vom Keyserver

    Geben Sie den folgenden Befehl ein, und verwenden Sie den GPG-Schlüssel, der mit der SnowSQL-Version verbunden ist:

    • Für SnowSQL 1.2.24 und höher:

      $ gpg --keyserver hkp://keyserver.ubuntu.com --recv-keys 630D9F3CAB551AF3
    • Für SnowSQL-Version 1.2.11 bis 1.2.23:

      $ gpg --keyserver hkp://keyserver.ubuntu.com --recv-keys 37C7086698CB005C
    • Für SnowSQL-Version 1.1.75 bis 1.2.10:

      $ gpg --keyserver hkp://keyserver.ubuntu.com --recv-keys EC218558EABB25A1
    • Für SnowSQL-Version 1.1.74 und niedriger:

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

    Bemerkung

    Wenn dieser Befehl mit der folgenden Fehlermeldung fehlschlägt:

    gpg: keyserver receive failed: Server indicated a failure
    
    Copy

    Geben Sie an, dass Sie Port 80 für den Keyserver verwenden möchten:

    gpg --keyserver hkp://keyserver.ubuntu.com:80  ...
    
    Copy
  2. Laden Sie die GPG-Signatur herunter, und überprüfen Sie die Signatur:

    # 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

    Oder laden Sie die Signaturdatei vom Azure-Endpunkt herunter:

    # 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

    Bemerkung

    Die Überprüfung der Signatur führt zu einer Warnung ähnlich der folgenden:

    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

    Um die Warnung zu vermeiden, können Sie dem öffentlichen Snowflake-GPG-Schlüssel implizites Vertrauen gewähren.

  3. Ihre lokale Umgebung kann mehrere GPG-Schlüssel enthalten. Aus Sicherheitsgründen rotiert Snowflake jedoch regelmäßig den öffentlichen GPG-Schlüssel. Als Best Practice empfehlen wir, den vorhandenen öffentlichen Schlüssel zu löschen, nachdem wir bestätigt haben, dass der letzte Schlüssel mit dem zuletzt signierten Paket funktioniert. Beispiel:

    $ gpg --delete-key "Snowflake Computing"
    
    Copy

Installieren von SnowSQL mithilfe des Installers

  1. Öffnen Sie ein Terminalfenster.

  2. Führen Sie das Bash-Skript-Installationsprogramm vom Download-Speicherort aus:

    $ bash snowsql-linux_x86_64.bash
    
    Copy
  3. Befolgen Sie die Anweisungen des Installers.

Bemerkung

Die Installation kann durch das Festlegen der folgenden Umgebungsvariablen automatisiert werden:

  • SNOWSQL_DEST: Zielverzeichnis der ausführbaren snowsql-Datei.

  • SNOWSQL_LOGIN_SHELL: Die Initialisierungsdatei der Anmelde-Shell, die das Update der PATH-Umgebung enthält.

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

Wenn Sie eine neue Haupt- oder Nebenversion installieren, aktualisiert sich SnowSQL nicht sofort. Stattdessen müssen Sie sich mit SnowSQL bei Ihrem Snowflake-Konto anmelden und für einen ausreichenden Zeitraum in Verbindung bleiben, damit die automatische Upgrade-Funktion den Client auf die neueste Version aktualisieren kann. Um die SnowSQL-Version zu bestimmen, die momentan bei Ausführung des Clients gestartet wird, verwenden Sie die Option -v ohne Wert:

$ snowsql -v

  Version: 1.2.3
Copy

Um SnowSQL zur Installation und Verwendung einer bestimmten Version zu zwingen, verwenden Sie die Option -v und geben Sie die Version an, die Sie installieren möchten. Führen Sie beispielsweise den folgenden Befehl für Version 1.2.5 aus:

$ snowsql -v 1.2.5
Copy

Installieren von SnowSQL unter Linux mithilfe des RPM-Pakets

Die Softwareinstallationsrichtlinie in einigen Organisationen verbietet die automatische Aktualisierung. Wenn in Ihrem Unternehmen diese Richtlinie gilt oder wenn Sie es vorziehen, Software manuell zu aktualisieren, können Sie das RPM-Paket (anstelle des Installationsprogramms) zur Installation von SnowSQL verwenden. Das RPM-Paket unterstützt keine automatischen Upgrades.

Weitere Informationen zum Auto-Upgrade-Feature finden Sie unter Was ist ein Auto-Upgrade? (unter diesem Thema).

Herunterladen des SnowSQL-RPM-Pakets

Gehen Sie auf die Seite SnowSQL-Download, suchen Sie die Version von SnowSQL, die Sie installieren möchten, und laden Sie die Datei mit der Dateinamenerweiterung .rpm herunter.

Installieren des SnowSQL-RPM-Pakets

Die heruntergeladene RPM-Datei kann so installiert werden, wie jedes andere RPM-Paket installiert wird:

rpm -i <package_name>
Copy

Installieren von SnowSQL unter macOS mithilfe des Installers

In diesem Abschnitt wird beschrieben, wie Sie das Installationspaket herunterladen und ausführen, um SnowSQL unter macOS zu installieren.

Festlegen des Downloadverzeichnisses und des Speicherorts für die Konfigurationsdatei

Standardmäßig lädt der SnowSQL-Installer die Binärdateien in das folgende Verzeichnis herunter:

~/.snowsql

Daher befindet sich die Konfigurationsdatei im Downloadverzeichnis:

~/.snowsql/config

Sie können sowohl das Downloadverzeichnis als auch den Speicherort der Konfigurationsdatei ändern, indem Sie die Umgebungsvariable WORKSPACE auf ein beliebiges vom Benutzer schreibbares Verzeichnis setzen. Dies ist besonders nützlich, wenn Sie für jeden Prozess eine isolierte SnowSQL-Umgebung verwenden.

Außerdem können Sie das Downloadverzeichnis von der Konfigurationsdatei trennen, indem Sie die Umgebungsvariable SNOWSQL_DOWNLOAD_DIR festlegen, sodass die Binärdateien von mehreren SnowSQL-Prozessen gemeinsam genutzt werden können. Beispiel:

$ SNOWSQL_DOWNLOAD_DIR=/var/shared snowsql -h
Copy

Beachten Sie, dass SNOWSQL_DOWNLOAD_DIR erst ab SnowSQL-Bootstrap-Version 1.1.70 unterstützt wird. Um die von Ihnen verwendete Version zu überprüfen, führen Sie über die Eingabeaufforderung des Terminalfensters den folgenden Befehl aus:

$ snowsql --bootstrap-version
Copy

Herunterladen des SnowSQL-Installers

Um das SnowSQL-Installationsprogramm herunterzuladen, gehen Sie auf die Seite SnowSQL-Download. Diese Version des SnowSQL-Installers aktiviert das automatische Upgrade für Patches.

Verwenden von Curl zum Herunterladen des SnowSQL-Installationsprogramm

Wenn Sie das Installationsprogramm über ein Skript oder ein Terminalfenster herunterladen möchten (z. B. mit curl anstelle des Webbrowsers), können Sie die Installationsprogramme direkt aus dem Snowflake Client Repository herunterladen. Für mehr Flexibilität stellt Snowflake für das Repository sowohl Endpunkte für Amazon Web Services (AWS) als auch für Azure bereit. Auf einer unterstützten Cloudplattform gehostete Konten können das Installationsprogramm von beiden Endpunkten herunterladen.

Führen Sie curl (oder ein gleichwertiges Befehlszeilentool) aus, um den Installer herunterzuladen. Die curl-Syntax lautet wie folgt:

AWS-Endpunkt
$ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/<bootstrap_version>/darwin_x86_64/snowsql-<version>-darwin_x86_64.pkg
Copy
Microsoft Azure-Endpunkt
$ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/<bootstrap_version>/darwin_x86_64/snowsql-<version>-darwin_x86_64.pkg
Copy

Wobei:

  • <Version> ist die kombinierte Haupt-, Neben- und Patchversion von SnowSQL. Beispielsweise ist bei Version 1.2.3 die Hauptversion 1, die Nebenversion 2 und die Patch-Version 3. Die Version ist also 1.2.3.

  • <Bootstrap-Version> ist die kombinierte Haupt- und Nebenversion von SnowSQL. Beispielsweise ist bei Version 1.2.3 die Hauptversion 1 und die Nebenversion 2, sodass die Bootstrap-Version 1.2 ist.

So laden Sie beispielsweise den SnowSQL-Installer herunter, wobei <Bootstrap-Version> den Wert „1.2“ und <Version> den Wert 1.2.31 hat:

AWS-Endpunkt
$ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/1.2/darwin_x86_64/snowsql-1.2.31-darwin_x86_64.pkg
Microsoft Azure-Endpunkt
$ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/1.2/darwin_x86_64/snowsql-1.2.31-darwin_x86_64.pkg

Weitere Informationen zu SnowSQL-Versionen finden Sie unter Erläuterungen zur SnowSQL-Versionierung (unter diesem Thema).

Das macOS-Betriebssystem kann die Signatur des Installationsprogramms automatisch überprüfen, sodass keine GPG-Signaturprüfung erforderlich ist.

Installieren von SnowSQL mithilfe des Installers

  1. Doppelklicken Sie im Download-Speicherort auf snowsql-darwin_x86_64.pkg, um die PKG-Installationsdatei auszuführen.

  2. Befolgen Sie die Anweisungen des Installers.

Bemerkung

Die Installation kann automatisiert werden, indem Sie den Installer über die Befehlszeile ausführen. Als Zielverzeichnis kann entweder CurrentUserHomeDirectory (~/Applications-Verzeichnis) oder LocalSystem (/Applications-Verzeichnis) eingestellt sein:

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

Wenn Sie eine neue Haupt- oder Nebenversion installieren, aktualisiert sich SnowSQL nicht sofort. Stattdessen müssen Sie sich mit SnowSQL bei Ihrem Snowflake-Konto anmelden und für einen ausreichenden Zeitraum in Verbindung bleiben, damit die automatische Upgrade-Funktion den Client auf die neueste Version aktualisieren kann. Um die SnowSQL-Version zu bestimmen, die momentan bei Ausführung des Clients gestartet wird, verwenden Sie die Option -v ohne Wert:

$ snowsql -v

  Version: 1.2.3
Copy

Um SnowSQL zur Installation und Verwendung einer bestimmten Version zu zwingen, verwenden Sie die Option -v und geben Sie die Version an, die Sie installieren möchten. Führen Sie beispielsweise den folgenden Befehl für Version 1.2.5 aus:

$ snowsql -v 1.2.5
Copy

Konfigurieren des Z Shell-Alias (nur macOS)

Wenn Z Shell (auch als zsh bekannt) Ihre Standardterminalshell ist, legen Sie einen Alias für die ausführbare SnowSQL-Datei fest, damit Sie SnowSQL über die Befehlszeile der Terminalshell ausführen können. Das SnowSQL-Installationsprogramm installiert die ausführbare Datei unter /Applications/SnowSQL.app/Contents/MacOS/snowsql und hängt diesen Pfad an den PATH-Eintrag oder den Alias-Eintrag in ~/.profile an. Da zsh diese Datei normalerweise nicht liest, fügen Sie einen Alias für diesen Pfad in ~/.zshrc hinzu, da zsh diese Datei auf jeden Fall liest.

So fügen Sie der ausführbaren SnowSQL-Datei einen Alias hinzu:

  1. Öffnen Sie die ~/.zshrc-Datei (oder erstellen Sie diese, falls sie fehlt).

  2. Fügen Sie die folgende Zeile hinzu:

    alias snowsql=/Applications/SnowSQL.app/Contents/MacOS/snowsql
    
    Copy
  3. Speichern Sie die Datei.

Installieren von SnowSQL unter macOS mit Homebrew Cask

Homebrew Cask ist eine beliebte Erweiterung von Homebrew für die Verteilung, Installation und Wartung von Paketen. Es gibt keinen separaten SnowSQL-Installer zum Herunterladen. Wenn Homebrew Cask auf Ihrer macOS-Plattform installiert ist, können Sie Snowflake direkt installieren.

Führen Sie den Befehl brew install aus, und geben Sie snowflake-snowsql als das zu installierende Paket an:

$ brew install --cask snowflake-snowsql
Copy

Konfigurieren des Z Shell-Alias (nur macOS)

Wenn Z Shell (auch als zsh bekannt) Ihre Standardterminalshell ist, legen Sie einen Alias für die ausführbare SnowSQL-Datei fest, damit Sie SnowSQL über die Befehlszeile der Terminalshell ausführen können. Das SnowSQL-Installationsprogramm installiert die ausführbare Datei unter /Applications/SnowSQL.app/Contents/MacOS/snowsql und hängt diesen Pfad an den PATH-Eintrag oder den Alias-Eintrag in ~/.profile an. Da zsh diese Datei normalerweise nicht liest, fügen Sie einen Alias für diesen Pfad in ~/.zshrc hinzu, da zsh diese Datei auf jeden Fall liest.

So fügen Sie der ausführbaren SnowSQL-Datei einen Alias hinzu:

  1. Öffnen Sie die ~/.zshrc-Datei (oder erstellen Sie diese, falls sie fehlt).

  2. Fügen Sie die folgende Zeile hinzu:

    alias snowsql=/Applications/SnowSQL.app/Contents/MacOS/snowsql
    
    Copy
  3. Speichern Sie die Datei.

Installieren von SnowSQL unter Microsoft Windows mithilfe des Installers

In diesem Abschnitt wird beschrieben, wie Sie das Installationspaket herunterladen und ausführen, um SnowSQL unter Microsoft Windows zu installieren.

Festlegen des Downloadverzeichnisses und des Speicherorts für die Konfigurationsdatei

Standardmäßig lädt der SnowSQL-Installer die Binärdateien in das folgende Verzeichnis herunter:

%USERPROFILE%\.snowsql

Daher befindet sich die Konfigurationsdatei im Downloadverzeichnis:

%USERPROFILE%\.snowsql\config

Sie können sowohl das Downloadverzeichnis als auch den Speicherort der Konfigurationsdatei ändern, indem Sie die Umgebungsvariable WORKSPACE auf ein beliebiges vom Benutzer schreibbares Verzeichnis setzen. Dies ist besonders nützlich, wenn Sie für jeden Prozess eine isolierte SnowSQL-Umgebung verwenden.

Außerdem können Sie das Downloadverzeichnis von der Konfigurationsdatei trennen, indem Sie die Umgebungsvariable SNOWSQL_DOWNLOAD_DIR festlegen, sodass die Binärdateien von mehreren SnowSQL-Prozessen gemeinsam genutzt werden können. Beispiel:

$ SNOWSQL_DOWNLOAD_DIR=/var/shared snowsql -h
Copy

Beachten Sie, dass SNOWSQL_DOWNLOAD_DIR erst ab SnowSQL-Bootstrap-Version 1.1.70 unterstützt wird. Um die von Ihnen verwendete Version zu überprüfen, führen Sie über die Eingabeaufforderung des Terminalfensters den folgenden Befehl aus:

$ snowsql --bootstrap-version
Copy

Herunterladen des SnowSQL-Installers

Um das SnowSQL-Installationsprogramm herunterzuladen, gehen Sie auf die Seite SnowSQL-Download. Diese Version des SnowSQL-Installers aktiviert das automatische Upgrade für Patches.

Verwenden von Curl zum Herunterladen des SnowSQL-Installationsprogramm

Wenn Sie das Installationsprogramm über ein Skript oder ein Terminalfenster herunterladen möchten (z. B. mit curl anstelle des Webbrowsers), können Sie die Installationsprogramme direkt aus dem Snowflake Client Repository herunterladen. Für mehr Flexibilität stellt Snowflake für das Repository sowohl Endpunkte für Amazon Web Services (AWS) als auch für Azure bereit. Auf einer unterstützten Cloudplattform gehostete Konten können das Installationsprogramm von beiden Endpunkten herunterladen.

Führen Sie curl (oder ein gleichwertiges Befehlszeilentool) aus, um den Installer herunterzuladen. Die curl-Syntax lautet wie folgt:

AWS-Endpunkt
$ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/<bootstrap_version>/windows_x86_64/snowsql-<version>-windows_x86_64.msi
Copy
Microsoft Azure-Endpunkt
$ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/<bootstrap_version>/windows_x86_64/snowsql-<version>-windows_x86_64.msi
Copy

Wobei:

  • <Version> ist die kombinierte Haupt-, Neben- und Patchversion von SnowSQL. Beispielsweise ist bei Version 1.2.3 die Hauptversion 1, die Nebenversion 2 und die Patch-Version 3. Die Version ist also 1.2.3.

  • <Bootstrap-Version> ist die kombinierte Haupt- und Nebenversion von SnowSQL. Beispielsweise ist bei Version 1.2.3 die Hauptversion 1 und die Nebenversion 2, sodass die Bootstrap-Version 1.2 ist.

So laden Sie beispielsweise den SnowSQL-Installer herunter, wobei <Bootstrap-Version> den Wert „1.2“ und <Version> den Wert 1.2.31 hat:

AWS-Endpunkt
$ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/1.2/windows_x86_64/snowsql-1.2.31-windows_x86_64.msi
Microsoft Azure-Endpunkt
$ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/1.2/windows_x86_64/snowsql-1.2.31-windows_x86_64.msi

Weitere Informationen zu SnowSQL-Versionen finden Sie unter Erläuterungen zur SnowSQL-Versionierung (unter diesem Thema).

Das Windows-Betriebssystem kann die Signatur des Installers automatisch überprüfen, sodass keine GPG-Signaturprüfung erforderlich ist.

Installieren von SnowSQL mithilfe des Installers

  1. Doppelklicken Sie im Download-Speicherort auf snowsql-windows_x86_64.msi, um die MSI-Installationsdatei auszuführen.

  2. Befolgen Sie die Anweisungen des Installers.

Bemerkung

Die Installation kann automatisiert werden, indem Sie den MSI-Installer msiexec über die Befehlszeile ausführen. Das Zielverzeichnis %ProgramFiles%\Snowflake SnowSQL kann nicht geändert werden. Beispiel:

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

Wenn Sie eine neue Haupt- oder Nebenversion installieren, aktualisiert sich SnowSQL nicht sofort. Stattdessen müssen Sie sich mit SnowSQL bei Ihrem Snowflake-Konto anmelden und für einen ausreichenden Zeitraum in Verbindung bleiben, damit die automatische Upgrade-Funktion den Client auf die neueste Version aktualisieren kann. Um die SnowSQL-Version zu bestimmen, die momentan bei Ausführung des Clients gestartet wird, verwenden Sie die Option -v ohne Wert:

$ snowsql -v

  Version: 1.2.3
Copy

Um SnowSQL zur Installation und Verwendung einer bestimmten Version zu zwingen, verwenden Sie die Option -v und geben Sie die Version an, die Sie installieren möchten. Führen Sie beispielsweise den folgenden Befehl für Version 1.2.5 aus:

$ snowsql -v 1.2.5
Copy

Erläuterungen zur SnowSQL-Versionierung

SnowSQL-Versionsnummern bestehen aus drei Ziffern: <Hauptversion>.<Nebenversion>.<Patchversion>.

So zeigt beispielsweise die Version 1.2.3 an, dass die Hauptversion 1, die Nebenversion 2 und die Patchversion 3 ist.

Um die SnowSQL-Version zu bestimmen, die momentan bei Ausführung des Clients gestartet wird, verwenden Sie die Option -v ohne Wert:

$ snowsql -v

  Version: 1.2.3
Copy

Im Allgemeinen gelten die folgenden Richtlinien für die verschiedenen Versionstypen:

Hauptversion

Eine Änderung in der Hauptversion deutet auf dramatische Verbesserungen im zugrunde liegenden Snowflake-Service hin. Eine neue Hauptversion bricht die Abwärtskompatibilität. Sie müssen die neueste SnowSQL-Version über die Weboberfläche herunterladen und installieren.

Nebenversion

Eine Änderung in der Nebenversion deutet auf Verbesserungen bei der Unterstützung der Aufwärtskompatibilität entweder in SnowSQL oder dem zugrunde liegenden Snowflake-Service hin. Eine neue Nebenversion bricht die Abwärtskompatibilität nicht, aber wir empfehlen dringend, dass Sie die neueste SnowSQL-Version über die Weboberfläche herunterladen und installieren.

Patch-Version

Eine Änderung in der Patchversion zeigt an, dass kleine Verbesserungen oder Fehlerkorrekturen vorgenommen wurden. Die Auto-Upgrade-Funktion installiert automatisch alle Patchversionen. Weitere Informationen zur Auto-Upgrade-Funktion finden Sie unter Was ist ein Auto-Upgrade? (unter diesem Thema).

Bemerkung

Wenn eine Nebenversion veröffentlicht wird, sollten die Funktionen Ihrer aktuellen Version weiterhin funktionieren, aber die neu veröffentlichten Fehlerkorrekturen und Features werden nicht über die Auto-Upgrade-Funktion verfügbar sein. Daher empfehlen wir Ihnen dringend, die neueste SnowSQL-Version herunterzuladen und zu installieren, wenn die Nebenversion erhöht wird.

Was ist ein Auto-Upgrade?

Standardmäßig aktualisiert sich SnowSQL automatisch auf die neueste Patchversion oder den neuesten Build. Eine neue Haupt- oder Nebenversion erfordert einen manuellen Download und eine manuelle Installation.

Wenn eine neuere Patchversion oder ein neuerer Build verfügbar ist, lädt SnowSQL die neue Binärdatei in einem Hintergrundprozess herunter und führt die aktuelle Version aus. Wenn Sie SnowSQL das nächste Mal ausführen, startet die neue Version.

Der Prozess lässt sich wie folgt veranschaulichen:

  1. Für eine Neuinstallation laden Sie den SnowSQL-Installer (z. B. Version 1.2.0) über die Snowflake-Weboberfläche herunter und installieren den Client.

  2. Jedes Mal, wenn Sie SnowSQL ausführen, überprüft der Client, ob im SnowSQL-Upgrade-Repository eine neuere Version verfügbar ist.

  3. Wenn eine neuere Version (z. B. Version 1.2.1) verfügbar ist, lädt SnowSQL diese als Hintergrundprozess herunter, während die aktuell installierte Version ausgeführt wird.

  4. Wenn Sie SnowSQL das nächste Mal ausführen, führt der Client die Version 1.2.1 aus und prüft, ob eine neuere Version verfügbar ist.

Deaktivieren des automatischen Upgrades

Die Option --noup verhindert, dass SnowSQL eine neue Version herunterlädt, falls verfügbar. Sie können diese Option beim Anmelden bei Snowflake angeben, um ein automatisches Upgrade während dieser speziellen Sitzung zu verhindern.

Beispiel:

$ snowsql --noup
Copy

Alternativ können Sie die Option noup = true zur Konfigurationsdatei hinzufügen, um zu verhindern, dass SnowSQL das automatische Upgrade so lange verhindert, bis die Option entfernt oder auf false gesetzt wird.

Ausführen einer vorherigen SnowSQL-Version

Wenn Sie ein Problem mit der neuesten SnowSQL-Version haben, z. B. mit Version 1.2.2, können Sie vorübergehend eine vorherige Version ausführen.

Um die SnowSQL-Version zu bestimmen, die momentan bei Ausführung des Clients gestartet wird, verwenden Sie die Option -v ohne Wert:

$ snowsql -v

  Version: 1.2.2
Copy

Um eine Liste der verfügbaren SnowSQL-Versionen anzuzeigen, verwenden Sie die Option --versions:

$ snowsql --versions

  1.2.3
  1.2.2
  1.2.1
  1.2.0
Copy

Um eine frühere SnowSQL-Version aus der Liste zu installieren, verwenden Sie die Option -v. Geben Sie die Version an, die Sie installieren möchten. So installieren Sie beispielsweise die Version 1.2.3:

$ snowsql -v 1.2.3

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

Verwenden Sie die gleiche Option, um die Version anzugeben, die Sie beim Start von SnowSQL ausführen möchten:

$ snowsql -v 1.2.3
Copy

Ändern des vom SnowSQL-Auto-Upgrade-Feature verwendeten Snowflake Client Repository-Endpunkts

Standardmäßig verwendet die automatische Aktualisierungsfunktion von SnowSQL den AWS-Endpunkt des Snowflake Client Repository. Führen Sie die Schritte in diesem Abschnitt aus, um den Endpunkt in der SnowSQL-Konfigurationsdatei zu ändern.

Neue Benutzer

Führen Sie den folgenden Befehl aus, um den Microsoft Azure-Endpunkt des Snowflake Client Repository als neuen SnowSQL-Benutzer anzugeben:

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

Überprüfen Sie, ob die Konfigurationsdatei (d. h. ~/.snowsql/config oder %USERPROFILE%\.snowsql\config) die folgende Zeile enthält.

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

Vorhandene Benutzer

Fügen Sie der Konfigurationsdatei die folgende Zeile hinzu, um den Microsoft Azure-Endpunkt des Snowflake Client Repository als vorhandenen SnowSQL-Benutzer anzugeben (d. h. ~/.snowsql/config oder %USERPROFILE%\.snowsql\config):

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