Amazon Redshift unterstützt UDFs ab Patch 198 nicht mehr die Erstellung von neuem Python. Das bestehende Python UDFs wird bis zum 30. Juni 2026 weiterhin funktionieren. Weitere Informationen finden Sie im [Blog-Posting](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/).
Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Fehlerbehebung bei Datenladevorgängen
Wenn Sie Daten in Amazon-Redshift-Tabellen laden, können Fehler von Amazon S3, ungültige Eingabedaten und COPY-Befehlsfehler auftreten. Die folgenden Abschnitte stellen Informationen zum Identifizieren und Beheben von Fehlern beim Laden von Daten bereit.
**Topics**
+ [Behebung von Fehlern für die S3-Ereignisintegration und für COPY JOB](s3-integration-troubleshooting.md)
+ [ServiceException S3-Fehler](s3serviceexception-error.md)
+ [Systemtabellen für die Behebung von Fehlern beim Laden von Daten](system-tables-for-troubleshooting-data-loads.md)
+ [Fehler beim Laden von Multibyte-Zeichen](multi-byte-character-load-errors.md)
+ [Ladefehlerreferenz](r_Load_Error_Reference.md)
# Behebung von Fehlern für die S3-Ereignisintegration und für COPY JOB
Verwenden Sie die folgenden Informationen, um häufige Probleme bei Amazon-S3-Ereignisintegrationen und COPY JOB mit Amazon Redshift zu beheben.
## Erstellung der S3-Ereignisintegration ist fehlgeschlagen
Wenn die Erstellung der S3-Ereignisintegration fehlgeschlagen ist, ist der Status der Integration `Inactive`. Stellen Sie sicher, dass Folgendes für Ihr Data Warehouse in Amazon Redshift zutrifft.
+ Sie haben den richtigen autorisierten Prinzipal und die richtige Integrationsquelle für Ihren Ziel-Namespace in Amazon Redshift hinzugefügt. Siehe [Voraussetzungen für die Erstellung einer S3-Ereignisintegration](loading-data-copy-job.md#loading-data-copy-job-prerequisites).
+ Sie haben die richtige ressourcenbasierte Richtlinie zum Quell-Bucket in Amazon S3 hinzugefügt. Siehe [Voraussetzungen für die Erstellung einer S3-Ereignisintegration](loading-data-copy-job.md#loading-data-copy-job-prerequisites).
## Ihre Amazon-S3-Daten werden nicht in der Zieldatenbank angezeigt
Wenn Daten aus einem COPY JOB nicht angezeigt werden, überprüfen Sie Folgendes.
+ Fragen Sie SYS\$1COPY\$1JOB\$1DETAIL ab, um zu sehen, ob die Amazon-S3-Datei geladen wurde, ob sie noch erfasst werden muss oder ob ein Fehler vorliegt. Weitere Informationen finden Sie unter [SYS\$1COPY\$1JOB\$1DETAIL](SYS_COPY_JOB_DETAIL.md).
+ Überprüfen Sie STL\$1ERROR oder SYS\$1COPY\$1JOB\$1INFO, wenn die Amazon-S3-Datei nicht vorhanden ist oder es unerwartete Wartezeiten gibt. Suchen Sie nach Fehlern in Anmeldeinformationen oder allem, was darauf hindeutet, dass die Integration inaktiv ist. Weitere Informationen erhalten Sie unter [STL\$1ERROR](r_STL_ERROR.md) und [SYS\$1COPY\$1JOB\$1INFO](SYS_COPY_JOB_INFO.md).
# ServiceException S3-Fehler
Die häufigsten ServiceException S3-Fehler werden durch eine falsch formatierte oder falsche Zeichenfolge für Anmeldeinformationen verursacht, wenn sich Ihr Cluster und Ihr Bucket in verschiedenen AWS Regionen befinden und die Amazon S3 S3-Berechtigungen nicht ausreichen.
In diesem Abschnitt werden Informationen zur Fehlerbehebung für die einzelnen Fehlertypen bereitgestellt.
## Ungültige Anmeldeinformationszeichenfolgen
Wenn die Anmeldeinformationszeichenfolge nicht korrekt formatiert ist, erhalten Sie die folgende Fehlermeldung:
```
ERROR: Invalid credentials. Must be of the format: credentials
'aws_access_key_id=;aws_secret_access_key=
[;token=]'
```
Überprüfen Sie, ob die Anmeldeinformationszeichenfolge keine Leerzeichen oder Zeilenumbrüche enthält und in einfachen Anführungszeichen eingeschlossen ist.
## Ungültige Zugriffsschlüssel-ID
Wenn Ihre Zugriffsschlüssel-ID nicht vorhanden ist, erhalten Sie folgende Fehlermeldung:
```
[Amazon](500310) Invalid operation: S3ServiceException:The AWS Access Key Id you provided does not exist in our records.
```
Dies geht häufig auf einen Fehler beim Kopieren und Einfügen zurück. Überprüfen Sie, ob die Zugriffsschlüssel-ID korrekt eingegeben wurde. Wenn Sie temporäre Sitzungsschlüssel verwenden, überprüfen Sie außerdem, ob der Wert für `token` festgelegt wurde.
## Ungültiger geheimer Zugriffsschlüssel
Wenn der geheime Zugriffsschlüssel falsch ist, erhalten Sie folgende Fehlermeldung:
```
[Amazon](500310) Invalid operation: S3ServiceException:The request signature we calculated does not match the signature you provided.
Check your key and signing method.,Status 403,Error SignatureDoesNotMatch
```
Dies geht häufig auf einen Fehler beim Kopieren und Einfügen zurück. Überprüfen Sie, ob der geheime Zugriffsschlüssel korrekt eingegeben wurde und ob es sich um den korrekten Schlüssel für die Zugriffsschlüssel-ID handelt.
## Bucket befindet sich in einer anderen Region
Der im COPY-Befehl angegebene Amazon S3 S3-Bucket muss sich in derselben AWS Region wie der Cluster befinden. Wenn sich Amazon-S3-Bucket und -Cluster in verschiedenen Regionen befinden, erhalten Sie eine Fehlermeldung wie die folgende:
```
ERROR: S3ServiceException:The bucket you are attempting to access must be addressed using the specified endpoint.
```
Sie können einen Amazon-S3-Bucket in einer bestimmten Region erstellen, indem Sie entweder bei der Erstellung des Buckets die Region über die Amazon-S3-Managementkonsole auswählen oder indem Sie einen Endpunkt angeben, wenn Sie den Bucket mithilfe der Amazon-S3-API oder -CLI erstellen. Weitere Informationen finden Sie unter [Hochladen von Dateien zu Amazon S3 zur Verwendung mit COPY](t_uploading-data-to-S3.md).
Weitere Informationen zu Amazon-S3-Regionen finden Sie unter [Zugriff auf einen Bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingBucket.html#access-bucket-intro) im *Benutzerhandbuch für Amazon Simple Storage Service*.
Alternativ können Sie die Region mithilfe der Option [REGION](copy-parameters-data-source-s3.md#copy-region) mit dem Befehl COPY angeben.
## Zugriff verweigert
Wenn der Benutzer keine ausreichenden Berechtigungen besitzt, erhalten Sie folgende Fehlermeldung:
```
ERROR: S3ServiceException:Access Denied,Status 403,Error AccessDenied
```
Eine mögliche Ursache dafür ist, dass der durch die Anmeldeinformationen identifizierte Benutzer nicht über LIST- und GET-Zugriff für den Amazon-S3-Bucket verfügt. Weitere mögliche Ursachen finden Sie unter [Beheben von Fehlern aufgrund einer Zugriffsverweigerung (403 Forbidden) in Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/troubleshoot-403-errors.html) im *Benutzerhandbuch zu Amazon Simple Storage Service*.
Informationen zur Verwaltung des Benutzerzugriffs auf Buckets finden Sie unter [Identity and Access Management in Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html) im *Benutzerhandbuch zu Amazon Simple Storage Service*.
# Systemtabellen für die Behebung von Fehlern beim Laden von Daten
Die folgenden Amazon-Redshift-Systemtabellen können beim Beheben von Fehlern, die beim Laden von Daten auftreten, nützlich sein:
+ Führen Sie eine Abfrage für [STL\$1LOAD\$1ERRORS](r_STL_LOAD_ERRORS.md) aus, um Fehler zu entdecken, die während spezifischer Ladevorgänge aufgetreten sind.
+ Führen Sie eine Abfrage für [STL\$1FILE\$1SCAN](r_STL_FILE_SCAN.md) aus, um die Ladezeiten für spezifische Dateien anzuzeigen oder um festzustellen, ob eine spezifische Datei überhaupt gelesen wurde.
+ Führen Sie eine Abfrage für [STL\$1S3CLIENT\$1ERROR](r_STL_S3CLIENT_ERROR.md) aus, um Details zu Fehlern zu ermitteln, die während der Übertragung von Daten aus Amazon S3 aufgetreten sind.
**So finden und diagnostizieren Sie Ladefehler**
1. Erstellen Sie eine Ansicht oder definieren Sie eine Abfrage, die Details zu Ladefehlern zurückgibt. Im folgenden Beispiel wird die Tabelle STL\$1LOAD\$1ERRORS mit der Tabelle STV\$1TBL\$1PERM verknüpft, um die Tabelle mit den tatsächlichen Tabellennamen abzugleichen. IDs
```
create view loadview as
(select distinct tbl, trim(name) as table_name, query, starttime,
trim(filename) as input, line_number, colname, err_code,
trim(err_reason) as reason
from stl_load_errors sl, stv_tbl_perm sp
where sl.tbl = sp.id);
```
1. Legen Sie die Option MAXERRORS in Ihrem COPY-Befehl auf einen Wert fest, der groß genug ist, dass COPY nützliche Informationen zu Ihren Daten zurückgeben kann. Wenn für den COPY-Befehl Fehler auftreten, weist Sie eine Fehlermeldung an, in der Tabelle STL\$1LOAD\$1ERRORS nach Details zu suchen.
1. Führen Sie eine Abfrage für die Ansicht LOADVIEW aus, um Fehlerdetails anzuzeigen. Beispiel:
```
select * from loadview where table_name='venue';
```
```
tbl | table_name | query | starttime
--------+------------+-------+----------------------------
100551 | venue | 20974 | 2013-01-29 19:05:58.365391
| input | line_number | colname | err_code | reason
+----------------+-------------+---------+----------+--------------------
| venue_pipe.txt | 1 | 0 | 1214 | Delimiter not found
```
1. Beheben Sie das Problem in der Eingabedatei oder im Ladeskript basierend auf den Informationen, die von der Ansicht zurückgegeben werden. Typische Ladefehler, auf die Sie achten sollten, sind:
+ Fehlende Übereinstimmung zwischen Datentypen in der Tabelle und Werten in den Eingabedatenfeldern.
+ Fehlende Übereinstimmung zwischen der Anzahl der Spalten in der Tabelle und der Anzahl der Felder in den Eingabedatenfeldern.
+ Nicht übereinstimmende Anführungszeichen. Amazon Redshift unterstützt sowohl einfache als auch doppelte Anführungszeichen. Diese Anführungszeichen müssen jedoch entsprechend ausgeglichen werden.
+ date/time Falsches Format für Daten in Eingabedateien.
+ Out-of-range Werte in Eingabedateien (für numerische Spalten).
+ Anzahl der unterschiedlichen Werte für eine Spalte überschreitet die Begrenzung für ihre Kompressionskodierung.
# Fehler beim Laden von Multibyte-Zeichen
Spalten mit einem CHAR-Datentyp akzeptieren nur UTF-8-Einzelbyte-Zeichen bis zum Bytewert 127 oder 7F Hex. Dies entspricht dem ASCII-Zeichensatz. VARCHAR-Spalten akzeptieren UTF-8-Multibyte-Zeichen bis zu einer Länge von vier Bytes. Weitere Informationen finden Sie unter [Zeichentypen](r_Character_types.md).
Wenn eine Zeile in den geladenen Daten ein für den Datentyp der Spalte ungültiges Zeichen enthält, gibt COPY einen Fehler zurück und protokolliert eine Zeile mit der Fehlernummer 1220 in der Systemprotokolltabelle STL\$1LOAD\$1ERRORS. Das Feld ERR\$1REASON enthält die Byte-Folge in Hex für das ungültige Zeichen.
Alternativ zur Korrektur von ungültigen Zeichen in den geladenen Daten können Sie die ungültigen Zeichen auch während des Ladeprozesses ersetzen. Um ungültige UTF-8-Zeichen zu ersetzen, geben Sie mit dem COPY-Befehl die Option ACCEPTINVCHARS an. Wenn die Option ACCEPTINVCHARS festgelegt ist, ersetzt das von Ihnen angegebene Zeichen den Codepunkt. Wenn die Option ACCEPTINVCHARS nicht festgelegt ist, akzeptiert Amazon Redshift die Zeichen als gültiges UTF-8. Weitere Informationen finden Sie unter [ACCEPTINVCHARS](copy-parameters-data-conversion.md#acceptinvchars).
Die folgende Liste von Codepunkten ist gültiges UTF-8, COPY-Operationen geben keinen Fehler zurück, wenn die ACCEPTINVCHARS-Option nicht festgelegt wurde. Diese Codepunkte sind jedoch keine gültigen Zeichen. Sie können die Option [ACCEPTINVCHARS](copy-parameters-data-conversion.md#acceptinvchars) verwenden, um einen Codepunkt durch ein von Ihnen festgelegtes Zeichen zu ersetzen. Diese Codepunkte beinhalten den Wertebereich von `0xFDD0` bis `0xFDEF` und Werte bis `0x10FFFF`, endend mit `FFFE` oder `FFFF`:
+ `0xFFFE`, `0x1FFFE`, `0x2FFFE`, …, `0xFFFFE`, `0x10FFFE`
+ `0xFFFF`, `0x1FFFF`, `0x2FFFF`, …, `0xFFFFF`, `0x10FFFF`
Im folgenden Beispiel ist der Fehlergrund angegeben, wenn COPY versucht, das UTF-8-Zeichen `e0 a1 c7a4` in eine CHAR-Spalte zu laden.
```
Multibyte character not supported for CHAR
(Hint: Try using VARCHAR). Invalid char: e0 a1 c7a4
```
Wenn sich der Fehler auf einen VARCHAR-Datentyp bezieht, beinhaltet der Fehlergrund einen Fehlercode sowie die ungültige UTF-8-Hex-Sequenz. Im folgenden Beispiel ist der Fehlergrund angegeben, wenn COPY versucht, das UTF-8-Zeichen `a4` in ein VARCHAR-Feld zu laden:
```
String contains invalid or unsupported UTF-8 codepoints.
Bad UTF-8 hex sequence: a4 (error 3)
```
In der folgenden Tabelle werden die Beschreibungen und vorgeschlagenen Umgehungen für VARCHAR-Ladefehler aufgelistet. Wenn einer dieser Fehler auftritt, ersetzen Sie das Zeichen durch eine gültige UTF-8-Codefolge oder entfernen das Zeichen.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/redshift/latest/dg/multi-byte-character-load-errors.html)
# Ladefehlerreferenz
Wenn während des Ladens von Daten aus einer Datei Fehler auftreten, führen Sie eine Abfrage für die Tabelle [STL\$1LOAD\$1ERRORS](r_STL_LOAD_ERRORS.md) aus, um den Fehler zu identifizieren und die mögliche Erklärung zu ermitteln. In der folgenden Tabelle werden alle Fehlercodes aufgelistet, die beim Laden von Daten auftreten können:
## Ladefehlercodes
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/redshift/latest/dg/r_Load_Error_Reference.html)