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

Verwenden Sie SYS_LOAD_ERROR_DETAIL, um Details zu Fehlern bei COPY-Befehlen anzuzeigen. Jede Zeile repräsentiert einen COPY-Befehl. Sie enthält sowohl ausgeführte als auch abgeschlossene COPY-Befehle.

SYS_LOAD_ERROR_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 Kopie gesendet hat.
query_id bigint Die Abfrage-ID der Kopie.
transaction_id bigint Die Transaktions-ID.
session_id integer Die ID des Prozesses, der die Kopie ausführt.
database_name character(64) Der Name der Datenbank, mit der der Benutzer verbunden war, als die Kopie ausgegeben wurde.
table_id integer Die Tabellenkennung.
start_time timestamp Die Uhrzeit (in UTC), zu der die Kopie begann.
file_name character(256) Der vollständige Pfad zur zu ladenden Eingabedatei.
line_number bigint Die Zeilennummer in der Ladedatei mit dem Fehler. Beim Laden einer JSON-Datei ist dies die Nummer der letzten Zeile des JSON-Objekts mit dem Fehler.
column_name character(127) Das Feld mit dem Fehler.
column_type character(10) Der Datentyp des Felds mit dem Fehler.
column_length character(10) Die Spaltenlänge, falls zutreffend. Dieses Feld ist gefüllt, wenn für den Datentyp eine Längenbegrenzung gilt. So enthält diese Spalte beispielsweise für eine Spalte mit dem Datentyp „character(3)“ den Wert „3“.
position integer Die Position des Fehlers in dem Feld.
error_code integer Der Fehlercode.
error_message character(512) Die Erläuterung des Fehlers.

Beispielabfragen

Die folgende Abfrage zeigt die Ladefehlerdetails des copy-Befehls für eine bestimmte Abfrage.

SELECT query_id,
       table_id,
       start_time,
       trim(file_name) AS file_name, 
       trim(column_name) AS column_name, 
       trim(column_type) AS column_type, 
       trim(error_message) AS error_message 
FROM sys_load_error_detail 
WHERE query_id = 762949 
ORDER BY start_time 
LIMIT 10;

Beispielausgabe.

 query_id | table_id |         start_time         |               file_name                  | column_name | column_type |                 error_message
----------+----------+----------------------------+------------------------------------------+-------------+-------------+------------------------------------------------
   762949 |   137885 | 2022-02-15 22:14:46.759151 | s3://load-test/copyfail/wrong_format_000 | id          | int4        | Invalid digit, Value 'a', Pos 0, Type: Integer
   762949 |   137885 | 2022-02-15 22:14:46.759151 | s3://load-test/copyfail/wrong_format_001 | id          | int4        | Invalid digit, Value 'a', Pos 0, Type: Integer