数据来源故障排除

本节可以帮助您解决配置和使用 Amazon Kendra 数据源连接器时的常见问题。

我的文档没有编入索引

将 Amazon Kendra 索引与数据源同步时，可能会遇到导致无法对文档编制索引的问题。编制索引包括两个步骤。首先，检查数据来源中是否有要编制索引的新文档和更新文档，并查找要从索引中移除的文档。其次，确保可在文档级别访问每个文档和编制索引。

这两个步骤中都可能出现错误。数据来源级别的错误将在控制台的数据来源详细信息页面的同步运行历史记录部分报告。同步作业的状态可能是成功、未完成或失败。您还可以看到在作业执行期间已编制索引和删除的文档数量。如果状态为失败，则详细信息列中会显示一条消息。

中报告了文档级别的错误 Amazon CloudWatch Logs。您可以使用 CloudWatch 控制台查看错误。

要生成文档同步状态报告，请参阅我要为文档生成同步状态报告。

我的同步作业失败了

当索引或数据来源中出现配置错误时，同步作业通常会失败。在控制台中，您可以在数据来源详细信息页面的同步运行历史记录部分的详细信息列下找到错误消息。文档级别的错误在 Amazon CloudWatch Logs中报告。错误消息会提供有关问题的信息。问题通常是索引或数据源没有适当的 IAM 权限。错误消息会描述缺少的权限。以下是您可能会收到的一些错误消息：

Failed to create log group for job. Please make sure that the IAM role provided has sufficient permissions.

如果您的索引角色没有使用权限 CloudWatch，则数据源将无法创建 CloudWatch 日志。如果出现此错误，则必须为索引角色添加 CloudWatch 权限。

Failed to access Amazon S3 file prefix (bucket name) while trying to crawl your metadata files. Please make sure the IAM role (ARN) provided has sufficient permissions.

使用 Amazon S3 数据源时， Amazon Kendra 必须具有访问包含文档的存储桶的权限。您需要向数据源 IAM 角色添加读取存储桶的权限。 Amazon Kendra

The provided IAM role (ARN) could not be assumed. Please make sure Amazon Kendra is a trusted entity that is allowed to assume the role.

Amazon Kendra 需要权限才能担任索引和数据源 IAM 角色。您需要向具有 sts:AssumeRole 操作的权限的角色添加信任策略。

有关 Amazon Kendra 需要为数据源编制索引的 IAM 策略，请参阅IAM 角色。

要生成文档同步状态报告，请参阅我要为文档生成同步状态报告。

我的同步任务未完成

通常，如果完成了数据来源级别的流程，但在文档级别的处理过程中出现了一些错误，则不会完成作业。如果作业未完成，则某些文档可能无法成功编制索引。对于 Amazon S3 数据来源，作业未完成通常是由以下原因造成的：

• 一个或多个文档的元数据无效。

• 当提交文档以编制索引时，至少有一个文档未提交。

• 当提交要从索引中删除的文档时，至少有一个文档未提交。

要对未完成的同步作业进行故障排除，请先查看您的 CloudWatch 日志。

1. 在详细信息列中，选择查看详细信息 CloudWatch。

2. 查看错误消息，以便了解导致文档失败的原因。

要生成文档同步状态报告，请参阅我要为文档生成同步状态报告。

我的同步作业执行成功了，但没有编制了索引的文档

有时，运行的索引同步作业会被标记为成功，但没有按预期为新文档或更新的文档编制索引。可能的原因包括：

• 检查 CloudWatch DocumentsSubmittedForIndexingFailed指标以查看是否有任何文档无法同步。请查看您的 CloudWatch 日志以了解详细信息。

• 对于 Amazon S3 数据源，您可能给出了错误 Amazon Kendra 的存储桶名称或前缀。确保 Amazon Kendra 正在使用的存储桶是包含要索引的文档的存储桶。

• 在为之前的作业中未能编制索引的文档重新编制索引时，除非您更改了该文档或与其关联的元数据文件，否则 Amazon Kendra 不会为其编制索引。

要生成文档同步状态报告，请参阅我要为文档生成同步状态报告。

我在同步数据来源时遇到了文件格式问题

如果您在向数据来源添加文件或同步数据来源时遇到文件格式问题，请确保 Amazon Kendra 支持您的文档类型。有关支持的文档类型的列表， Amazon Kendra 请参阅文档类型或格式。

如果您将 BatchPutDocument API 用于纯文本文件，请将 PLAIN_TEXT 指定为内容类型。

我要为文档生成同步历史记录报告

同步 Amazon Kendra 数据源连接器时， Amazon Kendra 可以为数据源中的每个文档生成同步状态报告并将其复制到 Amazon S3 存储桶。在此过程中，您的数据将使用 AWS KMS 密钥进行加密，并且只能由您查看。报告的文档状态包括：失败、已完成或成功但有错误。

您必须先执行以下操作，然后才能生成同步状态报告：

• 将以下 Amazon Kendra 服务主体添加到您的 Amazon S3 访问策略中

  {
      “Version”: “2012-10-17",
      “Statement”: [
          {
              “Sid”: “KendraS3Access”,
              “Effect”: “Allow”,
              “Principal”: {
                  “Service”: “kendra.amazonaws.com”
              },
              “Action”: “s3:PutObject”,
              “Resource”: “arn:aws:s3:::your-manifest-bucket-name/*”
          }
      ]
  }

• 创建具有访问权限的 Amazon S3 存储桶 Amazon Kendra

如果您使用控制台，要生成同步状态报告，请从数据来源详细信息页面进行选择以激活同步历史记录生成选项。然后，输入 Amazon S3 存储桶位置并从可用的配置选项中进行选择。激活报告的生成后，下次同步时即可生成报告。

如果您删除 Amazon S3 存储桶，您将丢失日志数据，并且必须设置新的存储桶来存储新的同步报告。

目前只有 Amazon S3 连接器支持生成同步报告状态。

同步数据来源需要多长时间？

如果文档没有更新，则 Amazon Kendra 索引的同步时间与文档数量成线性增加。例如，1,000 个没有任何更新的文档大约需要五分钟完成同步，而 2,000 份没有任何更新的文档则大约需要 10 分钟。如果文档有更新，则同步时间将根据更新的文档数量而增加。

同步数据来源的费用是多少？

同步索引时，需要两分钟的时间进行预热和激活 Amazon EC2 以建立必要的连接。在此过程中，您无需支付任何费用。在同步作业开始后，您的使用量表才会启动。有关 Amazon Kendra 定价的更多信息，请参阅Amazon Kendra 定价。

我收到 Amazon EC2 授权错误

如果在虚拟私有云 (VPC) 数据源的同步过程中出现 Amazon EC2 未经授权的操作错误，则可能是您的 VPC IAM 角色缺少所需的权限。请检查您用于数据源的 IAM 角色是否具有附加权限。有关更多信息，请参阅虚拟私有云 IAM 角色。

我无法使用搜索索引链接来打开我的 Amazon S3 对象

您的 Amazon Kendra 索引只能访问 Amazon S3 数据源授予其访问权限的文件。例如， Amazon Kendra 无法修改决定对象是公开还是加密的 Amazon S3 权限。 Amazon Kendra 也没有为 Amazon S3 对象创建或返回签名链接的默认权限。如果要为 Amazon Kendra 索引中的 Amazon S3 对象激活签名链接，则有两种选择：

• 在将索引查询结果返回搜索页面之前，您可以使用源 URI 对象对索引查询结果进行签名。有关此过程的 step-by-step演练，请参阅使用预签名 URL 共享对象。

• 您可以覆盖 Amazon S3 对象元数据源 uri，并通过连接到 Amazon S3 存储桶的 CloudFront 内容分发网络 (CDN) 提供服务。或者，您可以使用返回预签名 URL 并重定向到该地址的 API Gateway 代理端点。

我收到 “使用 SSL 证书文件AccessDenied 时” 错误消息

如果在数据源中使用 SSL 证书时遇到拒绝访问错误，请确保您的 IAM 角色有权访问指定位置的 SSL 证书文件。如果证书使用 AWS KMS 密钥加密，则您的 IAM 角色还应有权使用该 AWS KMS 密钥进行解密。有关更多信息，请参阅 AWS KMS的身份验证和访问控制。

使用 SharePoint 数据源时出现授权错误

如果您在将索引与 SharePoint 数据源同步时遇到授权错误，请确认已在中 SharePoint为您分配了站点管理员角色。

索引无法从我的 Confluence 数据来源中爬取文档

如果在同步过程中，您的 Amazon Kendra 索引没有从 Confluence 数据源中搜寻文档，请确认您是 Confluence 管理员群组的成员。