Analyse des charges de travail de requêtes avec l’explorateur de performances¶

Accès complet aux données de l’Explorateur de performances dans le compte¶

Vous avez un accès complet aux données de l’Explorateur de performances pour votre compte lorsque n’importe quel rôle qui vous est accordé remplit l’une des conditions suivantes :

• Votre rôle est le rôle ACCOUNTADMIN.

• Votre rôle s’est vu accorder les IMPORTED PRIVILEGES sur la base de données SNOWFLAKE partagée (consultez Permettre à d’autres rôles d’utiliser des schémas dans la base de données SNOWFLAKE).

• Votre rôle s’est vu accorder le rôle d’application SNOWFLAKE.PERFORMANCE_EXPLORER_USER.

Par exemple, pour donner à l’utilisateur jdoe un accès complet à l’Explorateur de performances à l’aide d’un rôle personnalisé, exécutez :

USE ROLE ACCOUNTADMIN;

CREATE ROLE pe_viewer_role;
GRANT APPLICATION ROLE SNOWFLAKE.PERFORMANCE_EXPLORER_USER TO ROLE pe_viewer_role;
GRANT ROLE pe_viewer_role TO USER jdoe;

Voir les métriques des requêtes sans accès complet au compte¶

Si vous n’avez pas un accès complet comme décrit ci-dessus, vous pouvez toujours voir l’activité des requêtes si n’importe quel rôle qui vous est accordé remplit l’une des conditions suivantes :

• Votre rôle s’est vu accorder le rôle de base de données GOVERNANCE_VIEWER dans la base de données SNOWFLAKE (activité des requêtes à l’échelle du compte).

• Votre rôle dispose du privilège MONITOR ou du privilège``MANAGE WAREHOUSES`` sur le compte, ce qui couvre effectivement tous les entrepôts (activité des requêtes qui utilise des entrepôts).

• Votre rôle dispose de OWNERSHIP, MONITOR ou OPERATE sur au moins un entrepôt (activité des requêtes uniquement pour les requêtes qui se sont exécutées sur des entrepôts que vous pouvez surveiller ou exploiter). Pour plus de détails, voir Privilèges d’entrepôt.

Si aucune des conditions ci-dessus ne s’applique et que vous ne pouvez pas MONITOR ou OPERATE un entrepôt, l’Explorateur de performances affiche une erreur d’autorisation pour l’activité des requêtes. Cela est intentionnel : sans au moins un entrepôt autorisé, aucune métrique de requête ne serait visible. En pratique, de nombreux comptes incluent un entrepôt par défaut que tous les utilisateurs peuvent surveiller. Consultez les modèles Snowsight.

Les filtres d’entrepôt répertorient les entrepôts que vous êtes autorisé à utiliser dans les filtres (par exemple, les entrepôts que vous pouvez MONITOR ou OPERATE et, dans certains cas, les entrepôts qui ont eu une activité des requêtes dans la fenêtre de conservation). La visibilité à l’échelle de l’entrepôt est similaire, dans l’esprit, aux règles de l’Query History dans Surveillance de l’activité des requêtes avec l’historique des requêtes, mais l’Explorateur de performances utilise tous les rôles qui vous sont accordés et combine plusieurs types de privilèges, de sorte que les règles exactes diffèrent.

Filtres de base de données et répartitions orientées base de données¶

Pour voir toutes les bases de données dans les filtres de base de données (et les agrégations associées par base de données), tout rôle qui vous est accordé doit remplir l’une des conditions suivantes :

• Votre rôle remplit les conditions d’un accès complet aux données Performance Explorer dans le compte (voir la section précédente).

• Votre rôle a reçu le rôle de base de données OBJECT_VIEWER dans la base de données SNOWFLAKE.

• Votre rôle possède RESOLVE ALL sur le compte.

• Votre rôle possède MONITOR sur le compte.

Sinon, vous ne voyez que les bases de données pour lesquelles n’importe quel rôle qui vous est accordé dispose d’au moins un privilège sur la base de données. Les requêtes peuvent toujours apparaître dans d’autres sections même si elles affectent une base de données que vous ne pouvez pas lister, sauf si l’UI nomme explicitement des bases de données (par exemple, certaines répartitions du panneau latéral).

Événements d’entrepôt¶

Pour voir les événements d’entrepôt pour tous les entrepôts qui apparaissent dans votre activité de requête autorisée, tout rôle qui vous est accordé doit remplir l’une des conditions suivantes :

• Votre rôle remplit les conditions d’un accès complet aux données Performance Explorer dans le compte (voir la section précédente).

• Votre rôle a reçu le rôle de base de données USAGE_VIEWER dans la base de données SNOWFLAKE.

• Un rôle actif possède le privilège MONITOR sur le compte.

• Un rôle actif possède le privilège MANAGE WAREHOUSES sur le compte.

Dans le cas contraire, les événements d’entrepôt sont limités aux entrepôts pour lesquels vous disposez de OWNERSHIP,``MONITOR`` ou OPERATE. Si vous ne disposez d’aucun de ces privilèges d’entrepôt ou d’aucun de ces rôles de base de données liés à l’utilisation, l’Explorateur de performances affiche une erreur d’autorisation pour les événements d’entrepôt.

Tables principales et événements de modification de table¶

La section Tables principales et les événements de modification de table nécessitent un accès complet ou le rôle de base de données GOVERNANCE_VIEWER dans la base de données SNOWFLAKE. Snowflake n’offre pas d’alternative par table avec des privilèges réduits pour ces sections, en raison de contraintes liées à la sécurité et aux performances. Si vous ne respectez pas cette condition, ces sections affichent une erreur d’autorisation.

Graphiques vides, résultats filtrés et erreurs d’autorisation¶

Pour des raisons de sécurité, un graphique ou un tableau vide peut signifier qu’il n’y a pas eu d’activité au cours de la période sélectionnée ou que vos rôles ne peuvent pas voir cette activité. Les erreurs d’autorisation au niveau des vignettes appellent des privilèges manquants (par exemple, la visibilité de la gouvernance pour les métriques de table).

Modifications des privilèges et actualisation des données¶

Les mises à jour des autorisations et des révocations peuvent prendre quelques heures pour affecter ce que l’Explorateur de performances affiche.

Filtres de l’explorateur de performances¶

En haut du tableau de bord de l’explorateur de performances, vous pouvez appliquer les filtres suivants :

• Preset - Choisissez None ou une combinaison enregistrée de filtres de période, d’entrepôt, de base de données et de rôle. À partir du menu, vous pouvez enregistrer les filtres actuels sous forme de nouveaux paramètres prédéfinis, effacer tous les filtres, copier un lien qui encode les filtres actuels et gérer les paramètres prédéfinis enregistrés (par exemple, définir ou modifier un paramètre prédéfini par défaut).

  

• Period - Sélectionnez une période, telle que la dernière semaine, les deux dernières semaines ou une plage personnalisée. Le tableau de bord affiche les métriques pour la période spécifiée.

  L’explorateur de performances affiche les métriques sur une semaine par défaut. Il prend en charge une période pouvant aller jusqu’à un mois, à partir de la date actuelle.

  Plusieurs graphiques de l’explorateur de performances montrent le pourcentage de changement par rapport à la période précédente. La plage de la période précédente correspond à la plage de la période actuelle. Par exemple, si la période actuelle est de deux semaines, la période précédente correspond aux deux semaines précédant le début de la période actuelle.

• Warehouse - Sélectionnez un entrepôt pour afficher les métriques uniquement pour l’activité des requêtes qui ont été exécutées en utilisant cet entrepôt. Pour limiter les entrepôts de la liste, utilisez le champ de recherche. Pour effacer le filtre, sélectionnez. X.

• Database - Sélectionnez une base de données pour afficher les métriques uniquement pour l’activité de requête qui a accédé à cette base de données. Pour limiter les bases de données de la liste, utilisez le champ de recherche. Pour effacer le filtre, sélectionnez. X.

• Role - Sélectionnez un rôle pour afficher les métriques uniquement pour l’activité de requête initiée par ce rôle. Pour limiter les rôles dans la liste, utilisez le champ de recherche. Pour effacer le filtre, sélectionnez. X.

Graphiques Explorateur de performances¶

L’explorateur de performances affiche les métriques dans différents types de graphiques. Il est important de comprendre les composantes de chaque type de graphique et de savoir comment les interpréter.

Sur l’onglet Queries, métriques du graphique en courbes utilisez des graphiques à lignes qui sont similaires à l’image suivante :

Le tableau suivant décrit les éléments dans l’image :

Certains graphiques incluent une grande valeur moyenne ou médiane et le pourcentage de changement pour la période. Lorsqu’il y a plus d’une ligne, il y a une clé pour les lignes au-dessus du graphique.

Certains graphiques ont une information icon à côté du titre. Survolez l’icône pour obtenir des informations sur les métriques du graphique.

Vous pouvez survoler un point du graphique linéaire pour voir la valeur d’une heure spécifique :

La section Entrepôts principaux sur l’onglet Warehouses et la section Tables principales sur l’onglet Tables ont des graphiques à barres qui sont similaires à l’image suivante :

Le tableau suivant décrit les éléments dans l’image :

Dans les graphiques linéaires et dans les graphiques à barres, sélectionnez View details > pour ouvrir un panneau latéral qui affiche des informations plus détaillées sur les métriques du graphique. Les informations détaillées varient en fonction des métriques indiquées dans le graphique. La plupart des panneaux secondaires présentent des tables triables que vous pouvez utiliser pour examiner les métriques d’entrepôts, de rôles, de bases de données et de requêtes spécifiques au cours de la période.

Utilisez le champ Search results au-dessus de la table pour filtrer les lignes ; la recherche est insensible à la casse et s’applique à l’ensemble des onglets d’agrégation du panneau latéral (par exemple, By warehouse et By role). Sélectionnez le contrôle de téléchargement pour exporter la table en tant que fichier CSV. Le nom du fichier téléchargé reflète le graphique et les filtres du tableau de bord actif.

Vous pouvez sélectionner une période de temps personnalisée dans un panneau latéral en cliquant sur l’endroit où commence la période personnalisée et en déplaçant votre curseur jusqu’à l’endroit où la période personnalisée se termine.

Dans un panneau latéral, vous pouvez sélectionner l’un des onglets suivants :

• By warehouse - Indique l’activité par entrepôt au cours de la période.

• By database - Indique l’activité par base de données au cours de la période.

• By role - Indique l’activité par rôle au cours de la période.

• By grouped queries - Indique les requêtes qui ont été exécutées au cours de la période. Certaines requêtes sont éditées pour des raisons de sécurité. Pour plus d’informations sur la façon dont les requêtes sont regroupées, consultez Utiliser la vue Historique des requêtes groupées dans Snowsight.

Si vous sélectionnez une période personnalisée, ces onglets s’actualisent pour afficher les métriques uniquement pour la période personnalisée sélectionnée.

Les sections Entrepôts principaux et Tables principales comportent également des graphiques d’événements similaires à l’image suivante :

Un graphique d’événements montre une table triable d’événements pour le type d’objet. Vous pouvez examiner les données à la recherche d’événements inattendus. Pour plus d’informations sur les événements d’entrepôt, voir Vue WAREHOUSE_EVENTS_HISTORY. Pour plus d’informations sur les événements de table, voir Vue TABLES.