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\_EXTERNAL\_QUERY\_DETAIL
SYS\_EXTERNAL\_QUERY\_DETAIL は、クエリの詳細をセグメントレベルで表示します。それぞれの行が、特定の WLM クエリの各セグメントと対応します。この情報には、処理された行数、処理されたバイト数、Amazon S3 の外部テーブルのパーティション情報などの詳細が含まれます。同時にこのビューの各行には、SYS\_QUERY\_DETAIL ビューと対応するエントリも表示されます。ただし、このビューの場合に、は外部クエリ処理に関連する詳細情報が含まれます。
SYS\_EXTERNAL\_QUERY\_DETAIL はすべてのユーザーが表示可能です。スーパーユーザーはすべての行を表示できますが、通常のユーザーは自分のデータのみを表示できます。詳細については、「[システムテーブルとビューのデータの可視性](cm_chap_system-tables.md#c_visibility-of-data)」を参照してください。
## テーブルの列
| 列名 | データ型 | 説明 |
| --- | --- | --- |
| user\_id | integer | クエリを送信したユーザーの ID。 |
| query\_id | bigint | 外部クエリのクエリ識別子。 |
| transaction\_id | bigint | トランザクション識別子。 |
| child\_query\_sequence | integer | 書き換えられたユーザークエリーのシーケンス。segment\_id と同様に 0 で開始されます。 |
| segment\_id | integer | クエリセグメントのセグメント ID。 |
| source\_type | character(32) | クエリのデータソースタイプ (Redshift Spectrum の場合は S3、横串検索の場合は PG)。 |
| start\_time | timestamp | クエリが開始された時刻。 |
| end\_time | timestamp | クエリが完了した時刻。 |
| duration | bigint | クエリが消費した時間 (マイクロ秒)。 |
| total\_partitions | integer | Amazon S3 でのクエリに必要なパーティションの数。 |
| qualified\_partitions | integer | Amazon S3 のクエリがスキャンしたパーティションの数。 |
| scanned\_files | bigint | スキャンされた Amazon S3 ファイルの数。 |
| returned\_rows | bigint | Amazon S3 クエリでスキャンされた行数、または横串検索で返された行数。 |
| returned\_bytes | bigint | Amazon S3 クエリでスキャンされたバイト数、または横串検索で返されたバイト数。 |
| file\_format | テキスト | Amazon S3 ファイルのファイル形式。 |
| file\_location | テキスト | 外部テーブル用の Amazon S3 の場所。 |
| external\_query\_text | テキスト | 横串検索でのセグメントレベルのクエリテキスト。 |
| warning\_message | character(4000) | クエリの実行時に表示される警告メッセージ。 |
| table\_name | character(136) | 実行中のステップでのテーブル名。 |
| is\_recursive | character(1) | サブフォルダの再帰的スキャンがあるかどうかを示します。 |
| is\_nested | character(1) | ネストされた列データ型にアクセスするかどうかを示します。 |
| s3list\_time | bigint | ファイルをリストする期間 (ミリ秒単位)。 |
| get\_partition\_time | long | AWS Glue Data Catalog と Apache Hive の特定の外部オブジェクトのパーティションを一覧表示して絞り込むのにかかった時間。 |
## サンプルクエリ
次のクエリは、外部クエリの詳細を表示します。
```
SELECT query_id,
segment_id,
start_time,
end_time,
total_partitions,
qualified_partitions,
scanned_files,
returned_rows,
returned_bytes,
trim(external_query_text) query_text,
trim(file_location) file_location
FROM sys_external_query_detail
ORDER BY query_id, start_time DESC
LIMIT 2;
```
サンプル出力。
```
query_id | segment_id | start_time | end_time | total_partitions | qualified_partitions | scanned_files | returned_rows | returned_bytes | query_text | file_location
----------+------------+----------------------------+----------------------------+------------------+----------------------+---------------+---------------+----------------+------------+---------------
763251 | 0 | 2022-02-15 22:32:23.312448 | 2022-02-15 22:32:24.036023 | 3 | 3 | 3 | 38203 | 2683414 | |
763254 | 0 | 2022-02-15 22:32:40.17103 | 2022-02-15 22:32:40.839313 | 3 | 3 | 3 | 38203 | 2683414 | |
```