Amazon Redshift ne prendra plus en charge l'utilisation des UDF Python après le 30 juin 2026. Nous allons commencer à l'appliquer par étapes. Pour plus d'informations sur les détails de la fin de vie de Python et des options de migration, consultez [ le billet de ](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/) blog publié le 30 juin 2025. Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # STL\_QUERY\_METRICS Contient des informations métriques, telles que le nombre de lignes traitées, l'utilisation du processeur et l'utilisation du disque input/output, pour les requêtes qui ont fini de s'exécuter dans des files d'attente de requêtes définies par l'utilisateur (classes de service). Pour afficher les métriques des requêtes actives qui sont en cours d’exécution, consultez la vue système [STV\_QUERY\_METRICS](r_STV_QUERY_METRICS.md). Les métriques de requête sont échantillonnées toutes les secondes. Par conséquent, la même requête exécutée plusieurs fois peut renvoyer des heures légèrement différentes. En outre, il est possible que les segments de requête qui s’exécutent en moins d’une seconde ne soient pas enregistrés. STL\_QUERY\_METRICS suit et regroupe les métriques au niveau de la requête, du segment et de l’étape. Pour plus d’informations sur les segments et les étapes de requête, consultez [Workflow d’exécution et de planification de requête](c-query-planning.md). De nombreuses métriques (`max_rows`, `cpu_time`, etc.) sont additionnées entre les tranches de nœuds. Pour plus d’informations sur les tranches de nœuds, consultez [Architecture système de l’entrepôt des données](c_high_level_system_architecture.md). Pour déterminer le niveau auquel la ligne communique les métriques, observez les colonnes `segment` et `step_type`. + Si `segment` et `step_type` sont définis sur `-1`, la ligne communique les métriques au niveau de la requête. + Si `segment` n’est pas défini sur `-1` et si `step_type` est défini sur `-1`, la ligne communique les métriques au niveau du segment. + Si `segment` et `step_type` ne sont pas définis sur `-1`, la ligne communique les métriques au niveau de l’étape. Les vues [SVL\_QUERY\_METRICS](r_SVL_QUERY_METRICS.md) et [SVL\_QUERY\_METRICS\_SUMMARY](r_SVL_QUERY_METRICS_SUMMARY.md) regroupent les données de cette vue et présentent les informations de manière plus accessible. STL\_QUERY\_METRICS est visible par tous les utilisateurs. Les super-utilisateurs peuvent voir toutes les lignes, tandis que les utilisateurs standard peuvent voir uniquement leurs propres données. Pour plus d’informations, consultez [Visibilité des données dans les tables et vues système](cm_chap_system-tables.md#c_visibility-of-data). Tout ou partie des données de cette table sont également disponibles dans la vue de surveillance SYS [SYS\_QUERY\_DETAIL](SYS_QUERY_DETAIL.md). Les données de la vue de surveillance SYS sont formatées pour être plus faciles à utiliser et à comprendre. Nous vous recommandons d’utiliser la vue de surveillance SYS pour vos requêtes. ## Colonnes de la table | Nom de la colonne | Type de données | Description | | --- | --- | --- | | userid | entier | ID de l’utilisateur qui a exécuté la requête qui a généré l’entrée. | | service\_class | entier | ID de la classe de service. Les files d’attente de requêtes sont définies dans la configuration WLM. Les métriques sont communiquées uniquement pour les files d’attente définies par l’utilisateur. | | query | entier | ID de requête. La colonne de requête peut servir à joindre les autres tables système et les vues. | | segment | entier | Numéro de segment. Une requête se compose de plusieurs segments et chaque segment d’une ou de plusieurs étapes. Les segments de requête peuvent s’exécuter en parallèle. Chaque segment s’exécute dans un processus unique. Si le segment a une valeur de -1, les valeurs du segment de métriques sont reportées au niveau de la requête. | | step\_type | entier | Type de l’étape exécutée. Pour obtenir une description des types d’étapes, consultez [Types d’étapes](r_STV_QUERY_METRICS.md#r_STV_QUERY_METRICS-step-type). | | starttime | timestamp | Heure au format UTC de début de l’exécution de la requête, avec 6 chiffres de précision pour les fractions de secondes. Par exemple : 2009-06-12 11:29:19.131358. | | slices | entier | Nombre de tranches du cluster. | | max\_rows | bigint | Nombre maximal de lignes produites pour une étape, regroupées entre toutes les tranches. | | rows | bigint | Nombre de lignes traitées par une étape. | | max\_cpu\_time | bigint | Durée maximale d’utilisation de l’UC, en microsecondes. Au niveau du segment, durée maximale d’utilisation de l’UC par le segment entre toutes les tranches. Au niveau de la requête, durée maximale d’utilisation de l’UC par n’importe quel segment de requête. | | cpu\_time | bigint | Durée d’utilisation de l’UC, en microsecondes. Au niveau du segment, durée totale d’utilisation de l’UC pour le segment entre toutes les tranches. Au niveau de la requête, somme des durées d’utilisation de l’UC pour la requête entre toutes les tranches et tous les segments. | | max\_blocks\_read | entier | Nombre maximal de blocs d’1 Mo lus par le segment, regroupés entre toutes les tranches. Au niveau du segment, nombre maximal de blocs d’1 Mo lus pour le segment entre toutes les tranches. Au niveau de la requête, nombre maximal de blocs d’1 Mo lus par n’importe quel segment de la requête. | | blocks\_read | bigint | Nombre de blocs d’1 Mo lus par la requête ou le segment. | | max\_run\_time | bigint | Durée maximale écoulée pour un segment (en microsecondes). Au niveau du segment, durée maximale d’exécution pour le segment entre toutes les tranches. Au niveau de la requête, durée maximale d’exécution pour n’importe quel segment de requête. | | run\_time | bigint | Somme des durées totales d’exécution, entre les tranches. La durée d’attente n’est pas incluse dans le délai d’exécution.
Au niveau du segment, somme des durées d’exécution pour le segment entre toutes les tranches. Au niveau de la requête, somme des durées d’exécution pour la requête entre toutes les tranches et tous les segments. Puisqu’il s’agit d’une somme, le délai d’exécution n’est pas lié au délai d’exécution de la requête. | | max\_blocks\_to\_disk | bigint | Quantité maximale d’espace disque utilisé pour écrire des résultats intermédiaires, en blocs de Mo. Au niveau du segment, quantité maximale d’espace disque utilisé par le segment entre toutes les tranches. Au niveau de la requête, quantité maximale d’espace disque utilisé par n’importe quel segment de requête. | | blocks\_to\_disk | bigint | Quantité d’espace disque utilisé par une requête ou un segment pour écrire des résultats intermédiaires, en blocs de Mo. | | étape | entier | Étape de la requête exécutée. | | max\_query\_scan\_size | bigint | Taille maximale des données analysées par une requête, en Mo. Au niveau du segment, taille maximale des données analysées par le segment entre toutes les tranches. Au niveau de la requête, taille maximale des données analysées par n’importe quel segment de requête. | | query\_scan\_size | bigint | Taille des données analysées par une requête, en Mo. | | query\_priority | entier | Priorité de la requête. Les valeurs possibles sont -1, 0, 1, 2, 3 et 4, où -1 signifie que cette priorité de requête n’est pas prise en charge. | | query\_queue\_time | bigint | Durée, en microsecondes, pendant laquelle la requête a été mise en file d’attente. | | service\_class\_name | character(64) | Nom de la classe de service. | ## Exemple de requête Pour rechercher des requêtes avec un temps UC élevé (plus de 1 000 secondes), exécutez la requête suivante. ``` Select query, cpu_time / 1000000 as cpu_seconds from stl_query_metrics where segment = -1 and cpu_time > 1000000000 order by cpu_time; query | cpu_seconds ------+------------ 25775 | 9540 ``` Pour rechercher des requêtes actives avec une jonction de boucles imbriquées qui a renvoyé plus d’un million de lignes, exécutez la requête suivante. ``` select query, rows from stl_query_metrics where step_type = 15 and rows > 1000000 order by rows; query | rows ------+----------- 25775 | 2621562702 ``` Pour rechercher des requêtes actives qui se sont exécutées pendant plus de 60 secondes et ont utilisé moins de 10 secondes de temps UC, exécutez la requête suivante. ``` select query, run_time/1000000 as run_time_seconds from stl_query_metrics where segment = -1 and run_time > 60000000 and cpu_time < 10000000; query | run_time_seconds ------+----------------- 25775 | 114 ```