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/)を参照してください。
# SVL\_S3QUERY\_SUMMARY
SVL\_S3QUERY\_SUMMARY ビューを使用して、システムで実行されたすべてのデータレイククエリ概要を取得します。SVL\_S3QUERY\_SUMMARY は、SVL\_S3QUERY の詳細をセグメントレベルで集計します。
SVL\_S3QUERY\_SUMMARY はすべてのユーザーに表示されます。スーパーユーザーはすべての行を表示できますが、通常のユーザーは自分のデータのみを表示できます。詳細については、「[システムテーブルとビューのデータの可視性](cm_chap_system-tables.md#c_visibility-of-data)」を参照してください。
このテーブルの一部またはすべてのデータは、SYS モニタリングビュー [SYS\_EXTERNAL\_QUERY\_DETAIL](SYS_EXTERNAL_QUERY_DETAIL.md) でも確認できます。SYS モニタリングビューのデータは、使いやすく理解しやすいようにフォーマットされます。クエリには、SYS モニタリングビューを使用することをお勧めします。
SVCS\_S3QUERY\_SUMMARY については、「[SVCS\_S3QUERY\_SUMMARY](r_SVCS_S3QUERY_SUMMARY.md)」を参照してください。
## テーブルの列
| 列名 | データ型 | 説明 |
| --- | --- | --- |
| userid | integer | 指定のエントリを生成したユーザーの ID。 |
| query | integer | クエリ ID。この値を使用して、他の各種システムテーブルおよびビューを結合できます。 |
| xid | bigint | トランザクション ID。 |
| pid | integer | プロセス ID。 |
| segment | integer | セグメント番号。複数のセグメントから構成された 1 つのクエリ。各セグメントは 1 つ以上のステップから構成されます。 |
| step | integer | 実行したクエリステップ。 |
| starttime | timestamp | クエリの実行が開始された時間 (UTC)。 |
| endtime | timestamp | クエリの完了した時間 (UTC)。 |
| elapsed | integer | クエリの実行にかかった時間の長さ (マイクロ秒)。 |
| aborted | integer | クエリがシステムによって停止されたかユーザーによってキャンセルされた場合、この列は 1 になります。クエリが最後まで実行された場合、この列は 0 になります。 |
| external\_table\_name | char(136) | 外部テーブルスキャンのテーブルの外部名の内部形式。 |
| file\_format | character(16) | 外部テーブルデータのファイル形式。 |
| is\_partitioned | char(1) | true (t) の場合、この列の値は外部テーブルがパーティション化されていることを示します。 |
| is\_rrscan | char(1) | true (t) の場合、この列の値は範囲限定スキャンが適用されたことを示します。 |
| is\_nested | char(1) | true (t) の場合、この列の値は、ネストされた列のデータ型にアクセスされていることを示します。 |
| s3\_scanned\_rows | bigint | Amazon S3 からスキャンされ、Redshift Spectrum レイヤーに送信された行数。RG でプロビジョニングされたクラスターでは、これは、フィルターのプッシュダウン前に、クラスターのネイティブリーダーがすべてのスライスで Amazon S3 から直接スキャンした行の合計数です。 |
| s3\_scanned\_bytes | bigint | Amazon S3 からスキャンされ Redshift Spectrum レイヤーに送信されたバイト数 (圧縮データに基づく)。RG でプロビジョニングされたクラスターでは、これは、フィルターのプッシュダウン前に、クラスターのネイティブリーダーがすべてのスライスで Amazon S3 から直接スキャンしたバイトの合計数です。 |
| s3query\_returned\_rows | bigint | Redshift Spectrum レイヤーからクラスターに返された行数。RG でプロビジョニングされたクラスターでは、これは、フィルターのプッシュダウン後に、すべてのスライスでクラスターのネイティブリーダーによって返された行の合計数です。 |
| s3query\_returned\_bytes | bigint | Redshift Spectrum レイヤーからクラスターに返されたバイト数。Amazon Redshift に大量のデータが返されると、システムパフォーマンスに影響が及ぶ可能性があります。RG でプロビジョニングされたクラスターでは、これは、フィルターのプッシュダウン後に、すべてのスライスでクラスターのネイティブリーダーによって返されたバイトの合計数です。 |
| files | integer | このデータレイククエリで処理されたファイル数。ファイル数が少ないと、並列処理の利点は制限されます。 |
| files\_max | integer | 1 つのスライスで処理されるファイルの最大数。 |
| files\_avg | integer | 1 つのスライスで処理されるファイルの平均数。 |
| splits | int | このセグメントで処理された分割の数。このスライスで処理された分割の数。例えば分割可能なデータファイルの容量が大きい場合 (約 512 MB を超えるデータファイルなど)、Redshift Spectrum はファイルを複数の S3 リクエストに分割し、並列処理を試みます。 |
| splits\_max | int | このスライスで処理された分割の最大数。 |
| splits\_avg | int | このスライスで処理された分割の平均数。 |
| total\_split\_size | bigint | 処理されたすべての分割の合計サイズ。 |
| max\_split\_size | bigint | 処理された分割の最大サイズ (単位: バイト)。 |
| avg\_split\_size | bigint | 処理された分割の平均サイズ (単位: バイト)。 |
| total\_retries | integer | 個別の処理ファイルでの再試行の総数。RG ノードタイプのクラスターでは、この列は廃止され、-1 が含まれます。RG での Amazon S3 クライアントの再試行については、「STL\_S3CLIENT」を参照してください。 |
| max\_retries | integer | 処理ファイルでの再試行の最大数。RG ノードタイプのクラスターでは、この列は廃止され、-1 が含まれます。RG での Amazon S3 クライアントの再試行については、「STL\_S3CLIENT」を参照してください。 |
| max\_request\_duration | integer | 個別ファイルリクエストの最長時間 (マイクロ秒)。実行時間の長いクエリはボトルネックの可能性があります。RG ノードタイプのクラスターでは、この列は廃止され、-1 が含まれます。 |
| avg\_request\_duration | double precision | ファイルリクエストの平均時間 (マイクロ秒)。RG ノードタイプのクラスターでは、この列は廃止され、-1 が含まれます。 |
| max\_request\_parallelism | integer | Redshift Spectrum クエリでの 1 つのスライスの並列リクエストの最大数。RG ノードタイプのクラスターでは、この列は廃止され、-1 が含まれます。 |
| avg\_request\_parallelism | double precision | Redshift Spectrum クエリでの 1 つのスライスの並列リクエストの平均数。RG ノードタイプのクラスターでは、この列は廃止され、-1 が含まれます。 |
| total\_slowdown\_count | bigint | 外部テーブルスキャン中に発生したスローダウンエラーを含む Amazon S3 リクエストの合計数。RG ノードタイプのクラスターでは、この列は廃止され、-1 が含まれます。 |
| max\_slowdown\_count | integer | 外部テーブルスキャン中に 1 つのスライスで発生したスローダウンエラーを含む Amazon S3 リクエストの最大数。RG ノードタイプのクラスターでは、この列は廃止され、-1 が含まれます。 |
## サンプルクエリ
以下の例は、最後に完了されたクエリに関するスキャンステップの詳細を取得します。
```
select query, segment, elapsed, s3_scanned_rows, s3_scanned_bytes, s3query_returned_rows, s3query_returned_bytes, files
from svl_s3query_summary
where query = pg_last_query_id()
order by query,segment;
```
```
query | segment | elapsed | s3_scanned_rows | s3_scanned_bytes | s3query_returned_rows | s3query_returned_bytes | files
------+---------+---------+-----------------+------------------+-----------------------+------------------------+------
4587 | 2 | 67811 | 0 | 0 | 0 | 0 | 0
4587 | 2 | 591568 | 172462 | 11260097 | 8513 | 170260 | 1
4587 | 2 | 216849 | 0 | 0 | 0 | 0 | 0
4587 | 2 | 216671 | 0 | 0 | 0 | 0 | 0
```