Vue QUERY_HISTORY (Account Usage) : changements relatifs aux colonnes et aux nouvelles colonnes (en attente)

Attention

Ce changement de comportement est présent dans le bundle 2024_02.

Pour connaître le statut actuel du bundle, reportez-vous à Historique du bundle.

Le Vue QUERY_HISTORY comprend les nouvelles colonnes et les modifications des colonnes suivantes :

Nouvelles colonnes dans la vue QUERY_HISTORY

Lorsque ce bundle de changements de comportement est activé, la vue QUERY_HISTORY Account Usage comprend les nouvelles colonnes suivantes :

Nom de la colonne

Type de données

Description

SECONDARY_ROLE_STATS

VARCHAR

Une chaîne formatée JSON qui contient trois champs concernant les rôles secondaires qui ont été évalués dans la requête : une liste de rôles secondaires ou ALL en fonction de la session, un décompte du nombre de rôles secondaires, et l’ID généré en interne/par le système pour chaque rôle secondaire. Le compte et le nombre d’IDs a un maximum de 50.

ROWS_WRITTEN_TO_RESULT

NUMBER

Nombre de lignes écrites dans un objet de résultat. Pour CREATE TABLE AS SELECT (CTAS) et toutes les opérations DML, ce résultat est 1. Les valeurs des colonnes ROWS_INSERTED, ROWS_UPDATED et ROWS_DELETED reflètent le nombre de lignes effectivement insérées, mises à jour ou supprimées.

Pour plus d’informations, consultez Colonne ROWS_PRODUCED obsolète

ROWS_INSERTED

NUMBER

Nombre de lignes insérées par la requête.

QUERY_RETRY_TIME

NUMBER

Temps d’exécution total (en millisecondes) pour les tentatives d’interrogation causées par des erreurs pouvant donner lieu à une action. Pour plus d’informations, voir Colonnes de nouvelles tentatives des requêtes.

QUERY_RETRY_CAUSE

VARIANT

Tableau de messages d’erreur pour les erreurs pouvant donner lieu à une action. Le tableau contient un message d’erreur pour chaque nouvelle tentative d’interrogation. S’il n’y a pas de nouvelle tentative d’interrogation, la table est vide. Pour plus d’informations, voir Colonnes de nouvelles tentatives des requêtes.

FAULT_HANDLING_TIME

NUMBER

Temps d’exécution total (en millisecondes) pour les tentatives de requêtes causées par des erreurs qui ne peuvent pas donner lieu à des actions. Pour plus d’informations, voir Colonnes de nouvelles tentatives des requêtes.

Ces colonnes sont ajoutées en tant que dernières colonnes (les plus à droite) dans la vue.

Pour plus d’informations, voir également Information Schema : nouvelles colonnes dans la sortie pour les fonctions QUERY_HISTORY, QUERY_HISTORY_BY_* (en attente).

Colonnes de nouvelles tentatives des requêtes

Il se peut qu’une requête doive être relancée une ou plusieurs fois pour aboutir. Plusieurs causes peuvent être à l’origine d’une nouvelle tentative d’interrogation. Certaines de ces causes peuvent donner lieu à des actions, c’est-à-dire qu’un utilisateur peut apporter des modifications afin de réduire ou d’éliminer les nouvelles tentatives de requêtes pour une requête spécifique. Par exemple, si une requête est relancée en raison d’une erreur de mémoire, la modification des paramètres de l’entrepôt peut résoudre le problème.

Certaines tentatives d’interrogation sont dues à une tolérance aux pannes qui ne peut pas être corrigée. En d’autres termes, il n’y a pas de changement que l’utilisateur puisse faire pour empêcher la réitération de la requête. Par exemple, une panne de réseau peut entraîner une nouvelle tentative de requête. Dans ce cas, aucune modification de la requête ou de l’entrepôt qui l’exécute ne peut empêcher la réitération de la requête.

Les colonnes QUERY_RETRY_TIME, QUERY_RETRY_CAUSE et FAULT_HANDLING_TIME peuvent vous aider à optimiser les requêtes qui sont relancées et à mieux comprendre les fluctuations des performances des requêtes.

Colonne ROWS_PRODUCED obsolète

La colonne ROWS_PRODUCED sera obsolète dans une prochaine version. La valeur de la colonne ROWS_PRODUCED ne reflète pas toujours le nombre logique de lignes affectées par une requête. Par exemple, la valeur de la colonne ROWS_PRODUCED peut inclure des lignes qui ont été supprimées en raison de la réécriture de micropartitions et peut être supérieure au nombre réel de lignes affectées. Snowflake recommande d’utiliser les colonnes ROWS_INSERTED, ROWS_UPDATED, ROWS_WRITTEN_TO RESULTS ou ROWS_DELETED à la place.

Changements relatifs aux colonnes dans la vue QUERY_HISTORY

Les colonnes suivantes sont incluses dans la vue Vue QUERY_HISTORY Account Usage :

  • BYTES_WRITTEN_TO_RESULT

  • ROWS_INSERTED

Les valeurs de ces colonnes pour des types de requêtes spécifiques sont les suivantes :

Avant la modification:

BYTES_WRITTEN_TO_RESULT

0 pour les petites requêtes.

ROWS_INSERTED:

0 pour les requêtes CREATE TABLE AS SELECT (CTAS).

Après la modification:

BYTES_WRITTEN_TO_RESULT

Octets écrits dans un objet de résultat pour les petites requêtes.

ROWS_INSERTED:

Nombre de lignes insérées pour les requêtes CREATE TABLE AS SELECT (CTAS).

Pour plus d’informations, voir également Information Schema : nouvelles colonnes dans la sortie pour les fonctions QUERY_HISTORY, QUERY_HISTORY_BY_* (en attente).

Réf : 1431, 1524, 1540