Installation de SnowSQL¶

Définition du répertoire de téléchargement et de l’emplacement du fichier de configuration¶

Par défaut, le programme d’installation de SnowSQL télécharge les fichiers binaires dans le répertoire suivant :

~/.snowsql

Par conséquent, le fichier de configuration se trouve dans le répertoire de téléchargement :

~/.snowsql/config

Vous pouvez modifier le répertoire de téléchargement et l’emplacement du fichier de configuration en définissant la variable d’environnement WORKSPACE sur n’importe quel répertoire accessible en écriture. Cette approche est particulièrement utile si vous avez un environnement SnowSQL isolé pour chaque processus.

De plus, vous pouvez séparer le répertoire de téléchargement du fichier de configuration en définissant la variable d’environnement SNOWSQL_DOWNLOAD_DIR de sorte que plusieurs processus SnowSQL puissent partager les fichiers binaires. Par exemple :

$ SNOWSQL_DOWNLOAD_DIR=/var/shared snowsql -h

Copy

Notez que SNOWSQL_DOWNLOAD_DIR est pris en charge à partir de la version Bootstrap SnowSQL 1.1.70. Pour vérifier la version que vous utilisez, exécutez la commande suivante à partir de l’invite de la fenêtre du terminal :

$ snowsql --bootstrap-version

Copy

Téléchargement du programme d’installation SnowSQL¶

Allez à la page Télécharger SnowSQL, trouvez la version de SnowSQL que vous voulez installer, et téléchargez les fichiers avec les extensions suivantes :

• .bash (le script du programme d’installation)

• .bash.sig (la signature que vous pouvez utiliser pour vérifier le paquet téléchargé)

Utilisation de Curl pour télécharger le programme d’installation de SnowSQL¶

Si vous souhaitez télécharger le programme d’installation à partir d’un script ou d’une fenêtre de terminal (par exemple, en utilisant curl, plutôt que votre navigateur Web), vous pouvez télécharger les programmes d’installation directement à partir du Snowflake Client Repository. Pour une flexibilité accrue, Snowflake fournit des points de terminaison Amazon Web Services (AWS) et Azure pour le référentiel. Les comptes hébergés sur une plateforme Cloud quelconque prise en charge peuvent télécharger le programme d’installation depuis l’un des deux points de terminaison.

Exécutez curl (ou un outil de ligne de commande équivalent) pour télécharger le programme d’installation. La syntaxe curl est la suivante :

point de terminaison AWS:

$ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/<bootstrap_version>/linux_x86_64/snowsql-<version>-linux_x86_64.bash

Copy

point de terminaison Microsoft Azure:

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

Copy

Où :

• <version> combine les versions SnowSQL suivantes : majeure, mineure et correctif. Par exemple, pour la version 1.2.3, la version majeure est 1, la version mineure est 2 et la version du correctif est 3. Donc, la version est la 1.2.3.

• <bootstrap_version> est la version combinée SnowSQL majeure et mineure. Par exemple, pour la version 1.2.3, la version majeure est la 1 et la version mineure est la 2, donc la version Bootstrap est la 1.2.

Par exemple, pour télécharger le programme d’installation SnowSQL où <version_bootstrap> est 1.2 et <version> est 1.2.32 :

point de terminaison AWS:

$ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/1.2/linux_x86_64/snowsql-1.2.32-linux_x86_64.bash

point de terminaison Microsoft Azure:

$ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/1.2/linux_x86_64/snowsql-1.2.32-linux_x86_64.bash

Pour plus d’informations sur les versions SnowSQL , voir Comprendre la gestion des versions SnowSQL ( dans ce chapitre).

Vérification de la signature du paquet¶

Pour vérifier la signature du pack téléchargé :

1. Téléchargez et importez la dernière clé publique GPG de Snowflake à partir de l”Classic Console ou du serveur de clés publiques.

   Télécharger depuis l’interface Web:

   1. Dans l”Classic Console, cliquez sur Help » Download… pour afficher la boîte de dialogue Downloads.

   2. Sélectionnez CLI Client (snowsql) à gauche, puis cliquez sur l’icône Snowflake GPG Public Key à droite.

   Télécharger à partir du serveur de clés:

   Entrez la commande suivante, en utilisant la clé GPG associée à la version SnowSQL :

   • Pour SnowSQL 1.2.24 et versions supérieures :

     $ gpg --keyserver hkp://keyserver.ubuntu.com --recv-keys 630D9F3CAB551AF3

   • Pour les versions 1.2.11 à 1.2.23 de SnowSQL :

     $ gpg --keyserver hkp://keyserver.ubuntu.com --recv-keys 37C7086698CB005C

   • Pour les versions 1.1.75 à 1.2.10 de SnowSQL :

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

   • Pour les versions 1.1.74 et inférieures de SnowSQL :

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

   Note

   Si cette commande échoue avec l’erreur suivante :

   gpg: keyserver receive failed: Server indicated a failure
   

   Copy

   alors spécifiez que vous voulez utiliser le port 80 pour le serveur de clés :

   gpg --keyserver hkp://keyserver.ubuntu.com:80  ...
   

   Copy

2. Téléchargez la signature GPG et vérifiez la signature :

   # If you prefer to use curl to download the signature file, run this command:
   $ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/1.2/linux_x86_64/snowsql-1.2.32-linux_x86_64.bash.sig
   
   # Verify the package signature.
   $ gpg --verify snowsql-1.2.32-linux_x86_64.bash.sig snowsql-1.2.32-linux_x86_64.bash

   ou, si vous téléchargez le fichier de signature à partir du point de terminaison Azure :

   # If you prefer to use curl to download the signature file, run this command:
   $ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/1.2/linux_x86_64/snowsql-1.2.32-linux_x86_64.bash.sig
   
   # Verify the package signature.
   $ gpg --verify snowsql-1.2.32-linux_x86_64.bash.sig snowsql-1.2.32-linux_x86_64.bash

   Note

   La vérification de la signature crée un avertissement similaire à celui qui suit :

   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

   Pour éviter l’avertissement, vous pouvez accorder la confiance implicite à la clé publique GPG Snowflake.

3. Votre environnement local peut contenir plusieurs clés GPG. Cependant, pour des raisons de sécurité, Snowflake fait tourner périodiquement la clé publique GPG. Nous recommandons de supprimer la clé publique existante après avoir confirmé que la dernière clé fonctionne avec le dernier pack signé. Par exemple :

   $ gpg --delete-key "Snowflake Computing"
   

   Copy

Installation de SnowSQL à l’aide du programme d’installation¶

1. Ouvrez une fenêtre de terminal.

2. Exécutez le programme d’installation du script Bash à partir de l’emplacement de téléchargement :

   $ bash snowsql-linux_x86_64.bash
   

   Copy

3. Suivez les instructions fournies par le programme d’installation.

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

Lorsque vous installez une nouvelle version majeure ou mineure, SnowSQL ne se met pas à niveau immédiatement. Vous devez vous connecter à votre compte Snowflake à l’aide de SnowSQL et rester connecté pendant une période de temps suffisante pour que la fonction de mise à niveau automatique mette à niveau le client vers la dernière version. Pour vérifier la version SnowSQL qui démarre actuellement lorsque vous exécutez le client, utilisez l’option -v sans valeur :

$ snowsql -v

  Version: 1.2.3

Copy

Pour forcer SnowSQL à installer et à utiliser une version spécifique, utilisez l’option -v et spécifiez la version que vous souhaitez installer. Par exemple, exécutez la commande suivante pour la version 1.2.5 :

$ snowsql -v 1.2.5

Copy

Téléchargement du paquet SnowSQL RPM¶

Allez à la page Télécharger SnowSQL, trouvez la version de SnowSQL que vous voulez installer, et téléchargez le fichier avec l’extension .rpm.

Installation du paquet SnowSQL RPM¶

Le fichier RPM téléchargé peut être installé de la même manière que tout autre pack RPM :

rpm -i <package_name>

Définition du répertoire de téléchargement et de l’emplacement du fichier de configuration¶

Par défaut, le programme d’installation de SnowSQL télécharge les fichiers binaires dans le répertoire suivant :

~/.snowsql

Par conséquent, le fichier de configuration se trouve dans le répertoire de téléchargement :

~/.snowsql/config

Vous pouvez modifier le répertoire de téléchargement et l’emplacement du fichier de configuration en définissant la variable d’environnement WORKSPACE sur n’importe quel répertoire accessible en écriture. Ceci est particulièrement utile si vous avez un environnement isolé SnowSQL pour chaque processus.

De plus, vous pouvez séparer le répertoire de téléchargement du fichier de configuration en définissant la variable d’environnement SNOWSQL_DOWNLOAD_DIR de sorte que plusieurs processus SnowSQL puissent partager les fichiers binaires. Par exemple :

$ SNOWSQL_DOWNLOAD_DIR=/var/shared snowsql -h

Copy

Notez que SNOWSQL_DOWNLOAD_DIR est pris en charge à partir de la version Bootstrap SnowSQL 1.1.70. Pour vérifier la version que vous utilisez, exécutez la commande suivante à partir de l’invite de la fenêtre du terminal :

$ snowsql --bootstrap-version

Copy

Téléchargement du programme d’installation SnowSQL¶

Pour télécharger le programme d’installation SnowSQL, rendez-vous sur la page Télécharger SnowSQL. Cette version du programme d’installation SnowSQL permet la mise à niveau automatique des correctifs.

Utilisation de Curl pour télécharger le programme d’installation de SnowSQL¶

Si vous souhaitez télécharger le programme d’installation à partir d’un script ou d’une fenêtre de terminal (par exemple, en utilisant curl, plutôt que votre navigateur Web), vous pouvez télécharger les programmes d’installation directement à partir du Snowflake Client Repository. Pour une flexibilité accrue, Snowflake fournit des points de terminaison Amazon Web Services (AWS) et Azure pour le référentiel. Les comptes hébergés sur une plateforme Cloud quelconque prise en charge peuvent télécharger le programme d’installation depuis l’un des deux points de terminaison.

Exécutez curl (ou un outil de ligne de commande équivalent) pour télécharger le programme d’installation. La syntaxe curl est la suivante :

point de terminaison AWS:

$ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/<bootstrap_version>/darwin_x86_64/snowsql-<version>-darwin_x86_64.pkg

Copy

point de terminaison Microsoft Azure:

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

Copy

Où :

• <version> combine les versions SnowSQL suivantes : majeure, mineure et correctif. Par exemple, pour la version 1.2.3, la version majeure est 1, la version mineure est 2 et la version du correctif est 3. Donc, la version est la 1.2.3.

• <bootstrap_version> est la version combinée SnowSQL majeure et mineure. Par exemple, pour la version 1.2.3, la version majeure est la 1 et la version mineure est la 2, donc la version Bootstrap est la 1.2.

Par exemple, pour télécharger le programme d’installation SnowSQL où <version_bootstrap> est 1.2 et <version> est 1.2.32 :

point de terminaison AWS:

$ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/1.2/darwin_x86_64/snowsql-1.2.32-darwin_x86_64.pkg

point de terminaison Microsoft Azure:

$ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/1.2/darwin_x86_64/snowsql-1.2.32-darwin_x86_64.pkg

Pour plus d’informations sur les versions SnowSQL , voir Comprendre la gestion des versions SnowSQL ( dans ce chapitre).

Le système d’exploitation macOS peut vérifier automatiquement la signature du programme d’installation, donc la vérification de la signature GPG n’est pas nécessaire.

Installation de SnowSQL à l’aide du programme d’installation¶

1. Double-cliquez sur snowsql-darwin_x86_64.pkg dans l’emplacement de téléchargement pour exécuter le fichier d’installation PKG.

2. Suivez les instructions fournies par le programme d’installation.

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

Lorsque vous installez une nouvelle version majeure ou mineure, SnowSQL ne se met pas à niveau immédiatement. Vous devez vous connecter à votre compte Snowflake à l’aide de SnowSQL et rester connecté pendant une période de temps suffisante pour que la fonction de mise à niveau automatique mette à niveau le client vers la dernière version. Pour vérifier la version SnowSQL qui démarre actuellement lorsque vous exécutez le client, utilisez l’option -v sans valeur :

$ snowsql -v

  Version: 1.2.3

Copy

Pour forcer SnowSQL à installer et à utiliser une version spécifique, utilisez l’option -v et spécifiez la version que vous souhaitez installer. Par exemple, exécutez la commande suivante pour la version 1.2.5 :

$ snowsql -v 1.2.5

Copy

Configuration de l’alias Z Shell (macOS uniquement)¶

Si le Z Shell (également appelé zsh) est votre shell terminal par défaut, définissez un alias pour l’exécutable SnowSQL afin de pouvoir exécuter SnowSQL en ligne de commande dans Terminal. Le programme d’installation SnowSQL installe l’exécutable dans /Applications/SnowSQL.app/Contents/MacOS/snowsql et ajoute ce chemin à l’entrée PATH ou à l’alias dans ~/.profile. Comme zsh ne lit normalement pas ce fichier, ajoutez un alias à ce chemin dans ~/.zshrc, que zsh lit vraiment.

Pour ajouter un alias à l’exécutable SnowSQL :

1. Ouvrez (ou créez, si absent) le fichier ~/.zshrc.

2. Ajoutez la ligne suivante :

   alias snowsql=/Applications/SnowSQL.app/Contents/MacOS/snowsql
   

   Copy

3. Sauvegardez le fichier.

Définition du répertoire de téléchargement et de l’emplacement du fichier de configuration¶

Par défaut, le programme d’installation de SnowSQL télécharge les fichiers binaires dans le répertoire suivant :

%USERPROFILE%\.snowsql

Par conséquent, le fichier de configuration se trouve dans le répertoire de téléchargement :

%USERPROFILE%\.snowsql\config

Vous pouvez modifier le répertoire de téléchargement et l’emplacement du fichier de configuration en définissant la variable d’environnement WORKSPACE sur n’importe quel répertoire accessible en écriture. Ceci est particulièrement utile si vous avez un environnement isolé SnowSQL pour chaque processus.

De plus, vous pouvez séparer le répertoire de téléchargement du fichier de configuration en définissant la variable d’environnement SNOWSQL_DOWNLOAD_DIR de sorte que plusieurs processus SnowSQL puissent partager les fichiers binaires. Par exemple :

$ SNOWSQL_DOWNLOAD_DIR=/var/shared snowsql -h

Copy

Notez que SNOWSQL_DOWNLOAD_DIR est pris en charge à partir de la version Bootstrap SnowSQL 1.1.70. Pour vérifier la version que vous utilisez, exécutez la commande suivante à partir de l’invite de la fenêtre du terminal :

$ snowsql --bootstrap-version

Copy

Téléchargement du programme d’installation SnowSQL¶

Pour télécharger le programme d’installation SnowSQL, rendez-vous sur la page Télécharger SnowSQL. Cette version du programme d’installation SnowSQL permet la mise à niveau automatique des correctifs.

Utilisation de Curl pour télécharger le programme d’installation de SnowSQL¶

Si vous souhaitez télécharger le programme d’installation à partir d’un script ou d’une fenêtre de terminal (par exemple, en utilisant curl, plutôt que votre navigateur Web), vous pouvez télécharger les programmes d’installation directement à partir du Snowflake Client Repository. Pour une flexibilité accrue, Snowflake fournit des points de terminaison Amazon Web Services (AWS) et Azure pour le référentiel. Les comptes hébergés sur une plateforme Cloud quelconque prise en charge peuvent télécharger le programme d’installation depuis l’un des deux points de terminaison.

Exécutez curl (ou un outil de ligne de commande équivalent) pour télécharger le programme d’installation. La syntaxe curl est la suivante :

point de terminaison AWS:

$ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/<bootstrap_version>/windows_x86_64/snowsql-<version>-windows_x86_64.msi

Copy

point de terminaison Microsoft Azure:

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

Copy

Où :

• <version> combine les versions SnowSQL suivantes : majeure, mineure et correctif. Par exemple, pour la version 1.2.3, la version majeure est 1, la version mineure est 2 et la version du correctif est 3. Donc, la version est la 1.2.3.

• <bootstrap_version> est la version combinée SnowSQL majeure et mineure. Par exemple, pour la version 1.2.3, la version majeure est la 1 et la version mineure est la 2, donc la version Bootstrap est la 1.2.

Par exemple, pour télécharger le programme d’installation SnowSQL où <version_bootstrap> est 1.2 et <version> est 1.2.32 :

point de terminaison AWS:

$ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/1.2/windows_x86_64/snowsql-1.2.32-windows_x86_64.msi

point de terminaison Microsoft Azure:

$ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/1.2/windows_x86_64/snowsql-1.2.32-windows_x86_64.msi

Pour plus d’informations sur les versions SnowSQL , voir Comprendre la gestion des versions SnowSQL ( dans ce chapitre).

Le système d’exploitation Windows peut vérifier automatiquement la signature du programme d’installation, donc la vérification de la signature GPG n’est pas nécessaire.

Installation de SnowSQL à l’aide du programme d’installation¶

1. Double-cliquez sur snowsql-windows_x86_64.msi dans l’emplacement de téléchargement pour exécuter le fichier d’installation MSI.

2. Suivez les instructions fournies par le programme d’installation.

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

Lorsque vous installez une nouvelle version majeure ou mineure, SnowSQL ne se met pas à niveau immédiatement. Vous devez vous connecter à votre compte Snowflake à l’aide de SnowSQL et rester connecté pendant une période de temps suffisante pour que la fonction de mise à niveau automatique mette à niveau le client vers la dernière version. Pour vérifier la version SnowSQL qui démarre actuellement lorsque vous exécutez le client, utilisez l’option -v sans valeur :

$ snowsql -v

  Version: 1.2.3

Copy

Pour forcer SnowSQL à installer et à utiliser une version spécifique, utilisez l’option -v et spécifiez la version que vous souhaitez installer. Par exemple, exécutez la commande suivante pour la version 1.2.5 :

$ snowsql -v 1.2.5

Copy

Qu’est-ce que la mise à niveau automatique ?¶

Par défaut, la mise à niveau de SnowSQL se fait automatiquement vers la dernière version du correctif. Une nouvelle version majeure ou mineure nécessite un téléchargement et une installation manuels.

Lorsqu’une nouvelle version de correctif est disponible, SnowSQL télécharge le nouveau binaire dans un processus en arrière-plan et exécute la version actuelle. La prochaine fois que vous exécutez SnowSQL, la nouvelle version se lance.

Pour illustrer le processus :

1. Pour une nouvelle installation, téléchargez le programme d’installation SnowSQL (par exemple, la version 1.2.0) en utilisant l’interface Web de Snowflake, et installez le client.

2. Chaque fois que vous exécutez SnowSQL, le client vérifie si une version plus récente est disponible dans le répertoire de mise à niveau SnowSQL.

3. Si une version plus récente (par exemple, la version 1.2.1) est disponible, SnowSQL la télécharge en tâche de fond pendant que la version actuelle est installée.

4. La prochaine fois que vous exécutez SnowSQL, le client exécute la version 1.2.1 tout en vérifiant si une version plus récente est disponible.

Désactivation de la mise à niveau automatique¶

L’option --noup empêche SnowSQL de télécharger une nouvelle version si une nouvelle est publiée. Vous pouvez spécifier cette option lorsque vous vous connectez à Snowflake pour empêcher une mise à niveau automatique pendant cette session spécifique.

Par exemple :

$ snowsql --noup

Copy

Sinon, ajoutez l’option noup = true dans le fichier de configuration pour empêcher SnowSQL de se mettre à niveau automatiquement tant que l’option n’est pas désactivée ou définie sur false.

Exécution d’une version précédente de SnowSQL¶

Si vous rencontrez un problème avec la dernière version de SnowSQL, par exemple la version 1.2.2, vous pouvez exécuter temporairement une version précédente.

Pour déterminer la version SnowSQL qui démarre actuellement lorsque vous exécutez le client, utilisez l’option -v sans valeur :

$ snowsql -v

  Version: 1.2.2

Copy

Pour afficher une liste des versions disponibles de SnowSQL, utilisez l’option --versions :

$ snowsql --versions

  1.2.3
  1.2.2
  1.2.1
  1.2.0

Copy

Pour installer une version antérieure de SnowSQL à partir de la liste, utilisez l’option -v et spécifiez la version que vous voulez installer. Par exemple, pour installer la version 1.2.3 :

$ snowsql -v 1.2.3

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

Copy

Utilisez la même option pour spécifier la version que vous voulez exécuter lorsque vous démarrez SnowSQL :

$ snowsql -v 1.2.3

Copy

Nouveaux utilisateurs¶

Pour spécifier le point de terminaison Microsoft Azure de Snowflake Client Repository en tant que nouvel utilisateur SnowSQL , exécutez la commande suivante :

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

Vérifiez que le fichier de configuration (c’est-à-dire ~/.snowsql/config ou %USERPROFILE%\.snowsql\config) inclut la ligne suivante.

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

Utilisateurs existants¶

Pour spécifier le point de terminaison Microsoft Azure de Snowflake Client Repository en tant qu’utilisateur SnowSQL existant, ajoutez la ligne suivante au fichier de configuration (c’est-à-dire ~/.snowsql/config ou %USERPROFILE%\.snowsql\config) :

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