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\_WLM\_QUERY
WLM が扱うサービスクラス内で実行が試みられたクエリごとに、レコードが 1 件作成されます。
STL\_WLM\_QUERY はすべてのユーザーに表示されます。スーパーユーザーはすべての行を表示できますが、通常のユーザーは自分のデータのみを表示できます。詳細については、「[システムテーブルとビューのデータの可視性](cm_chap_system-tables.md#c_visibility-of-data)」を参照してください。
このテーブルの一部またはすべてのデータは、SYS モニタリングビュー [SYS\_QUERY\_HISTORY](SYS_QUERY_HISTORY.md) でも確認できます。SYS モニタリングビューのデータは、使いやすく理解しやすいようにフォーマットされます。クエリには、SYS モニタリングビューを使用することをお勧めします。
## テーブルの列
| 列名 | データ型 | 説明 |
| --- | --- | --- |
| userid | integer | エントリを生成したユーザーの ID。 |
| xid | integer | クエリまたはサブクエリのトランザクション ID。 |
| task | integer | ワークロードマネージャ全体を通じてクエリを追跡するために使用される ID。複数のクエリ ID と関連付けることができます。クエリを再起動すると、そのクエリには新しいタスク ID ではなく、新しいクエリ ID が割り当てられます。 |
| query | integer | クエリ ID。クエリを再起動すると、そのクエリには新しいタスク ID ではなく、新しいクエリ ID が割り当てられます。 |
| service\_class | integer | サービスクラスの ID。サービスクラスの ID のリストについては、「[WLM サービスクラス ID](cm-c-wlm-system-tables-and-views.md#wlm-service-class-ids)」を参照してください。 |
| slot\_count | integer | キューに設定された同時実行レベルに従ってクエリが使用する WLM クエリスロットの数。デフォルトは 1 です。詳細については、「[wlm\_query\_slot\_count](https://docs.aws.amazon.com/redshift/latest/dg/r_wlm_query_slot_count.html)」を参照してください。 |
| service\_class\_start\_time | timestamp | クエリがサービスクラスに割り当てられた時刻。この時刻は UTC タイムゾーンです。 |
| queue\_start\_time | timestamp | クエリがサービスクラスのキューに入れられた時刻。この時刻は UTC タイムゾーンです。 |
| queue\_end\_time | timestamp | クエリがサービスクラスのキューから解放された時刻。この時刻は UTC タイムゾーンです。 |
| total\_queue\_time | bigint | クエリがキュー内で消費した時間の合計 (マイクロ秒単位) |
| exec\_start\_time | timestamp | サービスクラス内でクエリの実行が始まった時刻。この時刻は UTC タイムゾーンです。 |
| exec\_end\_time | timestamp | サービスクラス内でクエリの実行が完了した時刻。この時刻は UTC タイムゾーンです。 |
| total\_exec\_time | bigint | クエリが実行にかかった時間 (マイクロ秒単位)。 |
| service\_class\_end\_time | timestamp | クエリがサービスクラスから解放された時刻。この時刻は UTC タイムゾーンです。 |
| final\_state | character(16) | 将来の利用のために予約されています。 |
| est\_peak\_mem | bigint | 将来の利用のために予約されています。 |
| query\_priority | char(20) | クエリの優先度です。有効な値は、n/a､lowest、low、normal、high、および highest です。ここで、n/a は、クエリ優先度がサポートされていないことを意味します。 |
| service\_class\_name | character(64) | サービクラス名。サービスクラスの詳細については、「[WLM システムテーブルとビュー](https://docs.aws.amazon.com/redshift/latest/dg/cm-c-wlm-system-tables-and-views.html)」を参照してください。 |
## サンプルクエリ
**クエリのキューと実行にかかったクエリの平均時間の表示**
次のクエリでは、4 を超えるサービスクラスの現在の設定を表示します。サービスクラス ID のリストについては、「[WLM サービスクラス ID](cm-c-wlm-system-tables-and-views.md#wlm-service-class-ids)」を参照してください。
次のクエリは、各クエリがクエリキュー内に置かれていた時間および実行にかかった時間の平均を、サービスクラス別にマイクロ秒単位で返します。
```
select service_class as svc_class, count(*),
avg(datediff(microseconds, queue_start_time, queue_end_time)) as avg_queue_time,
avg(datediff(microseconds, exec_start_time, exec_end_time )) as avg_exec_time
from stl_wlm_query
where service_class > 4
group by service_class
order by service_class;
```
このクエリは、次のサンプル出力を返します。
```
svc_class | count | avg_queue_time | avg_exec_time
-----------+-------+----------------+---------------
5 | 20103 | 0 | 80415
5 | 3421 | 34015 | 234015
6 | 42 | 0 | 944266
7 | 196 | 6439 | 1364399
(4 rows)
```
**クエリのキューと実行にかかったクエリの最大時間の表示**
次のクエリは、クエリがいずれかのクエリキュー内に置かれていた時間と実行にかかった時間の最大値を、サービスクラスごとにマイクロ秒単位で返します。
```
select service_class as svc_class, count(*),
max(datediff(microseconds, queue_start_time, queue_end_time)) as max_queue_time,
max(datediff(microseconds, exec_start_time, exec_end_time )) as max_exec_time
from stl_wlm_query
where svc_class > 5
group by service_class
order by service_class;
```
```
svc_class | count | max_queue_time | max_exec_time
-----------+-------+----------------+---------------
6 | 42 | 0 | 3775896
7 | 197 | 37947 | 16379473
(4 rows)
```