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 |
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 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