STL_UNLOAD_LOG - Amazon Redshift

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.

STL_UNLOAD_LOG

Zeichnet die Details für eine Entladeoperation auf.

STL_UNLOAD_LOG zeichnet für jede von einer UNLOAD-Anweisung erstellte Datei eine Zeile auf. Zum Beispiel: Wenn ein UNLOAD-Vorgang 12 Dateien erstellt, enthält STL_UNLOAD_LOG 12 entsprechende Zeilen.

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

Anmerkung

STL_UNLOAD_LOG enthält nur Abfragen, die auf bereitgestellten Haupt-Clustern ausgeführt werden. Abfragen, die auf Parallelitätsskalierungs-Clustern oder in Serverless-Namespaces ausgeführt werden, sind nicht enthalten. Um auf Erklärpläne zuzugreifen, die sowohl auf Haupt-Clustern als auch auf Parallelitätsskalierungs-Clustern und in Serverless-Namespaces ausgeführt werden, empfehlen wir, die SYS-Überwachungsansicht SYS_UNLOAD_HISTORY und SYS_UNLOAD_DETAIL zu verwenden. Die Daten in der SYS-Überwachungsansicht sind so formatiert, dass sie leichter verwendbar und besser verständlich sind.

Tabellenspalten

Spaltenname Datentyp Beschreibung
userid integer ID des Benutzers, der den Eintrag generiert hat.
query integer Die Abfrage-ID.
slice integer Die Nummer, die das Slice angibt, in dem die Abfrage ausgeführt wurde.
pid integer Die mit der Abfrageanweisung verbundene Prozess-ID.
path (Pfad) character(1280) Der vollständige Amazon-S3-Objektpfad für die Datei.
start_time timestamp Anfangszeit der Transaktion.
end_time timestamp Endzeit der Transaktion.
line_count bigint Anzahl der in die Datei entladenen Zeilen.
transfer_size bigint Anzahl der übertragenen Bytes.
file_format character(10) Format der entladenen Datei.

Beispielabfrage

Um eine Liste der Dateien zu erhalten, die durch einen UNLOAD-Befehl in Amazon S3 geschrieben wurden, rufen Sie nach Abschluss des UNLOAD-Befehls eine Amazon-S3-Listenoperation auf. Sie können auch STL_UNLOAD_LOG abfragen.

Die folgende Abfrage gibt den Pfadnamen für Dateien aus, die durch einen UNLOAD-Befehl für die zuletzt ausgeführte Abfrage erstellt wurden:

select query, substring(path,0,40) as path from stl_unload_log where query = pg_last_query_id() order by path;

Dieser Befehl gibt die folgende Beispielausgabe aus:

query | path -------+-------------------------------------- 2320 | s3://amzn-s3-demo-bucket/venue0000_part_00 2320 | s3://amzn-s3-demo-bucket/venue0001_part_00 2320 | s3://amzn-s3-demo-bucket/venue0002_part_00 2320 | s3://amzn-s3-demo-bucket/venue0003_part_00 (4 rows)