选择您的 Cookie 首选项

我们使用必要 Cookie 和类似工具提供我们的网站和服务。我们使用性能 Cookie 收集匿名统计数据，以便我们可以了解客户如何使用我们的网站并进行改进。必要 Cookie 无法停用，但您可以单击“自定义”或“拒绝”来拒绝性能 Cookie。

如果您同意，AWS 和经批准的第三方还将使用 Cookie 提供有用的网站功能、记住您的首选项并显示相关内容，包括相关广告。要接受或拒绝所有非必要 Cookie，请单击“接受”或“拒绝”。要做出更详细的选择，请单击“自定义”。

首选项
联系我们
反馈
AWS Documentation
创建 AWS 账户
数据来源故障排除 - Amazon Kendra
我的文档没有编入索引我的同步作业失败了我的同步任务未完成我的同步作业执行成功了，但没有编制了索引的文档我在同步数据来源时遇到了文件格式问题我要为文档生成同步历史记录报告同步数据来源需要多长时间？同步数据来源的费用是多少？我收到 Amazon EC2 授权错误我无法使用搜索索引链接来打开我的 Amazon S3 对象我收到 “使用 SSL 证书文件AccessDenied 时” 错误消息使用 SharePoint 数据源时出现授权错误索引无法从我的 Confluence 数据来源中爬取文档

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

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

数据来源故障排除

PDFRSS

本节可以帮助您解决配置和使用 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 指定为内容类型。

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

选择 “查看报告”，即可在中查看数据源同步作业 CloudWatch 的文档级同步运行历史报告。同步运行历史记录报告将包含有关同步作业中每个文档的进度和状态的详细信息。报告显示文档在爬取、同步和索引阶段是成功、失败还是跳过。您还可以找到与失败或跳过的文档相关的所有错误消息。如果报告未显示某个正在进行的同步作业的结果，可能是因为日志可能尚不可用。请稍后再返回查看，因为数据会在同步过程中发生事件时发送到报告中。

要访问您的同步运行历史记录报告，请执行以下步骤：

  1. 打开亚马逊 Kendra 主机，网址为。https://console.aws.amazon.com/kendra/

  2. 在左侧导航菜单的 “数据管理” 下，选择 “数据源”，然后选择您的数据源。

  3. 在数据源摘要页面上，向下滚动并选择同步历史记录选项卡。

  4. 在同步运行历史记录中，选择操作。

  5. 在 “操作” 中，选择 “查看报告”。您将被重定向到 CloudWatch 控制台，在那里您可以访问您的报告。

注意

同步运行历史记录记录了所有支持 Amazon Kendra 的连接器的文档（包括附件 ACLs 和元数据）在摄取期间是否成功编制了索引。

如果您使用的是 Amazon S3 连接器：

除了在中查看文档级同步运行历史记录报告外 CloudWatch，您还可以为 Amazon S3 数据源中的每个文档生成同步历史报告并将其复制到存储桶。 Amazon S3 在此过程中，您的数据将使用 AWS KMS 密钥进行加密，并且只能由您查看。报告的文档状态包括：失败、已完成或成功但有错误。在为 Amazon S3 生成同步状态报告之前，您必须执行以下操作：

  • 将以下 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 S3 连接器是否成功抓取和提取数据的信息。

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

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

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

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

我收到 Amazon EC2 授权错误

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

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

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

  • 您可以覆盖 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 管理员群组的成员。

上一主题：

故障排除

需要帮助吗？

隐私网站条款Cookie 首选项
© 2025, Amazon Web Services, Inc. 或其附属公司。保留所有权利。