SVL_S3QUERY - Amazon Redshift
テーブルの列サンプルクエリ

Amazon Redshift は、2025 年 11 月 1 日以降、新しい Python UDF の作成をサポートしなくなります。Python UDF を使用する場合は、その日付より前に UDF を作成してください。既存の Python UDF は引き続き通常どおり機能します。詳細については、ブログ記事を参照してください。

SVL_S3QUERY

SVL_S3QUERY ビューを使用して、セグメントおよびノードスライスレベルで Amazon Redshift Spectrum クエリの詳細を確認します。

SVL_S3QUERY はすべてのユーザーに表示されます。スーパーユーザーはすべての行を表示できますが、通常のユーザーは自分のデータのみを表示できます。詳細については、「システムテーブルとビューのデータの可視性」を参照してください。

注記

SVL_S3QUERY には、メインのプロビジョニング済みクラスターで実行されるクエリのみが含まれます。同時実行スケーリングクラスターやサーバーレス名前空間で実行されるクエリは含まれていません。メインクラスターと、同時実行スケーリングクラスターやサーバーレス名前空間の両方で実行されるクエリの説明プランにアクセスするには、SYS モニタリングビュー SYS_EXTERNAL_QUERY_DETAIL を使用することをお勧めします。SYS モニタリングビューのデータは、使いやすく理解しやすいようにフォーマットされます。

テーブルの列

列名 データ型 説明
userid integer 指定のエントリを生成したユーザーの ID。
query integer クエリ ID。
segment integer セグメント番号。複数のセグメントから構成された 1 つのクエリ。各セグメントは 1 つ以上のステップから構成されます。
step integer 実行したクエリステップ。
node integer ノード番号。
slice integer 特定のセグメントが実行されたデータスライス。
starttime timestamp クエリの実行が開始された時間 (UTC)。
endtime timestamp クエリの実行が完了した時間 (UTC)。
elapsed integer 経過時間 (マイクロ秒)。
external_table_name char(136) s3 スキャンステップの外部テーブル名の内部形式。
is_partitioned char(1) true (t) の場合、この列の値は外部テーブルがパーティション化されていることを示します。
is_rrscan char(1) true (t) の場合、この列の値は範囲限定スキャンが適用されたことを示します。
s3_scanned_rows bigint Amazon S3 からスキャンされ、Redshift Spectrum レイヤーに送信された行数。
s3_scanned_bytes bigint Amazon S3 からスキャンされ、Redshift Spectrum レイヤーに送信されたバイト数。
s3query_returned_rows bigint Redshift Spectrum レイヤーからクラスターに返された行数。
s3query_returned_bytes bigint Redshift Spectrum レイヤーからクラスターに返されたバイト数。
files integer このスライスのこの S3 で処理されたファイルの数。
splits int このスライスで処理された分割の数。例えば分割可能なデータファイルの容量が大きい場合 (約 512 MB を超えるデータファイルなど)、Redshift Spectrum はファイルを複数の S3 リクエストに分割し、並列処理を試みます。
total_split_size bigint このスライスで処理された分割の合計サイズ (単位: バイト)。
max_split_size bigint このスライスで処理された分割の最大サイズ (単位: バイト)。
total_retries integer 処理されたファイルの再試行の総数。
max_retries integer 個別の処理ファイルの再試行の最大数。
max_request_duration integer Redshift Spectrum の個別リクエストの最長時間 (マイクロ秒)。
avg_request_duration double precision Redshift Spectrum リクエストの平均時間 (マイクロ秒)。
max_request_parallelism integer この S3 スキャンステップのこのスライス上で未処理の Redshift Spectrum の最大数。
avg_request_parallelism double precision この S3 スキャンステップのこのスライス上の並列 Redshift Spectrum リクエストの平均数。

サンプルクエリ

以下の例は、最後に完了されたクエリに関するスキャンステップの詳細を取得します。

select query, segment, slice, elapsed, s3_scanned_rows, s3_scanned_bytes, s3query_returned_rows, s3query_returned_bytes, files 
from svl_s3query 
where query = pg_last_query_id() 
order by query,segment,slice;
query | segment | slice | elapsed | s3_scanned_rows | s3_scanned_bytes | s3query_returned_rows | s3query_returned_bytes | files
------+---------+-------+---------+-----------------+------------------+-----------------------+------------------------+------
 4587 |       2 |     0 |   67811 |               0 |                0 |                     0 |                      0 |     0
 4587 |       2 |     1 |  591568 |          172462 |         11260097 |                  8513 |                 170260 |     1
 4587 |       2 |     2 |  216849 |               0 |                0 |                     0 |                      0 |     0
 4587 |       2 |     3 |  216671 |               0 |                0 |                     0 |                      0 |     0