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
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
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:
.bash
(Installationsprogramm).bash.sig
(Signatur zum Verifizieren des heruntergeladenen Pakets)
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
- Microsoft Azure-Endpunkt:
$ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/<bootstrap_version>/linux_x86_64/snowsql-<version>-linux_x86_64.bash
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:
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:
- 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
Geben Sie an, dass Sie Port 80 für den Keyserver verwenden möchten:
gpg --keyserver hkp://keyserver.ubuntu.com:80 ...
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
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
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.
Um die Warnung zu vermeiden, können Sie dem öffentlichen Snowflake-GPG-Schlüssel implizites Vertrauen gewähren.
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"
Installieren von SnowSQL mithilfe des Installers¶
Öffnen Sie ein Terminalfenster.
Führen Sie das Bash-Skript-Installationsprogramm vom Download-Speicherort aus:
bash snowsql-linux_x86_64.bash
Befolgen Sie die Anweisungen des Installers.
Bemerkung
Die Installation kann durch das Festlegen der folgenden Umgebungsvariablen automatisiert werden:
SNOWSQL_DEST
: Zielverzeichnis der ausführbarensnowsql
-Datei.SNOWSQL_LOGIN_SHELL
: Die Initialisierungsdatei der Anmelde-Shell, die das Update derPATH
-Umgebung enthält.
SNOWSQL_DEST=~/bin SNOWSQL_LOGIN_SHELL=~/.profile bash snowsql-linux_x86_64.bash
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.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
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>
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
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
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
- Microsoft Azure-Endpunkt:
curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/<bootstrap_version>/darwin_x86_64/snowsql-<version>-darwin_x86_64.pkg
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
- 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
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¶
Öffnen Sie
snowsql-darwin_x86_64.pkg
im Speicherort des Downloads, um die Datei PKG zu installieren.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
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.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
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:
Öffnen Sie die
~/.zshrc
-Datei (oder erstellen Sie diese, falls sie fehlt).Fügen Sie die folgende Zeile hinzu:
alias snowsql=/Applications/SnowSQL.app/Contents/MacOS/snowsql
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
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:
Öffnen Sie die
~/.zshrc
-Datei (oder erstellen Sie diese, falls sie fehlt).Fügen Sie die folgende Zeile hinzu:
alias snowsql=/Applications/SnowSQL.app/Contents/MacOS/snowsql
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
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
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
- Microsoft Azure-Endpunkt:
curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/<bootstrap_version>/windows_x86_64/snowsql-<version>-windows_x86_64.msi
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
- 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
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¶
Öffnen Sie
snowsql-windows_x86_64.msi
im Speicherort des Downloads, um die Datei MSI zu installieren.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
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.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
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
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:
Bei einer Neuinstallation laden Sie das Installationsprogramm SnowSQL (z. B. Version 1.3.0) über die Snowflake-Weboberfläche herunter und installieren den Client.
Jedes Mal, wenn Sie SnowSQL ausführen, überprüft der Client, ob im SnowSQL-Upgrade-Repository eine neuere Version verfügbar ist.
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.
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 vonmajor.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
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
Um eine Liste der verfügbaren SnowSQL-Versionen anzuzeigen, verwenden Sie die Option --versions
:
$ snowsql --versions 1.3.1 1.3.0
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%
Verwenden Sie die gleiche Option, um die Version anzugeben, die Sie beim Start von SnowSQL ausführen möchten:
$ snowsql -v 1.3.0
Ä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
Ü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
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