Amazon Redshift ne prendra plus en charge la création de nouveaux Python à UDFs partir du patch 198. UDFs Le Python existant continuera de fonctionner jusqu'au 30 juin 2026. Pour plus d’informations, consultez le [ billet de blog ](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/).
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Résolution des problèmes de chargement de données
Lorsque vous chargez des données dans des tables Amazon Redshift, vous pouvez rencontrer des erreurs provenant d’Amazon S3, des données d’entrée non valides et des erreurs de commande COPY. Les sections suivantes fournissent des informations sur l’identification et la résolution des erreurs de chargement de données.
**Topics**
+ [Résolution des problèmes liés à l’intégration des événements S3 et aux erreurs COPY JOB](s3-integration-troubleshooting.md)
+ [ServiceException Erreurs S3](s3serviceexception-error.md)
+ [Tables système pour la résolution des problèmes de chargement de données](system-tables-for-troubleshooting-data-loads.md)
+ [Erreurs de chargement de caractères multioctets](multi-byte-character-load-errors.md)
+ [Référence des erreurs de chargement](r_Load_Error_Reference.md)
# Résolution des problèmes liés à l’intégration des événements S3 et aux erreurs COPY JOB
Utilisez les informations suivantes pour résoudre les problèmes courants liés aux intégrations d’événements Amazon S3 et à COPY JOB avec Amazon Redshift.
## Échec de la création de l’intégration d’événéments S3
Si la création de l’intégration d’événements S3 a échoué, le statut de l’intégration est `Inactive`. Assurez-vous que les informations suivantes sont correctes pour votre entrepôt des données Amazon Redshift :
+ Vous avez ajouté le principal autorisé et la source d’intégration appropriés pour votre espace de noms cible dans Amazon Redshift. Consultez [Conditions préalables à la création d’une intégration d’événements S3](loading-data-copy-job.md#loading-data-copy-job-prerequisites).
+ Vous avez ajouté la bonne stratégie basée sur les ressources au compartiment Amazon S3 source. Consultez [Conditions préalables à la création d’une intégration d’événements S3](loading-data-copy-job.md#loading-data-copy-job-prerequisites).
## Vos données Amazon S3 n’apparaissent pas dans la base de données cible
Si les données d’un COPY JOB n’apparaissent pas, vérifiez les points suivants.
+ Interrogez SYS\$1COPY\$1JOB\$1DETAIL pour savoir si le fichier Amazon S3 a été chargé, s’il est en attente d’ingestion ou s’il s’agit d’une erreur. Pour plus d’informations, consultez [SYS\$1COPY\$1JOB\$1DETAIL](SYS_COPY_JOB_DETAIL.md).
+ Consultez STL\$1ERROR ou SYS\$1COPY\$1JOB\$1INFO si le fichier Amazon S3 ne s’y trouve pas ou si le temps d’attente est inattendu. Recherchez les erreurs d’identification ou tout élément indiquant que l’intégration est inactive. Pour plus d’informations, consultez [STL\$1ERROR](r_STL_ERROR.md) et [SYS\$1COPY\$1JOB\$1INFO](SYS_COPY_JOB_INFO.md).
# ServiceException Erreurs S3
Les ServiceException erreurs s3 les plus courantes sont causées par une chaîne d'informations d'identification mal formatée ou incorrecte, par le fait que votre cluster et votre compartiment se trouvent dans des AWS régions différentes et par des autorisations Amazon S3 insuffisantes.
La section fournit des informations de dépannage pour chaque type d’erreur.
## Chaîne d’informations d’identification non valide
Si votre chaîne d’informations d’identification a été incorrectement formatée, vous recevez le message d’erreur suivant :
```
ERROR: Invalid credentials. Must be of the format: credentials
'aws_access_key_id=;aws_secret_access_key=
[;token=]'
```
Vérifiez que la chaîne d’informations d’identification ne contient pas d’espaces ou de sauts de ligne, et qu’elle est placée entre guillemets simples.
## ID de clé d’accès non valide
Si votre ID de clé d’accès n’existe pas, vous recevez le message d’erreur suivant :
```
[Amazon](500310) Invalid operation: S3ServiceException:The AWS Access Key Id you provided does not exist in our records.
```
Il s’agit souvent d’une erreur de copier-coller. Vérifiez que l’ID de clé d’accès a été saisi correctement. Si vous utilisez des clés de séance temporaire, vérifiez que la valeur de `token` est définie.
## Clé d’accès secrète non valide
Si votre clé d’accès secrète est incorrecte, vous recevrez le message d’erreur suivant :
```
[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
```
Il s’agit souvent d’une erreur de copier-coller. Vérifiez que la clé d’accès secrète a été entrée correctement et qu’il s’agit de la bonne clé pour l’ID de clé d’accès.
## Le compartiment est dans une autre région
Le compartiment Amazon S3 spécifié dans la commande COPY doit se trouver dans la même AWS région que le cluster. Si votre compartiment Amazon S3 et votre cluster sont dans des régions différentes, vous recevrez une erreur similaire à celle-ci :
```
ERROR: S3ServiceException:The bucket you are attempting to access must be addressed using the specified endpoint.
```
Vous pouvez créer un compartiment Amazon S3 dans une région spécifique en sélectionnant la région lorsque vous créez le compartiment à l’aide de la console de gestion Amazon S3 ou en spécifiant un point de terminaison lorsque vous créez le compartiment à l’aide de l’API ou de la CLI Amazon S3. Pour plus d'informations, consultez [Chargement de fichiers sur Amazon S3 à utiliser avec COPY](t_uploading-data-to-S3.md).
Pour plus d’informations sur les régions Amazon S3, consultez [Accès aux compartiments](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingBucket.html#access-bucket-intro) dans le *Guide de l’utilisateur Amazon Simple Storage Service*.
Vous pouvez aussi spécifier la région à l’aide de l’option [REGION](copy-parameters-data-source-s3.md#copy-region) de la commande COPY.
## Accès refusé
Si l’utilisateur ne dispose pas d’autorisations suffisantes, vous recevez le message d’erreur suivant :
```
ERROR: S3ServiceException:Access Denied,Status 403,Error AccessDenied
```
L’une des causes possibles est que l’utilisateur identifié par les informations d’identification ne dispose pas d’un accès LIST et GET au compartiment Amazon S3. Pour d’autres causes, consultez [Résolution des erreurs d’accès refusé (403 interdit) dans Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/troubleshoot-403-errors.html) dans le *Guide de l’utilisateur d’Amazon Simple Storage Service*.
Pour plus d’informations sur la gestion de l’accès des utilisateurs aux compartiments, consultez [Identity and Access Management dans Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html) dans le *Guide de l’utilisateur d’Amazon Simple Storage Service*.
# Tables système pour la résolution des problèmes de chargement de données
Les tables système Amazon Redshift suivantes peuvent être utiles pour le dépannage des problèmes de chargement de données :
+ Interrogez [STL\$1LOAD\$1ERRORS](r_STL_LOAD_ERRORS.md) pour découvrir les erreurs qui se sont produites lors de chargements spécifiques.
+ Interrogez [STL\$1FILE\$1SCAN](r_STL_FILE_SCAN.md) pour afficher les temps de chargement de fichiers spécifiques ou pour voir si un fichier spécifique a été lu.
+ Interrogez [STL\$1S3CLIENT\$1ERROR](r_STL_S3CLIENT_ERROR.md) pour trouver les détails des erreurs rencontrées lors du transfert de données à partir d’Amazon S3.
**Pour rechercher et diagnostiquer des erreurs de chargement**
1. Créez une vue ou définissez une requête qui renvoie des informations détaillées sur les erreurs de chargement. L'exemple suivant joint la table STL\$1LOAD\$1ERRORS à la table STV\$1TBL\$1PERM pour associer la table aux noms de table réels. 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. Définissez l’option MAXERRORS de votre commande COPY avec une valeur assez grande pour permettre à la commande COPY de renvoyer des informations utiles sur vos données. Si COPY rencontre des erreurs, un message d’erreur vous dirige vers la consultation de la table STL\$1LOAD\$1ERRORS pour plus de détails.
1. Interrogez la vue LOADVIEW pour voir les détails de l’erreur. Par exemple :
```
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. Résolvez le problème dans le fichier d’entrée ou le script de chargement, en fonction des informations que la vue renvoie. Certaines erreurs de chargement classique à surveiller particulièrement :
+ Incompatibilité entre les types de données de la table et les valeurs des champs des données d’entrée.
+ Incompatibilité entre le nombre de colonnes de la table et le nombre de champs des données d’entrée.
+ Guillemets non appariés. Amazon Redshift prend en charge les guillemets simples et doubles ; toutefois, ces guillemets doivent être bien équilibrés.
+ Format incorrect pour les date/time données des fichiers d'entrée.
+ Out-of-range valeurs dans les fichiers d'entrée (pour les colonnes numériques).
+ Le nombre de valeurs distinctes pour une colonne dépasse la limite de son encodage de compression.
# Erreurs de chargement de caractères multioctets
Les colonnes avec un type de données CHAR acceptent uniquement les caractères UTF-8 codés sur un octet, jusqu’à la valeur d’octet 127, ou la valeur hexadécimale 7F, qui est également le jeu de caractères ASCII. Les colonnes VARCHAR acceptent les caractères UTF-8 multioctets, jusqu’à un maximum de quatre octets. Pour plus d’informations, consultez [Types caractères](r_Character_types.md).
Si, dans vos données de chargement, une ligne contient un caractère non valide pour le type de données de colonne, COPY renvoie une erreur et enregistre une ligne dans la table du journal système STL\$1LOAD\$1ERRORS avec le numéro d’erreur 1220. Le champ ERR\$1REASON comprend la séquence d’octets, en hexadécimal, pour le caractère non valide.
Au lieu de corriger les caractères non valides dans vos données de chargement, vous pouvez également remplacer les caractères non valides pendant le processus de chargement. Pour remplacer les caractères UTF-8 non valides, spécifiez l’option ACCEPTINVCHARS avec la commande COPY. Si l’option ACCEPTINVCHARS est définie, le caractère que vous spécifiez remplace le point de code. Si l’option ACCEPTINVCHARS n’est pas définie, Amazon Redshift accepte les caractères comme UTF-8 valides. Pour plus d'informations, consultez [ACCEPTINVCHARS](copy-parameters-data-conversion.md#acceptinvchars).
La liste de points de code suivante est composée d’UTF-8 valides. Les opérations COPY ne renvoient pas d’erreur si l’option ACCEPTINVCHARS n’est pas définie. Toutefois, ces points de code ne sont pas des caractères valides. Vous pouvez utiliser l’option [ACCEPTINVCHARS](copy-parameters-data-conversion.md#acceptinvchars) pour remplacer un point de code par un caractère que vous spécifiez. Ces points de code incluent la plage de valeurs de `0xFDD0` à `0xFDEF` et des valeurs allant jusqu’à `0x10FFFF`, se terminant par `FFFE` ou `FFFF` :
+ `0xFFFE`, `0x1FFFE`, `0x2FFFE`, …, `0xFFFFE`, `0x10FFFE`
+ `0xFFFF`, `0x1FFFF`, `0x2FFFF`, …, `0xFFFFF`, `0x10FFFF`
L’exemple suivant affiche le motif de l’erreur lorsque COPY tente de charger le caractère UTF-8 `e0 a1 c7a4` dans une colonne CHAR.
```
Multibyte character not supported for CHAR
(Hint: Try using VARCHAR). Invalid char: e0 a1 c7a4
```
Si l’erreur est liée à un type de données VARCHAR, le motif de l’erreur inclut un code d’erreur ainsi que la séquence hexadécimale UTF-8 non valide. L’exemple suivant affiche le motif de l’erreur lorsque la commande COPY tente de charger le caractère UTF-8 `a4` dans un champ VARCHAR.
```
String contains invalid or unsupported UTF-8 codepoints.
Bad UTF-8 hex sequence: a4 (error 3)
```
Le tableau suivant répertorie les descriptions et les solutions de contournement suggérées pour les erreurs de chargement VARCHAR. Si l’une de ces erreurs se produit, remplacez le caractère par une séquence de code UTF-8 valide ou supprimez le caractère.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/redshift/latest/dg/multi-byte-character-load-errors.html)
# Référence des erreurs de chargement
Si des erreurs se produisent lors du chargement des données à partir d’un fichier, interrogez la table [STL\$1LOAD\$1ERRORS](r_STL_LOAD_ERRORS.md) afin d’identifier l’erreur et de déterminer l’explication possible. La table suivante répertorie tous les codes d’erreur qui peuvent se produire au cours des chargements de données :
## Codes d’erreur de chargement
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/redshift/latest/dg/r_Load_Error_Reference.html)