トラブルシューティング - Amazon Keyspaces (Apache Cassandra 向け)

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

トラブルシューティング

データのアップロードが完了したら、行がスキップされたかどうかを確認します。これを行うには、ソースCSVファイルのソースディレクトリに移動し、次の名前のファイルを検索します。

import_yourcsvfilename.err.timestamp.csv

cqlsh により、この名前のファイルに、スキップされたデータ行が書き込まれます。ファイルがソースディレクトリに存在し、その中にデータが含まれている場合、これらの行は Amazon Keyspaces にアップロードされませんでした。これらの行のアップロードを再試行するには、まずアップロード中に発生したエラーを確認し、それに応じてデータを調整します。これらの行のアップロードを再試行するために、プロセスを再実行します。

一般的なエラー

行がロードされない最も一般的な理由は、容量エラーとパーサーエラーです。

Amazon Keyspaces にデータをアップロードする際の不正なリクエストエラー

次の例では、ソーステーブルにカウンター列が含まれているため、COPY cqlshコマンドからのバッチ呼び出しがログに記録されます。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

このエラーDSBulkを解決するには、 を使用してデータを移行します。詳細については、「チュートリアル: を使用して Amazon Keyspaces にデータをロードする DSBulk」を参照してください。

Amazon Keyspaces にデータをアップロードする際のパーサーエラー

次の例では、ParseError が原因で行がスキップされます。

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

このエラーを解決するには、インポートするデータが Amazon Keyspaces のテーブルスキーマと一致していることを確認する必要があります。インポートファイルで解析エラーが発生していないか確認してください。INSERT ステートメントを使用してエラーを切り離すことで、1 行のデータの使用を試すことができます。

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 では、スループットキャパシティ不足により書き込みリクエストが失敗した場合に、ReadTimeout 例外と WriteTimeout 例外を使用してその失敗が示されます。容量不足の例外を診断しやすくするために、Amazon Keyspaces は Amazon で WriteThrottleEventsおよび ReadThrottledEventsメトリクスを発行します CloudWatch。詳細については、「アマゾンによるアマゾンKeyspaces モニタリング CloudWatch」を参照してください。

Amazon Keyspaces にデータをアップロードする際の cqlsh エラー

cqlsh エラーのトラブルシューティングに役立てるために、失敗したコマンドに --debug フラグを付けて再実行します。

互換性のないバージョンの cqlsh を使用すると、次のエラーが表示されます。

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

次のコマンドを実行して、正しいバージョンの cqlsh がインストールされていることを確認します。

cqlsh --version

出力に関して次のような内容が表示されます。

cqlsh 5.0.1

Windows を使用している場合は、cqlsh のすべてのインスタンスを cqlsh.bat に置き換えます。例えば、Windows で cqlsh のバージョンを確認するには、次のコマンドを実行します。

cqlsh.bat --version

サーバーから cqlsh クライアントに何らかの種類のエラーが 3 回連続で送信されると、Amazon Keyspaces への接続が失敗します。cqlsh クライアントで処理が失敗すると、次のメッセージが表示されます。

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

このエラーを解決するには、インポートするデータが Amazon Keyspaces のテーブルスキーマと一致していることを確認する必要があります。インポートファイルで解析エラーが発生していないか確認してください。INSERT ステートメントを使用してエラーを分離することで、1 行のデータを使用してみてください。

クライアントにより接続の再確立が自動的に試行されます。