Amazon Redshift は、パッチ 198 以降、新しい Python UDF の作成をサポートしなくなります。既存の Python UDF は、2026 年 6 月 30 日まで引き続き機能します。詳細については、[ブログ記事](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/)を参照してください。
# STL\$1QUERY\$1METRICS
ユーザー定義のクエリキュー (サービスクラス) でアクティブに実行され、完了したクエリについて、処理される列数、CPU 使用率、入出力、ディスク使用率などのメトリクス情報を含みます。現在実行されているアクティブなクエリのメトリクスを表示するには、[STV\$1QUERY\$1METRICS](r_STV_QUERY_METRICS.md) システムビューを参照してください。
クエリメトリクスは、1 秒間隔でサンプリングされます。結果として、同じクエリが複数実行され、わずかに異なる時刻を返す場合があります。また、1 秒未満で実行されるクエリセグメントは記録されない場合があります。
STL\$1QUERY\$1METRICS は、クエリレベル、セグメントレベル、およびステップレベルでメトリクスを追跡および集計します。クエリセグメントとステップの詳細については、「[クエリプランと実行ワークフロー](c-query-planning.md)」を参照してください。多くのメトリクス (`max_rows`、`cpu_time`など) は、ノードスライスを超えて合計されます。ノードスライスの詳細については、「[データウェアハウスシステムのアーキテクチャ](c_high_level_system_architecture.md)」を参照してください。
列がメトリクスをレポートするレベルを確認するには、`segment`列および `step_type` 列を調べます。
+ `segment` と `step_type` の両方が `-1` である場合、列はクエリレベルでメトリクスをレポートします。
+ `segment` が `-1` でなく、`step_type`が `-1` である場合、列はメトリクスをセグメントレベルでレポートします。
+ `segment` と `step_type` の両方が `-1` でない場合、列はステップレベルでメトリクスをレポートします。
[SVL\$1QUERY\$1METRICS](r_SVL_QUERY_METRICS.md) ビューと [SVL\$1QUERY\$1METRICS\$1SUMMARY](r_SVL_QUERY_METRICS_SUMMARY.md) ビューは、このビューのデータを集計し、より便利な形式で情報を表示します。
STL\$1QUERY\$1METRICS はすべてのユーザーに表示されます。スーパーユーザーはすべての行を表示できますが、通常のユーザーは自分のデータのみを表示できます。詳細については、「[システムテーブルとビューのデータの可視性](cm_chap_system-tables.md#c_visibility-of-data)」を参照してください。
このテーブルの一部またはすべてのデータは、SYS モニタリングビュー [SYS\$1QUERY\$1DETAIL](SYS_QUERY_DETAIL.md) でも確認できます。SYS モニタリングビューのデータは、使いやすく理解しやすいようにフォーマットされます。クエリには、SYS モニタリングビューを使用することをお勧めします。
## テーブルの列
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/redshift/latest/dg/r_STL_QUERY_METRICS.html)
## サンプルクエリ
CPU 時間の長いクエリ (1,000 秒以上) を検索するには、次のクエリを実行します。
```
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
```
ネストされたループ結合を持ち、100 万以上の行を返したクエリを検索するには、次のクエリを実行します。
```
select query, rows
from stl_query_metrics
where step_type = 15 and rows > 1000000
order by rows;
query | rows
------+-----------
25775 | 2621562702
```
60 秒以上実行されていて CPU 時間が 10 秒以下のアクティブなクエリを検索するには、次のクエリを実行します。
```
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
```