Installieren von Snowflake CLI¶
Unter diesem Thema wird erklärt, wie Sie Snowflake CLI auf unterstützten Plattformen installieren. Beachten Sie, dass Snowflake CLI derzeit nicht für AIX-Systeme verfügbar ist.
Snowflake empfiehlt die Verwendung binärer Installationsmethoden, wie z. B. Paketmanagement, um Snowflake CLI auf Ihrem System zu installieren. Sie können die binären Installationsprogramme aus dem offiziellen Snowflake CLI-Repository herunterladen.
Anforderungen¶
Bevor Sie Snowflake CLI nutzen können, müssen Sie über ein gültiges Snowflake-Konto verfügen.
Um Streamlit in Snowflake unter Snowflake CLI ausführen zu können, müssen Sie über ein Snowflake-Konto mit der Berechtigung zur Nutzung von Streamlit verfügen.
Um Snowpark Container Services in Snowflake unter Verwendung von Snowflake CLI ausführen zu können, müssen Sie über ein Snowflake-Konto mit Berechtigungen zur Nutzung von Snowpark Container Services verfügen.
Tipp
Wenn für Ihr Snowflake-Konto-MFA (mehrstufige Authentifizierung) erforderlich ist, benötigt Snowflake CLI für jeden Befehl eine Genehmigung. Sie können MFA-Caching verwenden, um die Authentifizierung nur einmal alle vier Stunden zu verlangen. Weitere Informationen dazu finden Sie unter Verwenden Sie eine mehrstufige Authentifizierung (MFA).
Snowflake CLI mit Paketmanagern installieren¶
Um Snowflake CLI über plattformspezifische Paketmanager zu installieren, verwenden Sie eine der folgenden Prozeduren:
Installation mit Linux Paketmanagern¶
Wenn Sie ein Linux-Betriebssystem verwenden, können Sie Snowflake CLI mit Paketmanagern installieren, die Folgendes unterstützen:
deb-Pakete,rpm-Pakete.
So installieren Sie Snowflake CLI mithilfe des deb-Paketmanagers:
Laden Sie die Snowflake CLI
debaus dem Snowflake-CLI-Repository herunter.Installieren Sie das Paket, indem Sie den folgenden Befehl ausführen:
sudo dpkg -i snowflake-cli-<version>.deb
So installieren Sie Snowflake CLI mithilfe des rpm-Paketmanagers:
Laden Sie das Paket Snowflake CLI
rpmaus dem Snowflake-CLI-Repository herunter.Installieren Sie das Paket, indem Sie den folgenden Befehl ausführen:
sudo rpm -i snowflake-cli-<version>.rpm
Um zu überprüfen, ob die Software erfolgreich installiert wurde, führen Sie den folgenden Befehl aus:
snow --helpUsage: snow [OPTIONS] COMMAND [ARGS]... Snowflake CLI tool for developers. ╭─ Options ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮ │ --version Shows version of the Snowflake CLI │ │ --info Shows information about the Snowflake CLI │ │ --config-file FILE Specifies Snowflake CLI configuration file that should be used [default: None] │ │ --install-completion Install completion for the current shell. │ │ --show-completion Show completion for the current shell, to copy it or customize the installation. │ │ --help -h Show this message and exit. │ ╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯ ╭─ Commands ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮ │ app Manages a Snowflake Native App │ │ connection Manages connections to Snowflake. │ │ cortex Provides access to Snowflake Cortex. │ │ git Manages git repositories in Snowflake. │ │ notebook Manages notebooks in Snowflake. │ │ object Manages Snowflake objects like warehouses and stages │ │ snowpark Manages procedures and functions. │ │ spcs Manages Snowpark Container Services compute pools, services, image registries, and image repositories. │ │ sql Executes Snowflake query. │ │ stage Manages stages. │ │ streamlit Manages a Streamlit app in Snowflake. │ ╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
Installieren Sie mit dem MacOS-Paket-Installationsprogramm¶
Um Snowflake CLI auf MacOS zu installieren, gehen Sie wie folgt vor:
Laden Sie das Installationsprogramm Snowflake CLI aus dem Snowflake-CLI-Repository herunter.
Starten Sie das Installationsprogramm und folgen Sie den Anweisungen, um Snowflake CLI zu installieren.
Um zu überprüfen, ob die Software erfolgreich installiert wurde, öffnen Sie ein neues Terminal und führen Sie den folgenden Befehl aus:
snow --helpUsage: snow [OPTIONS] COMMAND [ARGS]... Snowflake CLI tool for developers. ╭─ Options ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮ │ --version Shows version of the Snowflake CLI │ │ --info Shows information about the Snowflake CLI │ │ --config-file FILE Specifies Snowflake CLI configuration file that should be used [default: None] │ │ --install-completion Install completion for the current shell. │ │ --show-completion Show completion for the current shell, to copy it or customize the installation. │ │ --help -h Show this message and exit. │ ╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯ ╭─ Commands ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮ │ app Manages a Snowflake Native App │ │ connection Manages connections to Snowflake. │ │ cortex Provides access to Snowflake Cortex. │ │ git Manages git repositories in Snowflake. │ │ notebook Manages notebooks in Snowflake. │ │ object Manages Snowflake objects like warehouses and stages │ │ snowpark Manages procedures and functions. │ │ spcs Manages Snowpark Container Services compute pools, services, image registries, and image repositories. │ │ sql Executes Snowflake query. │ │ stage Manages stages. │ │ streamlit Manages a Streamlit app in Snowflake. │ ╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
Installation mit dem Windows-Installationsprogramm¶
Um Snowflake CLI unter Windows zu installieren, gehen Sie wie folgt vor:
Laden Sie das Installationsprogramm Snowflake CLI aus dem Snowflake-CLI-Repository herunter.
Starten Sie das Installationsprogramm und folgen Sie den Anweisungen, um Snowflake CLI zu installieren.
Um zu überprüfen, ob die Software erfolgreich installiert wurde, öffnen Sie ein neues Terminal und führen Sie den folgenden Befehl aus:
snow --helpUsage: snow [OPTIONS] COMMAND [ARGS]... Snowflake CLI tool for developers. ╭─ Options ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮ │ --version Shows version of the Snowflake CLI │ │ --info Shows information about the Snowflake CLI │ │ --config-file FILE Specifies Snowflake CLI configuration file that should be used [default: None] │ │ --install-completion Install completion for the current shell. │ │ --show-completion Show completion for the current shell, to copy it or customize the installation. │ │ --help -h Show this message and exit. │ ╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯ ╭─ Commands ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮ │ app Manages a Snowflake Native App │ │ connection Manages connections to Snowflake. │ │ cortex Provides access to Snowflake Cortex. │ │ git Manages git repositories in Snowflake. │ │ notebook Manages notebooks in Snowflake. │ │ object Manages Snowflake objects like warehouses and stages │ │ snowpark Manages procedures and functions. │ │ spcs Manages Snowpark Container Services compute pools, services, image registries, and image repositories. │ │ sql Executes Snowflake query. │ │ stage Manages stages. │ │ streamlit Manages a Streamlit app in Snowflake. │ ╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
Mit Homebrew installieren¶
Wenn Sie ein Mac-Betriebssystem verwenden, können Sie Snowflake CLI mit Homebrew installieren.
Installieren Sie Homebrew, falls erforderlich.
Um Homebrew Zugriff auf das Snowflake CLI-Repository zu geben, führen Sie den folgenden Befehl aus:
brew tap snowflakedb/snowflake-cli brew update
Um Snowflake CLI zu installieren, führen Sie den folgenden Befehl aus:
brew install snowflake-cli
Um zu überprüfen, ob die Software erfolgreich installiert wurde, führen Sie den folgenden Befehl aus:
snow --helpUsage: snow [OPTIONS] COMMAND [ARGS]... Snowflake CLI tool for developers. ╭─ Options ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮ │ --version Shows version of the Snowflake CLI │ │ --info Shows information about the Snowflake CLI │ │ --config-file FILE Specifies Snowflake CLI configuration file that should be used [default: None] │ │ --install-completion Install completion for the current shell. │ │ --show-completion Show completion for the current shell, to copy it or customize the installation. │ │ --help -h Show this message and exit. │ ╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯ ╭─ Commands ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮ │ app Manages a Snowflake Native App │ │ connection Manages connections to Snowflake. │ │ cortex Provides access to Snowflake Cortex. │ │ git Manages git repositories in Snowflake. │ │ notebook Manages notebooks in Snowflake. │ │ object Manages Snowflake objects like warehouses and stages │ │ snowpark Manages procedures and functions. │ │ spcs Manages Snowpark Container Services compute pools, services, image registries, and image repositories. │ │ sql Executes Snowflake query. │ │ stage Manages stages. │ │ streamlit Manages a Streamlit app in Snowflake. │ ╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
Erweiterte lokale Installationen¶
Sie können Snowflake CLI auch als Python-Paket installieren, indem Sie einen der folgenden Schritte ausführen:
Snowflake empfiehlt die Installation als Python-Paket nur für Entwicklungszwecke oder wenn die Installation von Binärdateien in Ihrer Umgebung nicht möglich ist.
Installieren mit pip (PyPi)¶
Bemerkung
Diese Methode ändert die Python-Umgebung, in der Sie Snowflake CLI installieren. Ziehen Sie stattdessen die Verwendung von pipx in Betracht, um Abhängigkeitskonflikte zu vermeiden.
Um Snowflake CLI mit pip zu installieren, müssen Sie Python Version 3.10 oder höher installiert haben.
Führen Sie den folgenden Shell-Befehl aus:
pip install snowflake-cli
Um zu überprüfen, ob die Software erfolgreich installiert wurde, führen Sie den folgenden Befehl aus:
snow --helpUsage: snow [OPTIONS] COMMAND [ARGS]... Snowflake CLI tool for developers. ╭─ Options ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮ │ --version Shows version of the Snowflake CLI │ │ --info Shows information about the Snowflake CLI │ │ --config-file FILE Specifies Snowflake CLI configuration file that should be used [default: None] │ │ --install-completion Install completion for the current shell. │ │ --show-completion Show completion for the current shell, to copy it or customize the installation. │ │ --help -h Show this message and exit. │ ╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯ ╭─ Commands ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮ │ app Manages a Snowflake Native App │ │ connection Manages connections to Snowflake. │ │ cortex Provides access to Snowflake Cortex. │ │ git Manages git repositories in Snowflake. │ │ notebook Manages notebooks in Snowflake. │ │ object Manages Snowflake objects like warehouses and stages │ │ snowpark Manages procedures and functions. │ │ spcs Manages Snowpark Container Services compute pools, services, image registries, and image repositories. │ │ sql Executes Snowflake query. │ │ stage Manages stages. │ │ streamlit Manages a Streamlit app in Snowflake. │ ╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
Mit pipx installieren¶
pipx bietet eine Alternative zu pip, das Python-Pakete in isolierten virtuellen Umgebungen installiert und ausführt. Die Installation von Snowflake CLI mit pipx verändert also nicht Ihre aktuelle Python-Umgebung.
Um Snowflake CLI mit pipx zu installieren, müssen Sie pipx installiert haben.
Führen Sie den folgenden Shell-Befehl aus:
pipx install snowflake-cli
Um zu überprüfen, ob die Software erfolgreich installiert wurde, führen Sie den folgenden Befehl aus:
snow --helpUsage: snow [OPTIONS] COMMAND [ARGS]... Snowflake CLI tool for developers. ╭─ Options ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮ │ --version Shows version of the Snowflake CLI │ │ --info Shows information about the Snowflake CLI │ │ --config-file FILE Specifies Snowflake CLI configuration file that should be used [default: None] │ │ --install-completion Install completion for the current shell. │ │ --show-completion Show completion for the current shell, to copy it or customize the installation. │ │ --help -h Show this message and exit. │ ╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯ ╭─ Commands ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮ │ app Manages a Snowflake Native App │ │ connection Manages connections to Snowflake. │ │ cortex Provides access to Snowflake Cortex. │ │ git Manages git repositories in Snowflake. │ │ notebook Manages notebooks in Snowflake. │ │ object Manages Snowflake objects like warehouses and stages │ │ snowpark Manages procedures and functions. │ │ spcs Manages Snowpark Container Services compute pools, services, image registries, and image repositories. │ │ sql Executes Snowflake query. │ │ stage Manages stages. │ │ streamlit Manages a Streamlit app in Snowflake. │ ╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
Installieren von Snowflake CLI in FIPS-kompatiblen Umgebungen¶
Sie können zur Installation von Snowflake CLI in einer Umgebung, die mit FIPS (Federal Information Processing Standards) konform ist, ein Docker-Image verwenden.
Voraussetzungen¶
Vor der Installation von Snowflake CLI in einer FIPS-kompatiblen Umgebung sollten Sie sicherstellen, dass Sie die folgenden Voraussetzungen erfüllen:
FIPS-kompatibles Python: Python muss für FIPS-Compliance vorinstalliert, erstellt und konfiguriert werden. Dies bedeutet normalerweise, dass Python mit einer FIPS-aktivierten OpenSSL-Bibliothek verknüpft ist.
FIPS-aktiviertes OpenSSL: Die OpenSSL-Bibliotheken des Systems müssen FIPS-kompatibel und für Python zur Laufzeit verfügbar sein.
Erstellungstools: Standard-Erstellungstools (z. B. ein C-Compiler und Python-Entwicklungsheader) müssen verfügbar sein, da Abhängigkeiten aus den Quellen erstellt werden.
Netzwerkzugriff: Die Umgebung muss den Zugriff auf PyPI oder Ihren internen Paketindex für den Download von Quelldistributionen erlauben.
Installieren von Snowflake CLI in einer FIPS-kompatiblen Dockerdatei¶
So installieren Sie Snowflake CLI in einer FIPS-kompatiblen Umgebung:
Erstellen Sie eine virtuelle Python-Umgebung im Container, wie im folgenden Beispiel gezeigt:
python -m venv .venv
Aktivieren Sie die virtuelle Python-Umgebung im Container, wie im folgenden Beispiel gezeigt:
source ~/.venv/bin/activate
Aktualisieren Sie
pipundsetuptoolsim Container, wie im folgenden Beispiel gezeigt:pip install -U setuptools pip
Installieren Sie die Kryptographie, den Python-Konnektor und Snowflake CLI-Abhängigkeiten aus der Quelle im Container, wie im folgenden Beispiel gezeigt. Beachten Sie, dass alle Abhängigkeiten von der Quelle aus installiert werden müssen, um sicherzustellen, dass sie auf Basis Ihrer FIPS-kompatiblen Bibliotheken erstellt werden.
pip install cryptography==44.0.3 --no-binary cryptography pip install -U snowflake-connector-python[secure-local-storage] --no-binary snowflake-connector-python[secure-local-storage] pip install -U snowflake-cli --no-binary snowflake-cli
Die
--no-binary-Option erzwingt die Installation von der Quelle aus und stellt sicher, dass die Builds FIPS-bereite Bibliotheken verwenden.
Validieren des Docker-Images¶
Um zu überprüfen, ob Ihre Python-Umgebung eine FIPS-aktivierte OpenSSL-Bibliothek verwendet, geben Sie den folgenden Befehl in den laufenden Container ein:
python -c "import ssl; print(ssl.OPENSSL_VERSION)"
Nach der Installation von Snowflake CLI und der Validierung des Docker-Images können Sie Snowflake CLI im Container verwenden.
snow <your-command>
wobei <your-command> jeder gültige Snowflake CLI-Befehl ist, wie snow --help.
Automatische Befehlsvervollständigung installieren¶
Snowflake CLI unterstützt die Standardfunktionalität zur Shell-Tab-Vervollständigung.
Um die automatische Vervollständigung in Snowflake CLI zu installieren, führen Sie die folgenden Schritte aus:
Führen Sie den
snow --install-completion-Befehl aus:snow --install-completionzsh completion installed in <user home>/.zfunc/_snow Completion will take effect once you restart the terminal
Führen Sie den
snow --show-completion-Befehl aus, um die Befehle zu generieren, die Sie zu Ihrem Shell-Profil hinzufügen müssen (.bashrc,.bash_profile,.zshrcund andere):snow --show-completion_snow_completion() { local IFS=$' ' COMPREPLY=( $( env COMP_WORDS="${COMP_WORDS[*]}" \ COMP_CWORD=$COMP_CWORD \ _SNOW_COMPLETE=complete_bash $1 ) ) return 0 } complete -o default -F _snow_completion snow
Wählen Sie den Befehlsausgabetext aus, und kopieren Sie ihn.
Öffnen Sie Ihre Shell-Profil-Datei (in diesem Beispiel
.bashrc) und fügen Sie den kopierten Text ein:export SHELL=/bin/bash ... _snow_completion() { local IFS=$' ' COMPREPLY=( $( env COMP_WORDS="${COMP_WORDS[*]}" \ COMP_CWORD=$COMP_CWORD \ _SNOW_COMPLETE=complete_bash $1 ) ) return 0 } complete -o default -F _snow_completion snow
Speichern Sie die Datei.
Um die Funktionalität der Registerkartenvervollständigung zu aktivieren, starten Sie Ihre Shell oder Shell-Profildatei neu mit
source, z. B:source ~/.bashrc
Um das Feature zu testen, geben Sie einen „snow“-Befehl gefolgt von einem
TABein:snow app [TAB]
deploy init open run teardown version