Interrogation de données à l’aide de feuilles de calcul

Après avoir créé ou ouvert une feuille de calcul, vous pouvez gérer la feuille de calcul, écrire et exécuter des requêtes, explorer les résultats et l’historique des requêtes, et configurer des filtres à l’aide de Snowsight.

Dans ce chapitre :

Écriture de requêtes dans des feuilles de calcul

Après avoir ouvert une feuille de calcul, vous pouvez écrire des requêtes et des instructions SQL.

Définir le contexte de la feuille de calcul

Lorsque vous définissez une base de données et, éventuellement, un schéma de base de données comme contexte de la feuille de calcul, vous pouvez faire référence à des objets du schéma sans qualifier complètement les noms d’objets dans votre requête.

Écrire des requêtes avec la saisie semi-automatique

Lorsque vous saisissez votre script dans l’éditeur de requêtes, la fonction de saisie semi-automatique vous suggère :

  • Des mots clés de la syntaxe des requêtes, tels que des fonctions SQL ou des alias.

  • Des valeurs qui correspondent à des noms de tables ou de colonnes dans un schéma.

Sélectionnez une fonction pour voir sa syntaxe et une brève description.

Snowflake opère un suivi des alias de table et les suggère comme options de saisie semi-automatique. Par exemple, si vous exécutez une requête utilisant posts as p ou posts p en tant qu’alias, la prochaine fois que vous taperez p, la fonction de saisie automatique suggère l’alias en option.

Ajouter un script SQL à une feuille de calcul existante

Si vous avez un script SQL dans un fichier, vous pouvez l’ajouter à une feuille de calcul existante en procédant comme suit :

  1. Connectez-vous à Snowsight.

  2. Sélectionnez Projects » Worksheets pour ouvrir la liste des feuilles de calcul.

  3. Ouvrez une feuille de calcul.

  4. Survolez l’onglet de la feuille de calcul et sélectionnez Plus d'actions pour la feuille de calcul, puis Import SQL from File.

  5. Recherchez le fichier SQL sur votre ordinateur.

    Le contenu du fichier est ajouté à votre feuille de calcul.

Faire référence à des noms d’objets de base de données dans les feuilles de calcul

Pendant que vous écrivez des requêtes dans votre feuille de calcul, faites référence à des objets de base de données pertinents pour les requêtes dans l’explorateur Databases. Vous pouvez accéder à des objets de base de données spécifiques ou utiliser la fonction de recherche pour localiser une base de données, un schéma ou un objet auquel vous avez accès.

L’utilisation de l’explorateur de Databases vous permet d’épingler des bases de données et des objets de base de données pour une référence rapide. Lorsque vous survolez un objet de base de données, sélectionnez l’icône Pin pour l’épingler. Les objets épinglés apparaissent en haut de l’explorateur de Databases dans la section Pinned. Il se peut que vous deviez développer la section pour afficher tous les objets épinglés.

Après avoir localisé un objet de base de données, vous pouvez placer le nom de l’objet dans la feuille de calcul que vous êtes en train de modifier :

  1. Connectez-vous à Snowsight.

  2. Sélectionnez Projects » Worksheets pour ouvrir la liste des feuilles de calcul.

  3. Ouvrez une feuille de calcul.

  4. Localisez l’objet base de données dans l’explorateur de Databases.

  5. Survolez le nom de l’objet et sélectionnez le menu plus » Place Name in Editor.

    Le nom pleinement qualifié de l’objet apparaît après l’emplacement du curseur dans la feuille de calcul.

Pour les tables et les vues de base de données, vous pouvez également ajouter les noms des colonnes à la feuille de calcul que vous modifiez :

  1. Connectez-vous à Snowsight.

  2. Sélectionnez Projects » Worksheets pour ouvrir la liste des feuilles de calcul.

  3. Ouvrez une feuille de calcul.

  4. Localisez l’objet base de données dans l’explorateur de Databases.

  5. Survolez le nom de l’objet et sélectionnez le menu plus » Add Columns in Editor.

    Les noms de colonnes séparés par des virgules apparaissent après l’emplacement du curseur dans la feuille de calcul.

Formater vos requêtes

Lorsqu’une feuille de calcul est ouverte, vous pouvez sélectionner le nom de la feuille de calcul pour formater les requêtes dans votre feuille de calcul et afficher les raccourcis clavier.

  1. Connectez-vous à Snowsight.

  2. Sélectionnez Projects » Worksheets pour ouvrir la liste des feuilles de calcul.

  3. Ouvrez une feuille de calcul.

  4. Survolez l’onglet de la feuille de calcul et sélectionnez Plus d'actions pour la feuille de calcul.

  5. Dans la liste déroulante, sélectionnez Format query pour formater le texte de la requête afin qu’il soit plus lisible.

Charger des données dans une table

Si vous utilisez une feuille de calcul et que vous souhaitez ajouter des données, vous pouvez charger des données dans une table sans quitter votre feuille de calcul :

  1. Connectez-vous à Snowsight.

  2. Dans le menu de navigation, sélectionnez Projects » Worksheets.

  3. Ouvrez une feuille de calcul.

  4. Sélectionnez Objects pour afficher l’explorateur d’objets.

  5. Localisez une table spécifique à l’aide de la recherche ou de la navigation.

  6. Survolez un nom de table spécifique et sélectionnez Plus d'options » Load Data.

  7. Suivez les invites pour charger un ou plusieurs fichiers structurés ou non structurés de 50MB ou moins.

Reportez-vous à Chargement de données avec l’interface Web pour plus de détails.

Exécution de requêtes

Vous pouvez exécuter une ou plusieurs requêtes de manière séquentielle dans la même feuille de calcul.

  • Pour exécuter une seule requête, dans le lien de l’éditeur de requête, placez votre curseur dans la requête, puis sélectionnez le bouton Run.

  • Pour exécuter la feuille de calcul entière, sélectionnez Run All dans le menu déroulant More options situé à côté du bouton Run.

Exécution de feuilles de calcul dans des dossiers

Les dossiers n’ont plus de rôle qui leur est attribué. Le propriétaire ou l’éditeur d’une feuille de calcul dans un dossier peut modifier la feuille de calcul pour qu’elle s’exécute en tant qu’un rôle quelconque. Vous pouvez également ajouter USE ROLE à une feuille de calcul dans un dossier pour exécuter différentes instructions dans la feuille de calcul en tant que différents rôles.

Lorsque vous créez une feuille de travail à l’intérieur d’un dossier, la feuille de calcul est créée avec le rôle de votre session en cours.

Note

Pour exécuter une feuille de calcul dans un dossier qui a été partagé avec vous, même si vous disposez des autorisations View and Run ou Edit sur le dossier, vous devez utiliser le même rôle que la feuille de calcul. Si vous n’avez pas le même rôle, dupliquez la feuille de calcul et exécutez-la avec l’un de vos propres rôles.

Découverte des résultats de la feuille de calcul

Lorsque vous exécutez une requête ou toutes les requêtes d’une feuille de calcul, les résultats de la requête s’affichent.

Les résultats de la requête s’affichent sous la forme d’une table pouvant comporter jusqu’à 10 000 lignes. Si votre requête renvoie plus de 10 000 lignes, utilisez l’option Download results pour afficher tous les résultats.

Vous pouvez naviguer dans les résultats de la requête à l’aide des touches fléchées de votre clavier, comme vous le feriez avec une feuille de calcul. Sélectionnez des colonnes, des cellules, des lignes ou des plages dans la table de résultats. Toute sélection peut être copiée et collée.

Si vous souhaitez afficher vos résultats sous forme de graphique, sélectionnez Chart. Pour en savoir plus sur les graphiques, reportez-vous à Visualisation des données de la feuille de calcul.

Les résultats comprennent également des statistiques générées qui affichent des informations contextuelles pour chaque sélection, ainsi que des statistiques globales pour tous les résultats. Même si votre requête renvoie plus de 10.000 lignes, les statistiques reflètent l’intégralité de l’ensemble des résultats.

Pour plus de détails sur les résultats des feuilles de calcul et l’historique des versions, consultez Gestion de l’historique et des versions des feuilles de calcul.

Statistiques contextuelles automatiques

Sélectionnez des colonnes, des cellules, des lignes ou des plages dans la table des résultats pour afficher des informations pertinentes sur les données sélectionnées dans le volet d’inspection (à droite de la table des résultats). Des statistiques contextuelles sont générées automatiquement pour tous les types de colonnes. Les statistiques sont destinées à vous aider à donner un sens à vos données en un coup d’œil.

La vue d’ensemble des colonnes affiche un aperçu des statistiques de chaque colonne. Sélectionnez une colonne dans l’inspecteur ou l’en-tête de colonne pour voir des statistiques détaillées sur les colonnes.

Le volet des statistiques génère différentes métriques pour différents types de colonnes. Vous pouvez interagir avec les éléments du volet des statistiques et les filtrer.

Filled/empty meters

Toutes les colonnes indiquent le nombre de lignes remplies et vides. Les colonnes affichant certains types de données, comme les e-mails et JSON, indiquent également le nombre de lignes non valides.

Histograms

Affiché pour toutes les colonnes de date, les colonnes d’heure et les colonnes numériques.

L’histogramme indique les lignes qui tombent dans une plage particulière. Cliquez sur une barre ou faites-la glisser sur l’histogramme pour sélectionner une plage. Vous pouvez affiner votre sélection en cliquant sur les étiquettes de valeur au-dessus de l’histogramme pour saisir des valeurs spécifiques.

Frequency distributions

Affiché pour toutes les colonnes catégorielles. Les colonnes catégorielles sont des colonnes de texte dans lesquelles les mêmes valeurs sont utilisées plusieurs fois.

Email domain distributions

Affiché pour les colonnes d’e-mail. La distribution de domaine de messagerie montre la distribution de fréquence des occurrences de noms de domaine.

Key distributions

Affiché pour les colonnes JSON. La distribution des clés indique la fréquence des clés supérieures présentes dans l’ensemble de résultats si toutes les lignes contiennent des objets JSON. Si la colonne comprend des tableaux JSON, la distribution des clés affiche les types relatifs de valeurs JSON dans la colonne.

Afficher les détails de la requête

Les Query Details comprennent des informations sur l’exécution de la requête, notamment :

  • La durée d’exécution de la requête.

  • Nombre de lignes dans les résultats.

  • Quand l’exécution s’est terminée.

  • La quantité de données analysées par la requête.

  • Le rôle utilisé pour exécuter la requête.

  • L’entrepôt utilisé pour exécuter la requête.

Certains détails de la requête ne sont disponibles que pour 14 jours.

Afficher le profil de requête

Pour accéder à un profil détaillé de votre requête, dans le volet Query Details sélectionnez le menu plus » View Query Profile.

Le profil de requête s’ouvre dans un nouvel onglet du navigateur.

Télécharger les résultats de votre requête

Pour télécharger les résultats de votre requête sous forme de fichier formaté CSV ou TSV, sélectionnez Download results.

La taille de votre fichier dépend de la quantité de données renvoyées par votre requête. Snowflake ne limite pas la taille des fichiers exportés pour les résultats des requêtes.

Afficher l’historique des requêtes

Après avoir exécuté SQL dans une feuille de calcul, vous pouvez consulter l’historique des requêtes exécutées dans la feuille de calcul, par exemple pour comparer les résultats de différentes exécutions de requêtes. Vous devez utiliser le même rôle que la feuille de calcul pour afficher l’historique des requêtes pour la feuille de calcul.

Lorsque le volet Results est visible, sélectionnez Historique des requêtes (Query history) pour examiner les requêtes qui ont été exécutées dans la feuille de calcul, ainsi que les résultats de ces requêtes. L’historique comprend jusqu’à 25 requêtes exécutées dans cette feuille de calcul au cours de votre session en cours et des sessions précédentes au cours des 90 derniers jours.

Vous pouvez consulter les informations suivantes :

  • Le statut d’une requête en cours.

  • À quelle heure la requête a été exécutée.

  • Durée d’exécution de la requête, en millisecondes ou en secondes.

  • Quelle requête a été exécutée.

  • L’ID de la requête.

Sélectionnez une ligne pour voir les résultats de l’exécution de cette requête dans le volet Results. Si vous ne disposez pas du rôle principal utilisé pour exécuter une requête que vous affichez dans Query history, vous ne pouvez pas afficher les résultats de cette requête. Les sous-requêtes générées par des procédures stockées ou des feuilles de calcul Python ne s’affichent pas.

Pour filtrer l’historique des requêtes de la feuille de calcul par statut, entrepôt ou autres aspects :

  • Filtrez les exécutions de requêtes par statut. Par exemple, examinez les requêtes qui sont toujours au statut Running ou Queued et qui n’affichent pas encore de résultats.

  • Sélectionnez Filtre d'historique des requêtes pour filtrer par entrepôt, texte SQL dans la requête, un ID de requête spécifique ou une durée supérieure à une période spécifique.

Passez la souris sur une ligne d’exécution de requête pour afficher un aperçu complet de l’instruction SQL qui a été exécutée, copiez l’ID de requête et ouvrez éventuellement les détails de la requête pour l’exécution de la requête. Voir Examiner l’historique des requêtes à l’aide de Snowsight pour plus d’informations sur les détails de la requête.

Interrogation des données historiques expurgées d’une Snowflake Native App

Pour les requêtes liées à une Snowflake Native App, les champs query_text et error_message sont expurgés de l’historique de la requête dans les contextes suivants :

  • Les requêtes sont exécutées lors de l’installation ou de la mise à niveau de l’application.

  • Requêtes provenant d’une tâche enfant d’une procédure stockée appartenant à l’application.

Dans chacune de ces situations, la cellule de l’historique de la requête dans Snowsight apparaît vide.

Utilisation de filtres dans les feuilles de calcul

Les filtres système suivants sont disponibles pour tous les rôles :

  • :daterange

    Permet d’appliquer une plage de dates aux colonnes.

  • :datebucket

    Permet de regrouper les données agrégées par unité de temps (par exemple, par jour).

De plus, les administrateurs peuvent créer des filtres personnalisés à utiliser dans votre compte. Pour en savoir plus, voir Filtres personnalisés.

Prenons l’exemple suivant :

SELECT
    COUNT(O_ORDERDATE) as orders, O_ORDERDATE as date
FROM
    SNOWFLAKE_SAMPLE_DATA.TPCH_SF1.ORDERS
WHERE
    O_ORDERDATE = :daterange
GROUP BY
    :datebucket(O_ORDERDATE), O_ORDERDATE
ORDER BY
    O_ORDERDATE
Copy

Dans cet exemple, vous :

  • Incluez le filtre système :daterange dans votre clause WHERE.

  • Incluez le filtre système :datebucket dans votre clause GROUP BY.

Lorsque vous incluez les filtres dans votre requête, les boutons de filtre correspondants apparaissent en haut de votre feuille de calcul.

Lorsque les boutons de filtre apparaissent, ils suivent les boutons de filtre d'affichage et de masquage dans l'ordre des onglets.

Dans cet exemple, supposons que vous ayez défini le filtre Date bucket sur day, et le filtre Date range sur All time.

Lorsque vous exécutez la requête, les résultats sont regroupés par jour. Vous pouvez sélectionner une nouvelle plage de dates pour filtrer davantage les résultats.

Le tableau de résultats de cet exemple comprend deux colonnes, des commandes et la date. La colonne de commandes contient le nombre agrégé de commandes à une date donnée.

Filtres personnalisés

Les filtres personnalisés vous permettent de modifier les résultats d’une requête ou d’une visualisation sans modifier directement la requête. Les filtres sont mis en œuvre sous forme de mots-clés spéciaux qui se résolvent en une sous-requête ou une liste de valeurs, utilisées ensuite dans l’exécution de votre requête.

Le bouton Show or Hide Filter situé dans le coin supérieur gauche de la page vous permet d’afficher, de masquer et de gérer vos filtres personnalisés.

Accorder l’autorisation de créer des filtres personnalisés

Un administrateur de compte (un utilisateur avec le rôle ACCOUNTADMIN) doit accorder à chaque rôle, y compris au rôle ACCOUNTADMIN en soi, l’autorisation de créer des filtres personnalisés.

Pour accorder à un rôle la permission de créer des filtres personnalisés :

  1. Connectez-vous à Snowsight.

  2. Sélectionnez Projects » Worksheets pour ouvrir la liste des feuilles de calcul.

  3. Ouvrez une feuille de calcul.

  4. Sélectionnez le bouton Show or Hide Filter puis Manage Filters.

  5. Dans la boîte de dialogue qui apparaît, sélectionnez Edit Permission.

  6. Dans la boîte de dialogue Filter Permissions sélectionnez les rôles auxquels vous voulez accorder l’autorisation de créer des filtres.

  7. Sélectionnez Save.

Créer des filtres personnalisés

Pour créer un filtre personnalisé :

  1. Connectez-vous à Snowsight.

  2. Sélectionnez Projects » Worksheets pour ouvrir la liste des feuilles de calcul.

  3. Ouvrez une feuille de calcul.

  4. Sélectionnez le bouton Show or Hide Filter puis Manage Filters.

  5. Dans la boîte de dialogue qui apparaît, sélectionnez + Filter.

  6. Pour ajouter un filtre, procédez comme suit :

    Display Name

    Nom du filtre que les autres utilisateurs voient s’afficher en interne.

    SQL Keyword

    Mot clé unique à insérer dans les requêtes. Utilisez le format :<chaîne>, sans espaces. Par exemple : :myfilter.

    Description

    Description du filtre.

    Role

    Rôle utilisé lors de l’actualisation des valeurs de filtre dérivées d’une requête.

    Warehouse

    Entrepôt utilisé lors de l’actualisation des valeurs de filtre dérivées d’une requête.

    Options via

    Spécifie si les valeurs de filtre sont dérivées d’une requête ou d’une liste détaillée.

  7. Ajoutez des options au filtre.

  8. Sélectionnez Save.