Résolution des problèmes

Une fois le téléchargement des données terminé, vérifiez si des lignes ont été ignorées. Pour ce faire, accédez au répertoire source du CSV fichier source et recherchez un fichier portant le nom suivant.

import_yourcsvfilename.err.timestamp.csv

cqlsh écrit toutes les lignes de données ignorées dans un fichier portant ce nom. Si le fichier existe dans votre répertoire source et contient des données, ces lignes n'ont pas été chargées sur Amazon Keyspaces. Pour réessayer ces lignes, vérifiez d'abord si des erreurs se sont produites lors du téléchargement et ajustez les données en conséquence. Pour réessayer ces lignes, vous pouvez relancer le processus.

Erreurs courantes

Les raisons les plus courantes pour lesquelles les lignes ne sont pas chargées sont les erreurs de capacité et les erreurs d'analyse.

Erreurs de demande non valides lors du chargement de données sur Amazon Keyspaces

Dans l'exemple suivant, la table source contient une colonne de compteur, qui génère des appels par lots enregistrés à partir de la commande cqlshCOPY. Les appels groupés enregistrés ne sont pas pris en charge par Amazon Keyspaces.

Failed to import 10 rows: InvalidRequest - Error from server: code=2200 [Invalid query] message=“Only UNLOGGED Batches are supported at this time.“,  will retry later, attempt 22 of 25

Pour résoudre cette erreur, utilisez DSBulk pour migrer les données. Pour de plus amples informations, veuillez consulter Tutoriel : Chargement de données dans Amazon Keyspaces à l'aide de DSBulk.

Erreurs de l'analyseur lors du chargement de données sur Amazon Keyspaces

L'exemple suivant montre une ligne ignorée en raison d'unParseError.

Failed to import 1 rows: ParseError - Invalid ... – 

Pour résoudre cette erreur, vous devez vous assurer que les données à importer correspondent au schéma de table dans Amazon Keyspaces. Vérifiez le fichier d'importation pour détecter les erreurs d'analyse. Vous pouvez essayer d'utiliser une seule ligne de données à l'aide d'une INSERT instruction pour isoler l'erreur.

Erreurs de capacité lors du chargement de données sur Amazon Keyspaces

Failed to import 1 rows: WriteTimeout - Error from server: code=1100 [Coordinator node timed out waiting for replica nodes' responses]
 message="Operation timed out - received only 0 responses." info={'received_responses': 0, 'required_responses': 2, 'write_type': 'SIMPLE', 'consistency': 
 'LOCAL_QUORUM'}, will retry later, attempt 1 of 100

Amazon Keyspaces utilise les WriteTimeout exceptions ReadTimeout et pour indiquer lorsqu'une demande d'écriture échoue en raison d'une capacité de débit insuffisante. Pour aider à diagnostiquer les exceptions liées à une capacité insuffisante, Amazon Keyspaces publie WriteThrottleEvents des ReadThrottledEvents statistiques sur Amazon. CloudWatch Pour de plus amples informations, veuillez consulter Surveillance d'Amazon Keyspaces avec Amazon CloudWatch.

erreurs cqlsh lors du chargement de données sur Amazon Keyspaces

Pour résoudre les erreurs cqlsh, réexécutez la commande défaillante avec l'indicateur. --debug

Lorsque vous utilisez une version incompatible de cqlsh, l'erreur suivante s'affiche.

AttributeError: 'NoneType' object has no attribute 'is_up'
Failed to import 3 rows: AttributeError - 'NoneType' object has no attribute 'is_up',  given up after 1 attempts

Vérifiez que la version correcte de cqlsh est installée en exécutant la commande suivante.

cqlsh --version

Vous devriez voir quelque chose comme la sortie suivante.

cqlsh 5.0.1

Si vous utilisez Windows, remplacez toutes les instances de cqlsh parcqlsh.bat. Par exemple, pour vérifier la version de cqlsh sous Windows, exécutez la commande suivante.

cqlsh.bat --version

La connexion à Amazon Keyspaces échoue lorsque le client cqlsh a reçu trois erreurs consécutives de tout type de la part du serveur. Le client cqlsh échoue avec le message suivant.

Failed to import 1 rows: NoHostAvailable - , will retry later, attempt 3 of 100

Pour résoudre cette erreur, vous devez vous assurer que les données à importer correspondent au schéma de table dans Amazon Keyspaces. Vérifiez le fichier d'importation pour détecter les erreurs d'analyse. Vous pouvez essayer d'utiliser une seule ligne de données en utilisant une INSERT instruction pour isoler l'erreur.

Le client tente automatiquement de rétablir la connexion.