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

Mit dem Release SnowSQL 1.3.0 wurden automatische Upgrades deaktiviert, sodass Sie jede neue Version manuell herunterladen und neu installieren müssen.

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.

Wenn Sie SnowSQL manuell aktualisieren möchten (z. B. wenn Ihre Software-Installationsrichtlinie eine automatische Aktualisierung verbietet), verwenden Sie das RPM-Paket, um SnowSQL zu installieren. 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 nicht über Ihren Browser, sondern über ein Skript oder ein Terminalfenster herunterladen möchten (z. B. mit curl), können Sie die Installationsprogramme direkt von 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 Cloud-Plattform 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.3.1 die Hauptversion 1, die Nebenversion 3 und die Patch-Version 1. Die Version ist also 1.3.1.

  • <Bootstrap-Version> ist die kombinierte Haupt- und Nebenversion von SnowSQL. Beispielsweise ist bei Version 1.3.1 die Hauptversion 1 und die Nebenversion 3, sodass die Bootstrap-Version 1.3 ist.

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

AWS-Endpunkt:
$ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/1.3/linux_x86_64/snowsql-1.3.2-linux_x86_64.bash
Microsoft Azure-Endpunkt:
$ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/1.3/linux_x86_64/snowsql-1.3.2-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. Wählen Sie unter Classic Console die Option Help Registerkarte „Hilfe“ » Download…, um das Dialogfeld Downloads anzuzeigen.

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

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

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

    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
Copy
Version: 1.3.1

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.3.0 aus:

snowsql -v 1.3.0
Copy

Installieren von SnowSQL unter Linux mithilfe des RPM-Pakets

Um die Software manuell zu aktualisieren, können Sie das Paket RPM (anstelle des Installationsprogramms) verwenden, um SnowSQL zu installieren. Das RPM-Paket unterstützt keine automatischen Upgrades.

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 nicht über Ihren Browser, sondern über ein Skript oder ein Terminalfenster herunterladen möchten (z. B. mit curl), können Sie die Installationsprogramme direkt von 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 Cloud-Plattform 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.3.1 die Hauptversion 1, die Nebenversion 3 und die Patch-Version 1. Die Version ist also 1.3.1.

  • <Bootstrap-Version> ist die kombinierte Haupt- und Nebenversion von SnowSQL. Beispielsweise ist bei Version 1.3.1 die Hauptversion 1 und die Nebenversion 3, sodass die Bootstrap-Version 1.3 ist.

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

AWS-Endpunkt:
curl -O \https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/1.3/darwin_x86_64/snowsql-\ |snowsql-version|\ -darwin_x86_64.pkg
Copy
Microsoft Azure-Endpunkt:
curl -O \https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/1.3/darwin_x86_64/snowsql-\ |snowsql-version|\ -darwin_x86_64.pkg
Copy

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. Öffnen Sie snowsql-darwin_x86_64.pkg im Speicherort des Downloads, um die Datei PKG zu installieren.

  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
Copy
Version: 1.3.0

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.3.1 aus:

snowsql -v 1.3.1
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 nicht über Ihren Browser, sondern über ein Skript oder ein Terminalfenster herunterladen möchten (z. B. mit curl), können Sie die Installationsprogramme direkt von 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 Cloud-Plattform 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.3.1 die Hauptversion 1, die Nebenversion 3 und die Patch-Version 1. Die Version ist also 1.3.1.

  • <Bootstrap-Version> ist die kombinierte Haupt- und Nebenversion von SnowSQL. Beispielsweise ist bei Version 1.3.1 die Hauptversion 1 und die Nebenversion 3, sodass die Bootstrap-Version 1.3 ist.

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

AWS-Endpunkt:
curl -O \https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/1.3/windows_x86_64/snowsql-\ |snowsql-version|\ -windows_x86_64.msi
Copy
Microsoft Azure-Endpunkt:
curl -O \https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/1.3/windows_x86_64/snowsql-\ |snowsql-version|\ -windows_x86_64.msi
Copy

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. Öffnen Sie snowsql-windows_x86_64.msi im Speicherort des Downloads, um die Datei MSI zu installieren.

  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
Copy
Version: 1.3.1

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.3.0 aus:

snowsql -v 1.3.0
Copy

Erläuterungen zur SnowSQL-Versionierung

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

So zeigt beispielsweise die Version 1.3.1 an, dass die Hauptversion 1, die Nebenversion 3 und die Patchversion 1 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
Copy
Version: 1.3.1

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 Snowflake empfiehlt 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 Snowflake eine neue Neben- oder Patch-Version veröffentlicht, sollten die Funktionen Ihrer aktuellen Version weiterhin funktionieren, aber die neu veröffentlichten Fehlerkorrekturen und Features werden not über die Auto-Upgrade-Funktion verfügbar sein. Wir empfehlen Ihnen daher dringend, die neueste Version von SnowSQL herunterzuladen und zu installieren, sobald eine neue Version verfügbar ist.

Was ist ein Auto-Upgrade?

Wichtig

Ab Version 1.3.0 deaktiviert SnowSQL standardmäßig automatische Upgrades, um potenzielle Probleme zu vermeiden, die sich auf Produktionsumgebungen auswirken können, wenn ein automatisches Upgrade erfolgt. Um ein Upgrade durchzuführen, sollten Sie neue Versionen manuell herunterladen und installieren, vorzugsweise in einer nicht produktiven Umgebung. Snowflake empfiehlt Ihnen dringend, diese Einstellung deaktiviert zu lassen. Wenn Sie jedoch neue Versionen automatisch installieren möchten, sobald sie freigegeben werden, können Sie die SnowSQL --noup Option deaktivieren.

Wenn Sie die automatischen Upgrades für SnowSQL aktivieren, lädt SnowSQL die neue binäre Version automatisch 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. Bei einer Neuinstallation laden Sie das Installationsprogramm SnowSQL (z. B. Version 1.3.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.3.1) verfügbar ist, lädt SnowSQL diese als Hintergrundprozess herunter, während die aktuell installierte Version weiterläuft.

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

Auto-Upgrade aktivieren

Mit der Option -o noup=<Wert> können Sie die Verhaltensweise von SnowSQL außer Kraft setzen, wonach für neue Versionen eine manuelle Installation erforderlich ist:

  • True aktiviert die No-Upgrade-Verhaltensweise (Standardwert für Version 1.3.0 und höher). SnowSQL sucht nicht automatisch nach Upgrades und aktualisiert sich automatisch selbst.

  • False deaktiviert die No-Upgrade-Verhaltensweise (Standardwert für Version 1.2.32 und niedriger). SnowSQL sucht automatisch nach Upgrades und aktualisiert sich selbst, wenn ein neues Upgrade für dieselbe Version von major.minor verfügbar ist

Sie können diese Option beim Anmelden bei Snowflake angeben, um ein automatisches Upgrade während dieser speziellen Sitzung zu aktivieren.

Beispiel:

snowsql - o noup=False
Copy

Fügen Sie alternativ die Option noup = False zur Konfigurationsdatei hinzu, um automatische Upgrades für SnowSQL zu aktivieren.

Ausführen einer vorherigen SnowSQL-Version

Bemerkung

Wenn Sie SnowSQL Version 1.3.0 oder neuer verwenden, können Sie diesen Prozess nicht verwenden, um eine 1.2.x-Version auszuführen. Wenn Sie eine 1.2.x-Version verwenden möchten, müssen Sie die frühere Version manuell herunterladen und installieren.

Wenn Sie ein Problem mit der neuesten Version von SnowSQL haben, z. B. mit der Version 1.3.1, können Sie vorübergehend eine andere 1.3.x-Version verwenden.

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

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

$ snowsql --versions

 1.3.1
 1.3.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. Zum Beispiel, um die Version 1.3.0 zu installieren, wenn Sie eine neuere Version, wie 1.3.1, verwenden:

$ snowsql -v 1.3.0

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

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

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