Installation de Snowflake CLI¶
Cette rubrique explique comment installer Snowflake CLI sur toutes les plateformes prises en charge par. Noter que Snowflake CLI n’est pas actuellement disponible pour les systèmes AIX.
Snowflake recommande d’utiliser des méthodes d’installation binaires, telles que des gestionnaires de paquets, pour installer Snowflake CLI sur votre système. Vous pouvez télécharger les programmes d’installation binaires à partir du référentiel de CLI Snowflake.
Exigences¶
Avant d’utiliser Snowflake CLI, vous devez disposer d’un compte Snowflake valide.
Pour exécuter Streamlit dans Snowflake à l’aide de Snowflake CLI, vous devez disposer d’un compte Snowflake avec l’autorisation d’utiliser Streamlit.
Pour exécuter Snowpark Container Services dans Snowflake à l’aide de Snowflake CLI, vous devez disposer d’un compte Snowflake doté des privilèges nécessaires à l’utilisation de Snowpark Container Services.
Astuce
Si votre compte Snowflake nécessite MFA (authentification multifactorielle), Snowflake CLI nécessite une approbation pour chaque commande. Vous pouvez utiliser la mise en cache MFA pour ne nécessiter l’authentification qu’une fois toutes les quatre heures. Pour plus d’informations, voir Utiliser l’authentification multifactorielle (MFA).
Installer Snowflake CLI à l’aide de gestionnaires de paquets¶
Pour installer Snowflake CLI à l’aide de gestionnaires de paquets spécifiques à une plateforme, utilisez l’une des procédures suivantes :
Installer à l’aide de gestionnaires de paquets Linux¶
Si vous utilisez un système d’exploitation Linux, vous pouvez installer Snowflake CLI avec des gestionnaires de paquets qui prennent en charge les éléments suivants :
paquets
deb,paquets
rpm.
Pour installer Snowflake CLI en utilisant le gestionnaire de paquets deb :
Téléchargez Snowflake CLI
debdepuis le référentiel de CLI Snowflake.Installez le paquet en exécutant la commande suivante :
sudo dpkg -i snowflake-cli-<version>.deb
Pour installer Snowflake CLI en utilisant le gestionnaire de paquets rpm :
Téléchargez le paquet Snowflake CLI
rpmà partir du référentiel de CLI Snowflake.Installez le paquet en exécutant la commande suivante :
sudo rpm -i snowflake-cli-<version>.deb
Pour vérifier que le logiciel a été installé avec succès, exécutez la commande suivante :
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. │ ╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
Installer avec le programme d’installation de paquets MacOS¶
Pour installer Snowflake CLI sur MacOS, procédez comme suit :
Téléchargez le programme d’installation Snowflake CLI depuis le référentiel de CLI Snowflake.
Exécutez le programme d’installation et suivez les instructions pour installer Snowflake CLI.
Pour vérifier que le logiciel a été installé avec succès, ouvrez un nouveau terminal et exécutez la commande suivante :
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. │ ╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
Installer avec le programme d’installation de Windows¶
Pour installer Snowflake CLI sous Windows, procédez comme suit :
Téléchargez le programme d’installation Snowflake CLI depuis le référentiel de CLI Snowflake.
Exécutez le programme d’installation et suivez les instructions pour installer Snowflake CLI.
Pour vérifier que le logiciel a été installé avec succès, ouvrez un nouveau terminal et exécutez la commande suivante :
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. │ ╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
Installer avec Homebrew¶
Si vous utilisez un système d’exploitation Mac, vous pouvez installer Snowflake CLI avec Homebrew.
Installer Homebrew, si nécessaire.
Pour donner à Homebrew l’accès au référentiel Snowflake CLI, exécutez la commande suivante :
brew tap snowflakedb/snowflake-cli brew update
Pour installer Snowflake CLI; exécutez la commande suivante :
brew install snowflake-cli
Pour vérifier que le logiciel a été installé avec succès, exécutez la commande suivante :
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. │ ╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
Installer avec pip (PyPi)¶
Note
Cette méthode modifie l’environnement Python dans lequel vous installez Snowflake CLI. Envisagez plutôt d’utiliser pipx pour éviter les conflits de dépendance.
Pour installer Snowflake CLI à l’aide de pip, vous devez avoir installé Python version 3.10 ou une version ultérieure.
Exécutez la commande shell suivante :
pip install snowflake-cli
Pour vérifier que le logiciel a été installé avec succès, exécutez la commande suivante :
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. │ ╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
Installer avec pipx¶
pipx fournit une alternative à pip qui installe et exécute des paquets Python dans des environnements virtuels isolés. L’installation de Snowflake CLI avec pipx ne modifie donc pas votre environnement Python actuel.
Pour installer Snowflake CLI à l’aide de pipx, vous devez avoir installé pipx.
Exécutez la commande shell suivante :
pipx install snowflake-cli-labs
Pour vérifier que le logiciel a été installé avec succès, exécutez la commande suivante :
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. │ ╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
Installer la fonctionnalité d’auto-remplissage des commandes¶
Snowflake CLI prend en charge la fonctionnalité standard d’achèvement des tabulations de l’interpréteur de commandes.
Pour installer l’auto-remplissage dans Snowflake CLI, procédez comme suit :
Exécutez la commande
snow --install-completion:snow --install-completionzsh completion installed in <user home>/.zfunc/_snow Completion will take effect once you restart the terminal
Exécutez la commande
snow --show-completionpour générer les commandes que vous devez ajouter à votre profil shell (.bashrc,.bash_profile,.zshrc, et autres) :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
Sélectionnez et copiez le texte de sortie de la commande.
Ouvrez votre fichier de profil shell,
.bashrcdans cet exemple, et collez le texte copié :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
Sauvegardez le fichier.
Pour activer la fonctionnalité d’achèvement des tabulations, redémarrez votre interpréteur de commande ou
sourcevotre fichier de profil de shell, par exemple :source ~/.bashrc
Pour tester la fonction, entrez une commande snow suivie d’un
TAB, comme indiqué :snow app [TAB]
deploy init open run teardown version