Schéma :: ACCOUNT_USAGE

Vue QUERY_INSIGHTS¶

Cette vue Utilisation du compte affiche une ligne pour chaque insight généré pour une requête.

Colonnes¶

Nom de la colonne	Type	Description
`start_time`	TIMESTAMP_LTZ	Heure de début de la requête.
`end_time`	TIMESTAMP_LTZ	Heure de fin de la requête.
`total_elapsed_time`	NUMBER	Durée totale écoulée pour la requête (en millisecondes).
`query_id`	VARCHAR	Identificateur interne / généré par le système pour l’instruction SQL.
`query_hash`	VARCHAR	La valeur de hachage calculée sur la base du texte SQL canonisé.
`query_parameterized_hash`	VARCHAR	La valeur de hachage calculée à partir de la requête paramétrée.
`warehouse_id`	VARCHAR	Identificateur interne / généré par le système pour l’entrepôt utilisé.
`warehouse_name`	VARCHAR	Entrepôt sur lequel la requête a été exécutée, le cas échéant.
`insight_instance_id`	NUMBER	Identificateur interne/généré par le système pour l’insight.
`insight_type_id`	VARCHAR	Identificateur du type d’information.
`message`	VARIANT	Informations structurées et détails sur l’insight.
`suggestions`	ARRAY	Tableau de chaînes, chacune contenant une action recommandée pour l’insight.
`is_opportunity`	BOOLEAN	Si `true`, l’insight comprend des suggestions pour améliorer les performances des requêtes. Par exemple : Pour un insight de type ID `QUERY_INSIGHT_NO_FILTER_ON_TOP_OF_TABLE_SCAN`, cette colonne contient `true` car les insights comprennent des suggestions pour améliorer les performances. Pour un insight de type ID `QUERY_INSIGHT_FILTER_WITH_CLUSTERING_KEY`, cette colonne contient `false` car les insights ne comprennent pas de suggestions pour améliorer les performances.
`insight_topic`	VARCHAR	Étiquette qui identifie le type d’impact sur les performances détecté par cet insight. Pour la liste des libellés, voir Rubriques sur les insights.

Rubriques sur les insights¶

Dans la colonne insight_topic, le libellé peut être l’un des éléments suivants :

TABLE_SCAN : Insights sur l’efficacité de l’accès aux tables. Cette étiquette s’applique aux types d’insights suivants :
JOIN : Insights sur l’efficacité des opérations JOIN dans la requête. Cette étiquette s’applique aux types d’insights suivants :
AGGREGATE : Insights sur l’efficacité des opérations agrégées dans la requête. Cette étiquette s’applique aux types d’insights suivants :
- QUERY_INSIGHT_INEFFICIENT_AGGREGATE
UNION : Insights sur l’efficacité des opérations UNION dans la requête. Cette étiquette s’applique aux types d’insights suivants :
- QUERY_INSIGHT_UNNECESSARY_UNION_DISTINCT
WAREHOUSE : Insights sur l’entrepôt utilisé pour la requête. Cette étiquette s’applique aux types d’insights suivants :
- QUERY_INSIGHT_REMOTE_SPILLAGE
- QUERY_INSIGHT_QUEUED_OVERLOAD

Notes sur l’utilisation¶

La latence pour la vue peut aller jusqu’à 90 minutes.

Exemples¶

L’exemple suivant renvoie les insights relatifs à la requête dont l’ID est 01bd3a9d-0910-8327-0000-09717704c032 :

SELECT query_id, insight_type_id, message, suggestions
  FROM SNOWFLAKE.ACCOUNT_USAGE.QUERY_INSIGHTS
  WHERE query_id = '01bd3a9d-0910-8327-0000-09717704c032';

Copy

L’exemple suivant renvoie les insights relatifs aux requêtes qui ont le même hachage de texte de requête paramétré. Ces requêtes utilisent la même instruction SELECT, à l’exception des littéraux spécifiés dans l’instruction.

SELECT query_id, insight_type_id, message, suggestions
  FROM SNOWFLAKE.ACCOUNT_USAGE.QUERY_INSIGHTS
  WHERE query_parameterized_hash = '4bb66effc1a3c8b4e94a728f7caaa736';

Copy

L’exemple suivant renvoie les insights relatifs aux requêtes exécutées au cours de la semaine écoulée :

SELECT query_id, insight_type_id, message, suggestions
  FROM SNOWFLAKE.ACCOUNT_USAGE.QUERY_INSIGHTS
  WHERE start_time > TO_DATE(DATEADD(DAY, -7, CURRENT_DATE()));

Copy

L’exemple suivant renvoie les insights relatifs aux requêtes exécutées au cours de la semaine écoulée et qui ont pris plus d’une heure à s’exécuter :

SELECT query_id, insight_type_id, message, suggestions
  FROM SNOWFLAKE.ACCOUNT_USAGE.QUERY_INSIGHTS
  WHERE start_time > TO_DATE(DATEADD(DAY, -7, CURRENT_DATE()))
    AND total_duration > 3600000;

Copy

L’exemple suivant renvoie les insights relatifs aux requêtes exécutées au cours de la semaine écoulée, qui ont pris plus d’une heure à s’exécuter et qui ont utilisé l’entrepôt avec l’ID 84412315:

SELECT query_id, insight_type_id, message, suggestions
  FROM SNOWFLAKE.ACCOUNT_USAGE.QUERY_INSIGHTS
  WHERE start_time > TO_DATE(DATEADD(DAY, -7, CURRENT_DATE()))
    AND total_duration > 3600000
    AND warehouse_id = 84412315;

Copy