Snowflake Extension for Visual Studio Code¶
Snowflake fournit une extension pour Visual Studio Code (VS Code) afin de permettre aux utilisateurs de Snowflake d’écrire et d’exécuter des instructions SQL Snowflake directement dans VS Code. Les extensions sont des fonctionnalités pré-empaquetées, souvent fournies par des tiers, qui ajoutent de nouvelles caractéristiques et fonctionnalités à VS Code.
Dans ce chapitre :
Installation de l”Snowflake Extension for Visual Studio Code¶
Les utilisateurs de Snowflake peuvent installer l’extension VS Code directement à partir de la marketplace Visual Studio ou télécharger l’extension, empaquetée en tant que fichier .xsix
, puis l’installer.
Installation à partir de la marketplace Visual Studio¶
Pour effectuer une installation directement à partir de la marketplace Visual Studio, procédez comme suit :
Ouvrez Code Visual Studio.
Sélectionnez Code » Preferences » Extensions.
Vous pouvez également sélectionner View » Extensions ou cliquer sur le bouton des extensions
dans la barre d’activité VS Code.
Dans la zone de texte Search Extensions entrez le texte Snowflake pour rechercher l’extension Visual Studio Snowflake.
Dans l’ensemble des extensions, sélectionnez l’extension créée par Snowflake et cliquez sur Install.
Installation à partir d’un fichier .vsix¶
Pour un téléchargement et une installation à partir d’un fichier .vsix, procédez comme suit :
Téléchargez l’extension.
Ouvrez la page Extension Snowflake Visual Studio Code.
Sélectionnez l’onglet Version History.
Sélectionnez une version à télécharger et cliquez sur Download. Notez l’emplacement de téléchargement du fichier.
Ouvrez Code Visual Studio.
Sélectionnez Code » Preferences » Extensions.
Vous pouvez également sélectionner View » Extensions ou cliquer sur le bouton des extensions
dans la barre d’activité.
Sélectionnez Install from VSIX dans le menu plus(…).
Localisez le fichier
snowflake-x.y.z.vsix
sur votre ordinateur, sélectionnez le fichier, puis sélectionnez Install.
Une fois l’installation terminée, l”Snowflake Extension for Visual Studio Code apparaît dans la section INSTALLED du menu Extensions dans VS Code.
Connexion¶
Avant de pouvoir exécuter des instructions SQL, vous devez vous connecter à un compte Snowflake.
Vous pouvez vous connecter à Snowflake en utilisant votre identificateur de compte Snowflake, votre nom d’utilisateur et votre mot de passe, ou en utilisant l’authentification fédérée à Snowflake avec SSO SAML.
La première fois que vous vous connectez à Snowflake à partir de l’extension VS Code, vous devez ajouter votre compte en saisissant l’identificateur de votre compte Snowflake ou l’URL que vous utilisez pour vous connecter à Snowflake.
Voir Identificateurs de compte pour plus de détails sur la façon de déterminer votre identificateur de compte.
Pour se connecter à Snowflake à partir de l’extension VS Code, procédez comme suit :
Dans la Activity Bar, cliquez sur l’icône Snowflake.
Le panneau de la barre latérale passe à la navigation Snowflake et affiche les boîtes de dialogue Add Account ou Sign in.
Sous Add Account, entrez l’identificateur du compte et sélectionnez Continue.
Add Account n’est affiché que si aucun compte n’a été spécifié auparavant.
Entrez un nom d’utilisateur et un mot de passe pour le compte sélectionné et sélectionnez Sign in.
Une fois la connexion réussie, la barre latérale change pour afficher le contexte de la session (ACCOUNT), DATABASE EXPLORER pour l’utilisateur dans son rôle par défaut, et QUERY HISTORY.
Utilisation de Snowflake Extension for Visual Studio Code avec des fichiers de configuration SnowSQL¶
Le Snowflake Extension for Visual Studio Code peut utiliser les fichiers de configuration Snow SQL pour charger les configurations de connexion.
Note
Seules les valeurs de configuration de la connexion sont utilisées. Les autres valeurs de configuration SnowSQL sont ignorées.
Pour configurer Snowflake Extension for Visual Studio Code afin qu’il utilise un fichier de configuration Snow SQL, procédez comme suit :
Dans Activity Bar, sélectionnez l’icône Snowflake.
Le panneau de la barre latérale passe à la navigation Snowflake et affiche les boîtes de dialogue Add Account ou Sign in.
Sélectionnez la liste déroulante Username, puis sélectionnez Sign in to another account.
Sélectionnez Use SnowSQL Config. La page de configuration du code Visual Studio pour Snowflake Extension for Visual Studio Code s’ouvre avec le SnowSQL Config Path sélectionné.
Saisissez le chemin d’accès à un fichier de configuration SnowSQL valide.
La liste déroulante des comptes est mise à jour pour inclure toutes les connexions définies dans le fichier de configuration spécifié.
Utilisation des fichiers SQL¶
Vous pouvez utiliser l”Snowflake Extension for Visual Studio Code pour créer et charger des fichiers SQL. Les fichiers SQL sont de simples fichiers texte qui contiennent une ou plusieurs instructions SQL.
Ouverture de fichiers SQL¶
Pour créer ou ouvrir des fichiers SQL Snowflake, procédez comme suit :
Sélectionnez File » Open, naviguez vers un fichier texte contenant du SQL et ouvrez-le.
Si vous n’avez pas de fichier SQL existant, vous pouvez en créer un nouveau. Sélectionnez File » New File et créez un fichier de type Snowflake SQL File. Vous pouvez également cliquer sur le bouton (
) dans le panneau de l’explorateur de base de données pour créer un nouveau fichier SQL.
Ajoutez une ou plusieurs instructions SQL Snowflake au fichier.
Sélectionnez une ligne et appuyez sur [Exécuter], au-dessus de la ligne, pour exécuter la commande.
Exécution de commandes ou de requêtes¶
Pour exécuter une ou plusieurs commandes ou requêtes, procédez comme suit :
Sélectionnez le
du fichier SQL sélectionné pour exécuter toutes les instructions de ce fichier.
Sélectionnez une ligne à exécuter en plaçant votre curseur sur l’instruction à exécuter.
Sélectionnez deux ou plusieurs commandes - Toutes les commandes sélectionnées seront exécutées.
Appuyez sur le bouton [Exécuter] au-dessus de la première commande sélectionnée.
Si vous sélectionnez plusieurs commandes, les commandes s’exécutent dans l’ordre, de haut en bas.
Vous pouvez également exécuter des instructions en utilisant des raccourcis clavier. Après avoir sélectionné les instructions SQL que vous voulez exécuter, appuyez sur + [entrée] sur un clavier Mac ou
+ [entrée] sur un clavier Windows.
Vous pouvez voir les résultats de l’instruction SQL dans le tableau SNOWFLAKE:QUERY RESULTS de la section Output.
Utilisation de l’historique des requêtes¶
Un suivi des résultats des requêtes est disponible dans QUERY HISTORY.
Pour examiner les résultats d’une requête précédemment exécutée, procédez comme suit :
Développez Query History.
Sélectionnez une instruction.
Examinez le résultat dans l’onglet SNOWFLAKE:QUERY RESULTS du panneau Output.
Travailler avec les résultats d’une requête¶
Vous pouvez trier, réorganiser, masquer, geler ou enregistrer les résultats de la requête sur le disque.
Pour modifier l’affichage d’une requête donnée, procédez comme suit :
Dans QUERY HISTORY, sélectionnez une requête.
Dans QUERY RESULTS, choisissez une colonne.
Sélectionnez la flèche vers le bas (↓), puis l’une des options suivantes : SORT A-Z (descendant), Sort Z-A (ascendant), Hide column « column name » ou Freeze columns up to « column name ».
L’affichage du contenu sera modifié en conséquence.
Astuce
Si une colonne était précédemment masquée, choisissez n’importe quelle autre colonne et sélectionnez Unhide N columns.
Pour enregistrer les résultats d’une requête sur le disque, sélectionnez le disque () ou le téléchargement (
) associé à la requête. Le contenu sera enregistré dans un fichier, soit sous forme de fichier compressé gzip, soit sous forme de fichier séparé par des virgules.
Modification du contexte de la session¶
Vous pouvez utiliser la section Account du panneau Side Bar pour sélectionner des rôles, des bases de données, des schémas et des entrepôts. Utilisez la liste déroulante associée pour sélectionner chacun d’entre eux comme il convient.
Voir les détails de l’extension¶
Vous pouvez consulter les informations sur l’extension Snowflake SQL Visual Studio Code à tout moment.
Vous pouvez voir les détails suivants sur l’extension, notamment :
Informations sur la version : quelle version de l’extension est actuellement installée.
Journal des modifications : informations par version sur les fonctionnalités ajoutées, modifiées ou mises à jour.
Visite guidée des fonctionnalités.
En outre, vous pouvez désactiver ou activer l’extension à l’aide de la liste déroulante d’activation/de désactivation.
Pour afficher les informations sur les extensions, procédez comme suit :
Paramètres de l’extension¶
Le Snowflake Extension for Visual Studio Code prend en charge les paramètres suivants :
Réglage |
Description |
Par défaut |
---|---|---|
Exporter CSV » Délimiteur |
Spécifie le délimiteur pour les colonnes |
Virgule |
Exporter CSV » En-tête |
Permettre l’inclusion de la ligne d’en-tête dans le fichier CSV exporté |
Activé |
Exporter CSV » Inclure les lignes vides |
Permettre l’inclusion des lignes vides dans le fichier CSV exporté |
Exclure |
Exporter CSV » Guillemets |
Activer les guillemets doubles autour de toutes les valeurs dans le fichier exporté CSV |
Activé |
Mettre en évidence la requête |
Activer la mise en évidence de l’arrière-plan de l’instruction SQL active |
Activé |
Afficher Exécuter au-dessus de l’instruction |
Activer une action d’exécution cliquable au-dessus de chaque instruction |
Activé |
Chemin de configuration de Snowsql |
Si cette option est activée, la configuration de la connexion sera chargée à partir de ce fichier. |
Non défini |
Pour modifier les paramètres de l’extension :
Sous Windows/Linux, sélectionnez File » Preferences » Settings. . Sur macOS, sélectionnez Code » Preferences » Settings.
Dans la zone de texte Search settings, entrez Snowflake.
Sélectionnez les onglets User ou Workspace pour afficher ou modifier les paramètres spécifiques à l’utilisateur ou à l’espace de travail.
Fermez l’onglet Settings.
Désinstallation de l’extension¶
Pour désactiver ou désinstaller l’extension, procédez comme suit :
Sélectionnez Code » Preferences » Extensions
Sélectionnez l’extension.
Faites un clic droit et choisissez Disable ou Uninstall.