Filtrer les résultats des requêtes dans les tableaux de bord et des feuilles de calcul¶

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

Pour permettre à un utilisateur de créer des filtres personnalisés, un utilisateur ayant le rôle ACCOUNTADMIN doit accorder les autorisations correspondantes à un rôle accordé à cet utilisateur. Vous ne pouvez utiliser Snowsight que pour accorder aux rôles la possibilité de créer des filtres personnalisés.

Pour accorder à un rôle l’autorisation de créer des filtres personnalisés pour votre compte, procédez comme suit :

1. Connectez-vous à Snowsight.

2. Sélectionnez Projects » Worksheets pour ouvrir la liste des feuilles de calcul et ouvrir une feuille de calcul, ou sélectionnez Projects » Dashboards pour ouvrir la liste des tableaux de bord et ouvrir un tableau de bord.

3. Sélectionnez et, si vous êtes dans une feuille de calcul, sélectionnez Manage Filters.

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

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

6. Sélectionnez Save.

Créer un filtre personnalisé¶

Vous devez utiliser Snowsight pour créer un filtre et vous devez utiliser un rôle avec des autorisations pour créer des filtres personnalisés.

Pour créer un filtre personnalisé, procédez comme suit :

1. Connectez-vous à Snowsight.

2. Sélectionnez Projects » Worksheets pour ouvrir la liste des feuilles de calcul et ouvrir une feuille de calcul, ou sélectionnez Projects » Dashboards pour ouvrir la liste des tableaux de bord et ouvrir un tableau de bord.

3. Sélectionnez et, si vous êtes dans une feuille de calcul, sélectionnez Manage Filters.

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

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

   1. Pour le Display Name, saisissez un nom pour le filtre. Ce nom apparaît sur le filtre lorsque vous le sélectionnez sur une feuille de calcul ou un tableau de bord.

   2. Pour le SQL Keyword, saisissez un mot clé unique à insérer dans les requêtes. Utilisez le format :<chaîne>, sans espaces. Par exemple : :page_path.

   3. Pour la Description, entrez une description du filtre.

   4. Pour le Role, sélectionnez un rôle à associer au filtre et exécutez la requête utilisée pour remplir les valeurs du filtre, si le filtre est basé sur une requête. Seuls les rôles autorisés à créer des filtres personnalisés apparaissent dans la liste déroulante. Voir Gérer la propriété des filtres personnalisés pour plus de détails.

   5. Pour Warehouse, sélectionnez un entrepôt à utiliser pour actualiser les valeurs du filtre, si le filtre est basé sur une requête. Le rôle propriétaire du filtre doit avoir le privilège USAGE sur l’entrepôt que vous sélectionnez. Si vous souhaitez exécuter et valider votre requête dans le cadre de ces étapes, l’entrepôt doit être en cours d’exécution.

   6. Pour Options via, choisissez si les valeurs du filtre sont alimentées par une requête ou une liste :

      • Si vous sélectionnez Query, sélectionnez Write Query et consultez Écrire une requête pour remplir un filtre pour obtenir des conseils sur la rédaction d’une requête de filtrage.

      • Si vous sélectionnez List, procédez comme suit :

        1. Sélectionnez Edit List.

        2. En option, pour Name, saisissez un nom pour l’élément de liste. Le nom apparaît dans la liste déroulante du filtre. Si vous ne fournissez pas de nom, la Value est utilisée.

        3. Pour la Value, saisissez la valeur du nom de la colonne à utiliser dans le filtre.

        4. Continuez à ajouter des paires de noms et de valeurs jusqu’à ce que votre liste soit complète, puis sélectionnez Save.

6. Dans la boîte de dialogue Add Filter , pour Value Type, choisissez si les éléments de la liste sont des types de données Text ou Number.

7. Si vous souhaitez que les utilisateurs puissent sélectionner plusieurs éléments dans la liste déroulante des options de filtrage, activez le bouton bascule pour Multiple values can be selected.

8. Si vous souhaitez que les utilisateurs puissent voir les résultats de tous les éléments de la colonne, activez le bouton bascule Include an « All » option, puis sélectionnez le mode de fonctionnement de l’option All :

   • Sélectionnez Any value pour que le filtre All signifie que la colonne à laquelle le filtre s’applique peut avoir n’importe quelle valeur dans les résultats, que cette valeur existe ou non dans la liste des filtres.

   • Sélectionnez Any value in list of options pour que All dans le filtre signifie que la colonne à laquelle le filtre s’applique contient n’importe quel élément de la liste de filtres.

9. Si vous souhaitez que les utilisateurs puissent voir les résultats pour les éléments non spécifiés dans le filtre, activez le bouton bascule pour Include an « Other » option.

10. Sélectionnez Save.

11. Sélectionnez Done pour fermer la boîte de dialogue Filters.

Gérer la propriété des filtres personnalisés¶

Chaque filtre personnalisé est associé à un rôle. Toute personne ayant ce rôle peut modifier ou supprimer le filtre. Les utilisateurs ayant le rôle ACCOUNTADMIN peuvent voir et modifier tous les filtres du compte.

Si le rôle associé à un filtre est supprimé, le rôle qui supprime le rôle du filtre n’hérite pas de la propriété du filtre personnalisé. Au lieu de cela, un utilisateur ayant le rôle ACCOUNTADMIN peut modifier le filtre et changer le rôle associé au filtre.

Gérer la fréquence d’actualisation d’un filtre personnalisé¶

Un filtre personnalisé alimenté par une requête SQL a également une fréquence d’actualisation. La fréquence d’actualisation peut être horaire, quotidienne ou jamais.

Le filtre s’exécute en fonction de la date à laquelle il a été enregistré et du temps nécessaire à l’exécution de la requête qui actualise les options du filtre.

Par exemple, si vous enregistrez un filtre dont la fréquence d’actualisation des requêtes est définie sur 10:07 AM, la première requête d’actualisation est exécutée à 11:07 AM ou après. Si un grand nombre de requêtes d’actualisation de filtre sont planifiées pour être exécutées en même temps, les requêtes sont mises en file d’attente afin de limiter le nombre de requêtes d’actualisation de filtre exécutées en même temps. La prochaine actualisation du filtre est basée sur le moment où la dernière actualisation s’est achevée. Dans cet exemple, si l’actualisation de la requête à 11:07 AM prend 20 minutes, la prochaine requête d’actualisation sera exécutée à 12:27 PM ou après.

Les actualisations de filtres sont exécutées par l’utilisateur qui a créé ou modifié le filtre en dernier lieu et sont visibles dans l” Query History comme l’un des types de Queries executed by user tasks. Voir Surveillance de l’activité des requêtes avec l’historique des requêtes pour plus de détails sur l’utilisation de l” Query History.

Pour déterminer quel filtre est responsable de l’actualisation d’une requête, vous devez ouvrir la liste des filtres et ouvrir chaque filtre pour en voir les détails.

SELECT * FROM SNOWFLAKE.ACCOUNT_USAGE.LOGIN_HISTORY
WHERE
    FIRST_AUTHENTICATION_FACTOR = 'OAUTH_ACCESS_TOKEN'
    AND
    REPORTED_CLIENT_TYPE = 'SNOWFLAKE_UI'
    AND
    EVENT_TIMESTAMP > DATEADD('DAY', -2, CURRENT_DATE());
ORDER BY
    EVENT_TIMESTAMP DESC;

Appliquer et enregistrer des filtres¶

Lorsque vous modifiez les options sélectionnées dans un filtre, l’option permettant d’appliquer vos modifications apparaît. Lorsque vous sélectionnez Apply, la feuille de calcul ou le tableau de bord s’exécute et les résultats filtrés mis à jour s’affichent, ce qui vous permet de vérifier les modifications sans les enregistrer.

Après avoir modifié un filtre dans un tableau de bord, vous avez la possibilité d’enregistrer vos modifications. Lorsque vous sélectionnez Save, les modifications que vous avez apportées au tableau de bord sont enregistrées et accessibles aux autres utilisateurs du tableau de bord.

Par exemple, vous pouvez sélectionner Apply pour modifier un filtre afin d’afficher les résultats de All Time, mais vous ne voulez pas que le tableau de bord affiche un volume de données aussi important la prochaine fois que quelqu’un l’ouvrira. Vous ne sélectionnez donc pas Save. Après avoir exécuté votre tableau de bord sur toute la durée, vous remplacez le filtre de plage de dates par Last 7 days, vous sélectionnez Apply pour exécuter le tableau de bord, puis Save pour enregistrer cette valeur de filtre par défaut pour les utilisateurs du tableau de bord.

Exemple : utilisation des filtres de date¶

Par exemple, si vous disposez d’une table contenant des données de commandes, telle que la table ORDERS dans la base de données SNOWFLAKE_SAMPLE_DATA et le schéma TPCH_SF1, vous pouvez interroger la table et regrouper les résultats par compartiment temporel spécifique, par exemple par jour ou par semaine, et spécifier un intervalle de dates spécifique pour lequel les résultats doivent être récupérés.

Pour ce faire, vous pouvez écrire une requête comme suit :

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

Dans cet exemple, vous :

• Comptez le nombre de commandes et récupérez les détails concernant la date de la commande dans la table ORDERS.

• Filtrez vos résultats en fonction d’une plage de dates spécifique en incluant le filtre système :daterange dans votre clause WHERE.

• Regroupez vos résultats par période spécifique en incluant le filtre système :datebucket dans votre clause GROUP BY.

• Triez les résultats de la période la plus ancienne à la plus récente en incluant la clause ORDER BY.

Lorsque vous ajoutez des filtres à votre requête, des boutons de filtre correspondants apparaissent en haut de votre feuille de calcul ou de votre tableau de bord :

Pour manipuler les résultats de votre requête, utilisez les filtres pour sélectionner des valeurs spécifiques.

Pour cet exemple, définissez le filtre Group by, qui correspond au filtre du compartiment de date, de manière à ce qu’il soit groupé par Day. Définissez l’autre filtre, qui correspond au filtre de plage de dates, sur All time.

Lorsque vous sélectionnez Apply et que vous appliquez le filtre à vos résultats, les résultats sont regroupés par jour et des résultats comme ceux qui suivent apparaissent :

+--------+------------+
| orders |  buckets   |
+--------+------------+
|    621 | 1992-01-01 |
|    612 | 1992-01-02 |
|    598 | 1992-01-03 |
|    670 | 1992-01-04 |
+--------+------------+

Vous pouvez sélectionner un compartiment de date différent pour afficher un autre groupement de données. Par exemple, pour voir les données relatives aux commandes hebdomadaires, définissez le filtre Group by sur Week et sélectionnez Apply. Des résultats comme ceux qui suivent apparaissent :

+--------+------------+
| orders |  buckets   |
+--------+------------+
|   3142 | 1991-12-30 |
|   4404 | 1992-01-06 |
|   4306 | 1992-01-13 |
|   4284 | 1992-01-20 |
+--------+------------+