Amazon WorkDocs - Amazon Kendra
支持的特征先决条件连接说明了解更多信息

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

Amazon WorkDocs

Amazon WorkDocs 是一项用于创建、编辑、存储和共享内容的安全内容协作服务。您可以使用索 Amazon Kendra 引您的 Amazon WorkDocs 数据源。

您可以使用Amazon Kendra 控制台和 WorkDocsConfigurationAPI Amazon Kendra 连接到您的 Amazon WorkDocs 数据源。

Amazon WorkDocs 已在俄勒冈州、北弗吉尼亚州、悉尼、新加坡和爱尔兰地区推出。

要对 Amazon Kendra WorkDocs 数据源连接器进行故障排除，请参阅数据来源故障排除。

支持的特征

Amazon Kendra WorkDocs 数据源连接器支持以下功能：

  • 字段映射

  • 用户访问控制

  • 包含/排除筛选条件

  • 更改日志

先决条件

在使用索 Amazon Kendra 引 WorkDocs 数据源之前，请在 WorkDocs 和 AWS 帐户中进行这些更改。

在中 WorkDocs，请确保你有：

  • 已记下 Amazon WorkDocs 仓库的 Amazon WorkDocs 目录 ID（组织 ID）。

  • 已选中每个文档在您计划用于同一索引的其他数据源中 WorkDocs 以及其他数据源中都是唯一的。您要用于编制索引的每个数据来源在所有数据来源中都不能包含相同的文档。文档 ID 对索引来说是全局性的，并且每个索引都必须是唯一的。

在您的 AWS 账户中，请确保您有：

如果您没有现有 IAM 角色，则可以在将 WorkDocs 数据源连接到时使用控制台创建新 IAM 角色 Amazon Kendra。如果您使用的是 API，则必须提供现有 IAM 角色的 ARN 和索引 ID。

连接说明

要 Amazon Kendra 连接到您的 WorkDocs 数据源，您必须提供 WorkDocs 数据源的必要详细信息，以便 Amazon Kendra 能够访问您的数据。如果您尚未进行配置 Amazon Kendra， WorkDocs 请参阅先决条件。

Console

要连接 Amazon Kendra 到 Amazon WorkDocs

  1. 登录 AWS Management Console 并打开Amazon Kendra 控制台。

  2. 在左侧导航窗格中，选择索引，然后从索引列表中选择要使用的索引。

    注意

    您可以选择在索引设置下配置或编辑您的用户访问控制设置。

  3. 在入门页面上，选择添加数据来源。

  4. 在添加数据源页面上，选择WorkDocs 连接器，然后选择添加连接器。如果使用版本 2（如果适用），请选择带有 “V2.0” 标签的WorkDocs 连接器。

  5. 在指定数据来源详细信息页面上输入以下信息：

    1. 在名称和描述中，在数据来源名称中输入您的数据来源的名称。可以包含连字符，但不能包含空格。

    2. （可选）说明 - 为数据来源输入说明。

    3. 使用默认语言-选择一种语言来筛选文档中的索引。除非另行指定，否则语言默认为英语。在文档元数据中指定的语言会覆盖所选语言。

    4. 在标签中，用于添加新标签-包括可选标签以搜索和筛选您的资源或跟踪您的 AWS 成本。

    5. 选择下一步。

  6. 在定义访问权限和安全性页面上，请输入以下信息：

    1. 特定于您的 Amazon WorkDocs 站点的组织 ID-选择要编制索引的 Amazon WorkDocs 网站的 ID。您必须已创建一个站点。

    2. IAM ro le —选择现有 IAM 角色或创建新 IAM 角色来访问您的存储库凭据和索引内容。

      注意

      IAM 用于索引的角色不能用于数据源。如果您不确定是否将现有角色用于编制索引或常见问题解答，为了避免出错，请选择创建新角色。

    3. 选择下一步。

  7. 在配置同步设置页面上，请输入以下信息：

    1. 爬取文档备注 - 要爬取的 Amazon WorkDocs 实体或内容类型。

    2. 使用更改日志-选择仅使用新的或修改过的内容更新索引，而不是同步所有文件。

    3. 正则表达式模式 - 包含或排除某些文件的正则表达式模式。

    4. 在 F requency 的同步运行计划中-选择同步数据源内容和更新索引的频率。

    5. 选择下一步。

  8. 在设置字段映射页面上，请输入以下信息：

    1. 默认数据源字段-从 Amazon Kendra 生成的默认数据源字段中选择要映射到索引的字段。

    2. 添加字段 - 添加自定义数据来源字段以创建要映射到的索引字段名称和字段数据类型。

    3. 选择下一步。

  9. 在查看和创建页面上，请检查输入的信息是否正确，然后选择添加数据来源。您也可以选择在此页面上编辑信息。成功添加数据来源后，您的数据来源将显示在数据来源页面上。

API

要连接 Amazon Kendra 到 Amazon WorkDocs

您必须使用 WorkDocsConfigurationAPI 指定以下内容：

  • Amazon WorkDocs 目录 ID-指定 Amazon WorkDocs 目录的组织 ID。您可以依次转到 Active Directory、目录，来查找 AWS Directory Service 中的组织 ID。

  • IAM 角色-指定RoleArn何时调用CreateDataSource为 IAM 角色提供访问 WorkDocs目录和调用连接器所需的公共 API 的 WorkDocs 权限。 Amazon Kendra有关更多信息，请参阅 WorkDocs 数据源的 IAM 角色。

您还可以添加以下可选功能：

  • 更改日志-是否 Amazon Kendra 应使用 WorkDocs 数据源更改日志机制来确定是否必须更新索引中的文档。

    注意

    如果您不想让 Amazon Kendra 扫描所有文档，请使用更改日志。如果您的更改日志很大，则扫描 WorkDocs 数据源中的文档所花费的时间可能比处理更改日志所需的时间 Amazon Kendra 少。如果您是首次将 WorkDocs数据源与索引同步，则会扫描所有文档。

  • 包含和排除筛选条件 - 指定是包括还是排除某些文档和文档注释。每条注释都会作为单独的文档来编制索引。

    注意

    大多数数据来源使用正则表达式模式，即称为筛选条件的包含或排除模式。如果您指定包含筛选条件，则只会为与包含筛选条件匹配的内容编制索引。不会为任何与包含筛选条件不匹配的文档编制索引。如果您指定包含和排除筛选条件，则不会为与排除筛选条件匹配的文档编制索引，即使它们与包含筛选条件相匹配。

  • 用户上下文筛选和访问控制-如果您的文档有 ACL，则会Amazon Kendra 搜索文档的访问控制列表 (ACL)。ACL 信息用于根据用户或用户组对文档的访问权限来筛选搜索结果。有关更多信息，请参阅用户上下文筛选。

  • 字段映射-选择将 WorkDocs 数据源字段映射到 Amazon Kendra 索引字段。有关更多信息，请参阅映射数据来源字段。

    注意

    要搜索您的文档，必须输入文档正文字段或文档正文等效字段。 Amazon Kendra 您必须将数据源中的文档正文字段名称映射到索引字段名称_document_body。其他所有字段均为可选字段。

了解更多信息

要了解有关 Amazon Kendra 与 WorkDocs 数据源集成的更多信息，请参阅：