SYS_EXTERNAL_QUERY_DETAIL - Amazon Redshift
TabellenspaltenBeispielabfragen

Amazon Redshift unterstützt ab dem 1. November 2025 nicht mehr die Erstellung neuer Python-UDFs. Wenn Sie Python-UDFs verwenden möchten, erstellen Sie die UDFs vor diesem Datum. Bestehende Python-UDFs funktionieren weiterhin wie gewohnt. Weitere Informationen finden Sie im Blog-Posting.

SYS_EXTERNAL_QUERY_DETAIL

Verwenden Sie SYS_QUERY_DETAIL, um Details für Abfragen auf Segmentebene anzuzeigen. Jede Zeile repräsentiert ein Segment aus einer bestimmten WLM-Abfrage mit Details wie der Anzahl der verarbeiteten Zeilen, der Anzahl der verarbeiteten Bytes und Partitionsinformationen externer Tabellen in Amazon S3. Jede Zeile in dieser Ansicht hat auch einen entsprechenden Eintrag in der Ansicht SYS_QUERY_DETAIL, außer dass diese Ansicht detailliertere Informationen zur externen Abfrageverarbeitung enthält.

SYS_EXTERNAL_QUERY_DETAIL ist für alle Benutzer sichtbar. Superuser können alle Zeilen sehen; reguläre Benutzer können nur ihre eigenen Daten sehen. Weitere Informationen finden Sie unter Sichtbarkeit der Daten in Systemtabellen und Ansichten.

Tabellenspalten

Spaltenname Datentyp Beschreibung
user_id integer Die ID des Benutzers, der die Abfrage gesendet hat.
query_id bigint Die Abfrage-ID der externen Abfrage.
transaction_id bigint Die Transaktions-ID.
child_query_sequence integer Die Reihenfolge der neu geschriebenen Benutzerabfrage. Beginnt mit 0, ähnlich wie segment_id.
segment_id integer Die Segment-ID des Abfragesegments.
source_type character(32) Der Datenquellentyp der Abfrage. Es kann sich um S3 für Redshift Spectrum und PG für Verbundabfragen handeln.
start_time timestamp Der Zeitpunkt, zu dem die Abfrage begann.
end_time timestamp Der Zeitpunkt, an dem die Abfrage abgeschlossen wurde.
duration bigint Die Zeit (Mikrosekunden), die für die Abfrage aufgewendet wurde.
total_partitions integer Die Anzahl der Partitionen, die eine Amazon-S3-Abfrage benötigt hat.
qualified_partitions integer Die Anzahl der Partitionen, die eine Amazon-S3-Abfrage gescannt hat.
scanned_files bigint Die Anzahl der von Amazon S3 gescannten Dateien.
returned_rows bigint Die Anzahl der gescannten Zeilen für eine Amazon-S3-Abfrage oder die Anzahl der zurückgegebenen Zeilen für eine Verbundabfrage.
returned_bytes bigint Die Anzahl der gescannten Bytes für eine Amazon-S3-Abfrage oder die Anzahl der zurückgegebenen Bytes für eine Verbundabfrage.
file_format text Das Dateiformat von Amazon-S3-Dateien.
file_location text Der Amazon-S3-Speicherort der externen Tabelle.
external_query_text text Der Abfragetext auf Segmentebene für eine Verbundabfrage.
warning_message character(4000) Die Warnmeldung, die angezeigt wird, wenn die Abfrage ausgeführt wird.
table_name character(136) Der Tabellenname des Schritts, der ausgeführt wird.
is_recursive character(1) Zeigt an, ob ein rekursiver Scan für Unterordner vorhanden ist.
is_nested character(1) Zeigt an, ob auf den Datentyp der verschachtelten Spalte zugegriffen wird.
s3list_time bigint Die Dauer der Dateiauflistung in Millisekunden.
get_partition_time long Zeit für das Auflisten und Qualifizieren von Partitionen für ein bestimmtes externes Objekt aus AWS Glue Data Catalog und Apache Hive.

Beispielabfragen

Die folgende Abfrage zeigt die Details der externen Abfrage.

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;

Beispielausgabe.

 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 |            |