SYS_EXTERNAL_QUERY_DETAIL - Amazon Redshift

SYS_EXTERNAL_QUERY_DETAIL

SYS_EXTERNAL_QUERY_DETAIL は、クエリの詳細をセグメントレベルで表示します。それぞれの行が、特定の WLM クエリの各セグメントと対応します。この情報には、処理された行数、処理されたバイト数、Amazon S3 の外部テーブルのパーティション情報などの詳細が含まれます。同時にこのビューの各行には、SYS_QUERY_DETAIL ビューと対応するエントリも表示されます。ただし、このビューの場合に、は外部クエリ処理に関連する詳細情報が含まれます。

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

テーブルの列

列名 データ型 説明
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 text Amazon S3 ファイルのファイル形式。
file_location text 外部テーブル用の Amazon S3 の場所。
external_query_text 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 | |