Troubleshooting - Amazon Keyspaces(针对 Apache Cassandra)
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

Troubleshooting

数据上载完成后,检查是否跳过了行。为此,请导航到源 CSV 文件的源目录,并搜索具有以下名称的文件。

import_yourcsvfilename.err.timestamp.csv

cqlsh 将任何跳过的数据行写入具有该名称的文件中。如果文件存在于源目录中并且其中包含数据,则这些行不会上传到 Amazon Keyspaces。要重试这些行,请首先检查在上载过程中遇到的任何错误,并相应地调整数据。要重试这些行,可以重新运行该过程。

常见错误

未加载行的最常见原因是容量错误和解析错误。

将数据上传到亚马逊 Keyspaces 时的解析器错误

下面的示例显示了由于ParseError

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

要解决此错误,您需要确保要导入的数据与 Amazon Keyspaces 中的表架构匹配。查看导入文件是否有解析错误。您可以尝试使用单行数据,使用INSERT语句来隔离错误。

将数据上传到 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 使用ReadTimeoutWriteTimeout异常,以指示写请求何时由于吞吐量不足而失败。为了帮助诊断容量不足的异常,Amazon Keyspaces 发布WriteThrottleEventsReadThrottledEventsAmazon CloudWatch。有关更多信息,请参阅使用 Amazon CloudWatch 监控 Amazon Keyspaces

将数据上传到亚马逊 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 客户端从服务器收到三个连续的任何类型的错误后,到 Amazon Keyspaces 的连接失败。cqlsh 客户端失败,并显示以下消息。

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

要解决此错误,您需要确保要导入的数据与 Amazon Keyspaces 中的表架构匹配。查看导入文件是否有解析错误。您可以尝试使用单行数据,方法是使用 INSERT 语句隔离错误。

客户端会自动尝试重新建立连接。