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/)を参照してください。
# SYS\_QUERY\_DETAIL
SYS\_QUERY\_DETAIL を使用して、クエリの詳細をさまざまなメトリクスレベルで表示します。各行は、特定の WLM クエリについて、特定のメトリクスレベルの詳細を表します。このビューには、DDL、DML、ユーティリティコマンド (コピーおよびアンロード) など、多くの種類のクエリが含まれています。クエリの種類によっては、一部の列との関連がない場合があります。例えば、external\_scanned\_bytes は内部テーブルには関係しません。
SYS\_QUERY\_DETAIL はすべてのユーザーが表示可能です。スーパーユーザーはすべての行を表示できますが、通常のユーザーは自分のデータのみを表示できます。詳細については、「[システムテーブルとビューのデータの可視性](cm_chap_system-tables.md#c_visibility-of-data)」を参照してください。
**注記**
実行されたクエリを含むトランザクションが正常にコミットされたかどうかを確認するには、システムテーブルと `sys_transaction_history` テーブル間の JOIN オペレーションを実行する必要があります。例えば、次のようになります。
```
SELECT
th.transaction_id,
qd.query_id,
th.status AS transaction_status
FROM
sys_query_detail qd
LEFT JOIN sys_query_history qh ON qd.query_id = qh.query_id
LEFT JOIN sys_transaction_history th on qh.transaction_id = th.transaction_id;
```
## テーブルの列
| 列名 | データ型 | 説明 |
| --- | --- | --- |
| user\_id | integer | クエリを送信したユーザーの ID。 |
| query\_id | bigint | クエリ識別子。 |
| child\_query\_sequence | integer | 書き換えられたユーザークエリのシーケンス。 |
| stream\_id | integer | クエリストリームのストリーム識別子。 |
| segment\_id | integer | クエリ実行セグメントのセグメント識別子。 |
| step\_id | integer | セグメント内のステップ識別子。 |
| step\_name | テキスト | セグメント内のステップ名。指定できる値は、aggregate、broadcast、delete、distribute、hash、hashjoin、insert、limit、merge、nestloop、parse、return、save、scan、sort、sortlimit、unique、window です。 |
| table\_id | integer | 永続テーブルスキャン時のテーブル識別子。 |
| table\_name | character(136) | 実行中のステップでのテーブル名。 |
| is\_rrscan | 文字 | ステップがスキャンステップであるかどうかを示す値。true (t) の場合は、そのステップで範囲が限定されたスキャンが実行されたことを示します。 |
| start\_time | timestamp | クエリステップが開始された時刻。このフィールドは、metrics\_level 列の値に関係なく、セグメントレベルで記録されます。 |
| end\_time | timestamp | クエリステップが完了した時刻。このフィールドは、metrics\_level 列の値に関係なく、セグメントレベルで記録されます。 |
| duration | bigint | そのステップに消費された時間 (マイクロ秒)。このフィールドは、metrics\_level 列の値に関係なく、セグメントレベルで記録されます。 |
| alert | テキスト | アラートイベントの説明。 |
| input\_bytes | bigint | 現在のステップの入力バイト数。 |
| input\_rows | bigint | 現在のステップの入力行数。 |
| output\_bytes | bigint | 現在のステップの出力バイト数。 |
| output\_rows | bigint | 現在のステップの出力行数。 |
| blocks\_read | bigint | ステップが読み込んだブロックの数。 |
| blocks\_write | bigint | ステップが書き込んだブロックの数。 |
| local\_read\_IO | bigint | ローカルディスクキャッシュから読み取られるブロック数。 |
| remote\_read\_IO | bigint | リモートから読み込んだブロックの数。 |
| ソース | テキスト | スキャンされたデータベースオブジェクトの型。この列が値を持つのは、行の step\_name 値が scan である場合のみです。 |
| data\_skewness | integer | すべてのステップ間における出力行の分布の歪み。0% から 100% までの範囲の数値です。数値が大きいほど、分布のバランスに歪みがあります。 |
| time\_skewness | integer | すべてのステップ間における実行時間分布の歪み。0% から 100% までの範囲の数値です。数値が大きいほど、分布のバランスに歪みがあります。 |
| is\_active | 文字 | ステップレベルでのクエリの状態。可能な値は、ステップがアクティブに実行中であることを示す「t」、ステップの実行が完了したことを示す「f」です。 |
| spilled\_block\_local\_disk | bigint | ローカルディスクに流出したブロックの数。 |
| spilled\_block\_remote\_disk | bigint | Amazon Simple Storage Service に流出したブロックの数。 |
| step\_attribute | character(64) | 関連のステップに関する情報が含まれます。スキャンステップに指定できる値: multi-dimensional。 |
| metrics\_level | character(64) | クエリのメトリクスレベル。可能な値は以下のとおりです。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/redshift/latest/dg/SYS_QUERY_DETAIL.html) |
| plan\_parent\_id | integer | プランノードの親ノードの識別子。親ノードは、複数の子ノードを持つことができます。例えば、merge join は、結合されたテーブルに対する複数の scan の親ノードです。 |
| plan\_node\_id | integer | クエリの 1 つ以上のステップに対応するプランノードの識別子。 |
## 使用に関する注意事項
SYS\_QUERY\_DETAIL には、ステップ、ストリーム、セグメント、子クエリのレベルでメトリクスが含まれる場合があります。metrics\_level 列を参照するだけでなく、次の表を参考にして step\_id、segment\_id、stream\_id のフィールドを参照することで、特定の行が表しているメトリクスレベルがわかります。
| メトリクスレベル | stream\_id の値 | segment\_id の値 | step\_id の値 |
| --- | --- | --- | --- |
| 子クエリ | -1 | -1 | -1 |
| ストリーム | 有効なステップ値 | -1 | -1 |
| segment | 有効なステップ値 | 有効なステップ値 | -1 |
| ステップ | 有効なステップ値 | 有効なステップ値 | 有効なステップ値 |
## サンプルクエリ
次の例では、SYS\_QUERY\_DETAIL の出力を返します。
次のクエリは、ステップ名、input\_bytes、output\_bytes、input\_rows、output\_rows を含め、ステップレベルでクエリメタデータの詳細を表示します。
```
SELECT query_id,
child_query_sequence,
stream_id,
segment_id,
step_id,
trim(step_name) AS step_name,
duration,
input_bytes,
output_bytes,
input_rows,
output_rows
FROM sys_query_detail
WHERE query_id IN (193929)
ORDER BY query_id,
stream_id,
segment_id,
step_id DESC;
```
サンプル出力。
```
query_id | child_query_sequence | stream_id | segment_id | step_id | step_name | duration | input_bytes | output_bytes | input_rows | output_rows
----------+----------------------+-----------+------------+---------+------------+-----------------+-------------+--------------+------------+-------------
193929 | 2 | 0 | 0 | 3 | hash | 37144 | 0 | 9350272 | 0 | 292196
193929 | 5 | 0 | 0 | 3 | hash | 9492 | 0 | 23360 | 0 | 1460
193929 | 1 | 0 | 0 | 3 | hash | 46809 | 0 | 9350272 | 0 | 292196
193929 | 4 | 0 | 0 | 2 | return | 7685 | 0 | 896 | 0 | 112
193929 | 1 | 0 | 0 | 2 | project | 46809 | 0 | 0 | 0 | 292196
193929 | 2 | 0 | 0 | 2 | project | 37144 | 0 | 0 | 0 | 292196
193929 | 5 | 0 | 0 | 2 | project | 9492 | 0 | 0 | 0 | 1460
193929 | 3 | 0 | 0 | 2 | return | 11033 | 0 | 14336 | 0 | 112
193929 | 2 | 0 | 0 | 1 | project | 37144 | 0 | 0 | 0 | 292196
193929 | 1 | 0 | 0 | 1 | project | 46809 | 0 | 0 | 0 | 292196
193929 | 5 | 0 | 0 | 1 | project | 9492 | 0 | 0 | 0 | 1460
193929 | 3 | 0 | 0 | 1 | aggregate | 11033 | 0 | 201488 | 0 | 14
193929 | 4 | 0 | 0 | 1 | aggregate | 7685 | 0 | 28784 | 0 | 14
193929 | 5 | 0 | 0 | 0 | scan | 9492 | 0 | 23360 | 292196 | 1460
193929 | 4 | 0 | 0 | 0 | scan | 7685 | 0 | 1344 | 112 | 112
193929 | 2 | 0 | 0 | 0 | scan | 37144 | 0 | 7304900 | 292196 | 292196
193929 | 3 | 0 | 0 | 0 | scan | 11033 | 0 | 13440 | 112 | 112
193929 | 1 | 0 | 0 | 0 | scan | 46809 | 0 | 7304900 | 292196 | 292196
193929 | 5 | 0 | 0 | -1 | | 9492 | 12288 | 0 | 0 | 0
193929 | 1 | 0 | 0 | -1 | | 46809 | 16384 | 0 | 0 | 0
193929 | 2 | 0 | 0 | -1 | | 37144 | 16384 | 0 | 0 | 0
193929 | 4 | 0 | 0 | -1 | | 7685 | 28672 | 0 | 0 | 0
193929 | 3 | 0 | 0 | -1 | | 11033 | 114688 | 0 | 0 | 0
```
データベース内のテーブルを、使用頻度の高い順に表示するには、次の例を使用します。{{sample\_data\_dev}} を独自のデータベースに置き換えます。このクエリはクラスターの作成時に開始されるクエリをカウントしますが、データウェアハウスのスペースが不足している場合はシステムビューデータが保存されないことに注意してください。
```
SELECT table_name, COUNT (DISTINCT query_id)
FROM SYS_QUERY_DETAIL
WHERE table_name LIKE 'sample_data_dev%'
GROUP BY table_name
ORDER BY COUNT(*) DESC;
+---------------------------------+-------+
| table_name | count |
+---------------------------------+-------+
| sample_data_dev.tickit.venue | 4 |
| sample_data_dev.myunload1.venue | 3 |
| sample_data_dev.tickit.listing | 1 |
| sample_data_dev.tickit.category | 1 |
| sample_data_dev.tickit.users | 1 |
| sample_data_dev.tickit.date | 1 |
| sample_data_dev.tickit.sales | 1 |
| sample_data_dev.tickit.event | 1 |
+---------------------------------+-------+
```
次の例は、単一の WLM クエリのさまざまなメトリクスレベルを示しています。
```
SELECT query_id, child_query_sequence, stream_id, segment_id, step_id, step_name, start_time, end_time, metrics_level
FROM sys_query_detail
WHERE query_id = 1553 AND step_id = -1
ORDER BY stream_id, segment_id, step_id;
query_id | child_query_sequence | stream_id | segment_id | step_id | step_name | start_time | end_time | metrics_level
----------+----------------------+-----------+------------+---------+-----------+----------------------------+----------------------------+---------------
1553 | 1 | -1 | -1 | -1 | | 2024-10-17 02:28:49.814721 | 2024-10-17 02:28:49.847838 | child query
1553 | 1 | 0 | -1 | -1 | | 2024-10-17 02:28:49.814721 | 2024-10-17 02:28:49.835609 | stream
1553 | 1 | 0 | 0 | -1 | | 2024-10-17 02:28:49.824677 | 2024-10-17 02:28:49.830372 | segment
1553 | 1 | 1 | -1 | -1 | | 2024-10-17 02:28:49.835624 | 2024-10-17 02:28:49.845773 | stream
1553 | 1 | 1 | 1 | -1 | | 2024-10-17 02:28:49.84088 | 2024-10-17 02:28:49.842388 | segment
1553 | 1 | 1 | 2 | -1 | | 2024-10-17 02:28:49.835926 | 2024-10-17 02:28:49.844396 | segment
1553 | 1 | 2 | -1 | -1 | | 2024-10-17 02:28:49.846949 | 2024-10-17 02:28:49.847838 | stream
1553 | 1 | 2 | 3 | -1 | | 2024-10-17 02:28:49.847013 | 2024-10-17 02:28:49.847485 | segment
(8 rows)
```