Drupal

注意

直到 2026 年 5 月 31 日，现有客户仍将完全支持 Drupal 连接器。虽然此连接器不再可供新用户使用，但当前用户可以不间断地继续使用它。我们不断发展我们的连接器产品组合，以提供更具可扩展性和可定制性的解决方案。对于未来的集成，我们建议您探索 Amazon Kendra 定制连接器框架 [1]，该框架旨在以更高的灵活性支持更广泛的企业用例。

Drupal 是一个可用于创建网站和 Web 应用程序的开源内容管理系统（CMS）。你可以在 Drupal 中使用 Amazon Kendra 索引以下内容：

内容 - 文章、基本页面、基本数据块、用户定义的内容类型、用户定义的数据块类型、自定义内容类型、自定义数据块类型
评论 - 适用于任何内容类型和数据块类型
附件 - 适用于任何内容类型和数据块类型

您可以使用Amazon Kendra 控制台或 TemplateConfigurationAPI Amazon Kendra 连接到您的 Drupal 数据源。

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

支持的特征

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

字段映射
用户上下文筛选
包含/排除筛选条件
完整内容和增量内容同步
Virtual Private Cloud (VPC) [虚拟私有云（VPC）]

先决条件

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

在 Drupal 中，请确保：

已创建一个 Drupal（标准）套件账户和一个具有管理员角色的用户。
已复制 Drupal 站点名称并配置了主机 URL。例如 https://<hostname>/<drupalsitename>。
已配置包含用户名（Drupal 网站登录用户名）和密码（Drupal 网站密码）的基本身份验证凭证。
推荐：已配置 OAuth 2.0 凭据令牌。使用此令牌以及您的 Drupal 密码授权、客户端 ID、客户端密钥、用户名（Drupal 网站登录用户名）和密码（Drupal 网站密码）连接到 Amazon Kendra。
使用管理员角色在您的 Drupal 账户中添加了以下权限：
- 管理数据块
- 挂你数据块内容显示
- 管理数据块内容字段
- 管理数据块内容表达显示
- 管理视图
- 查看用户电子邮件地址
- 查看自己的未发布内容
- 查看页面修订
- 查看文章修订
- 查看所有修订
- 查看管理主题
- 访问内容
- 访问内容概览
- 访问注释
- 搜索内容
- 访问文件概览
- 访问上下文链接
注意
如果存在用户定义的内容类型或用户定义的数据块类型，或者任何视图和区块被添加到 Drupal 网站，则必须为其提供管理员访问权限。

在你的 AWS 账户，请确保你有：

已创建 Amazon Kendra 索引，如果使用 API，则记下索引 ID。
为您的数据源@@ 创建了一个 IAM 角色，如果使用 API，请记下该角色的 ARN。 IAM

注意
如果您更改了身份验证类型和证书，则必须更新您的 IAM 角色才能访问正确的 AWS Secrets Manager 密钥 ID。
将您的 Drupal 身份验证凭证存储在 AWS Secrets Manager 密钥中，如果使用 API，请记下密钥的 ARN。

注意
我们建议您定期刷新或轮换您的凭证和密码。为了安全起见，请仅提供必要的访问权限级别。我们建议不要跨数据来源以及连接器版本 1.0 和 2.0（如果适用）重复使用凭证和密钥。

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

连接说明

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

Console

连接 Amazon Kendra 到 Drupal

登录 AWS Management Console 并打开Amazon Kendra 控制台。
在左侧导航窗格中，选择索引，然后从索引列表中选择要使用的索引。

注意
您可以选择在索引设置下配置或编辑您的用户访问控制设置。
在入门页面上，选择添加数据来源。
在添加数据源页面上，选择 Drupal 连接器，然后选择添加连接器。如果使用版本 2（如果适用），请选择带有 “V2.0” 标签的 Drupal 连接器。
在指定数据来源详细信息页面上输入以下信息：
1. 在名称和描述中，在数据来源名称中输入您的数据来源的名称。可以包含连字符，但不能包含空格。
2. （可选）说明 - 为数据来源输入说明。
3. 使用默认语言-选择一种语言来筛选文档中的索引。除非另行指定，否则语言默认为英语。在文档元数据中指定的语言会覆盖所选语言。
4. 在标签中，用于添加新标签-包括可选标签以搜索和筛选您的资源或跟踪您的 AWS 成本。
5. 选择下一步。
在定义访问权限和安全性页面上，请输入以下信息：
1. 在源中，对于主机 URL - 您的 Drupal 网站的主机 URL。例如 https://<hostname>/<drupalsitename>。
2. SSL 证书位置 - 输入您存储在 Amazon S3 存储桶中的 SSL 证书的路径。
3. 授权-如果您有 ACL 并想将其用于访问控制，请打开或关闭文档的访问控制列表 (ACL) 信息。ACL 指定了用户和群组可以访问哪些文档。ACL 信息用于根据用户或用户组对文档的访问权限来筛选搜索结果。有关更多信息，请参阅用户上下文筛选。
4. 对于身份验证-根据您的用例在基本身份验证和 OAuth 2.0 身份验证之间进行选择。
5. AWS Secrets Manager s@@ ecret —选择现有密钥或创建新 Secrets Manager 密钥来存储您的 Drupal 身份验证凭据。如果您选择创建新密钥，则会打开 AWS Secrets Manager 密钥窗口。
  1. 在创建 AWS Secrets Manager 密钥窗口中输入以下信息：
    1. 如果已选择基本身份验证，请输入您复制的密钥名称、用户名（Drupal 站点用户名）和密码（Drupal 站点密码），然后选择保存和添加密钥。
    2. 如果您选择了 OAuth 2.0 身份验证，请输入在您的 Drupal 帐户中生成的密钥名称、用户名（Drupal 站点用户名）、密码（Drupal 站点密码）、客户端 ID 和客户机密，然后选择保存并添加密钥。
  2. 选择保存。
6. 虚拟私有云（VPC）- 您可以选择使用 VPC。如果是这样，则必须添加子网和 VPC 安全组。
7. I Amazon Kendra dent@@ ity Crawler-指定是否开启身份搜寻器。Identity Crawler 使用文档的访问控制列表 (ACL) 信息，根据用户或其群组对文档的访问权限筛选搜索结果。如果您的文档有 ACL 并选择使用您的 ACL，则也可以选择开启身份爬网程序来配置搜索结果 Amazon Kendra的用户上下文筛选。否则，如果身份搜寻器已关闭，则可以公开搜索所有文档。如果您想对文档使用访问控制并且身份搜寻器已关闭，则可以使用 PutPrincipalMappingAPI 上传用户和群组访问信息以进行用户上下文筛选。
8. IAM ro le —选择现有 IAM 角色或创建新 IAM 角色来访问您的存储库凭据和索引内容。
  
  注意
  IAM 用于索引的角色不能用于数据源。如果您不确定是否将现有角色用于编制索引或常见问题解答，为了避免出错，请选择创建新角色。
9. 选择下一步。
在配置同步设置页面上，请输入以下信息：
1. 对于同步范围，从以下选项中进行选择：
  
  注意
  当您选择爬取文章、基本页面和基本数据块时，它们的默认字段将自动同步。您也可以选择同步它们的评论、附件、自定义字段和其他自定义实体。
  1. 对于选择实体：
    - 文章 - 选择是否爬取文章、文章评论、评论和附件。
    - 基本页面 - 选择是否爬取基本页面、页面评论及其附件。
    - 基本数据块 - 选择是否爬取基本数据块、数据块评论及其附件。
    - 您也可以选择添加自定义内容类型和自定义数据块。
2. 对于其他配置 - 可选：
  - 对于正则表达式模式 - 添加正则表达式模式以包含或排除特定的实体标题和文件名。最多可以添加 100 个模式。
3. 同步模式 - 选择在数据来源内容发生变化时更新索引的方式。首次与同步数据源时， Amazon Kendra 默认情况下会对所有内容进行抓取和索引。如果初始同步失败，即使您没有选择完全同步作为同步模式选项，也必须对数据进行完全同步。
  - 完全同步：对所有内容进行新索引，每次数据源与索引同步时都会替换现有内容。
  - 新增、已修改、已删除的同步：每次数据源与索引同步时，仅索引新内容、修改内容和已删除内容。 Amazon Kendra 可以使用数据源的机制来跟踪内容更改并索引自上次同步以来更改的内容。
4. 在同步运行计划中，对于频率 - Amazon Kendra 与数据来源同步的频率。
5. 选择下一步。
在设置字段映射页面上，请输入以下信息：
1. 对于内容、评论和附件-从 Amazon Kendra 生成的默认数据源字段中选择要映射到索引的字段。
2. 添加字段 - 添加自定义数据来源字段以创建要映射到的索引字段名称和字段数据类型。
3. 选择下一步。
在查看和创建页面上，请检查输入的信息是否正确，然后选择添加数据来源。您也可以选择在此页面上编辑信息。成功添加数据来源后，您的数据来源将显示在数据来源页面上。

API

连接 Amazon Kendra 到 Drupal

您必须使用 TemplateConfiguration API 指定数据来源架构的 JSON。您必须提供以下信息：

数据源-将数据源类型指定为使用 TemplateConfigurationJSON 架构DRUPAL时的类型。还要像调用 CreateDataSourceAPI TEMPLATE 时一样指定数据源。
同步模式-指定数据源内容发生变化时 Amazon Kendra 应如何更新索引。首次与同步数据源时， Amazon Kendra 默认情况下会对所有内容进行抓取和索引。如果初始同步失败，即使您没有选择完全同步作为同步模式选项，也必须对数据进行完全同步。您可以选择：
- FORCED_FULL_CRAWL对所有内容进行全新索引，每次数据源与索引同步时都要替换现有内容。
- FULL_CRAWL每次数据源与索引同步时，仅对新的、修改过的和已删除的内容编制索引。 Amazon Kendra 可以使用数据源的机制来跟踪内容更改并索引自上次同步以来更改的内容。
- CHANGE_LOG每次数据源与索引同步时，仅索引新的和修改过的内容。 Amazon Kendra 可以使用数据源的机制来跟踪内容更改并索引自上次同步以来更改的内容。
亚马逊秘密资源名称 (ARN)-提供包含您在 Drupal 账户中创建的身份验证凭证的 Secrets Manager 密钥的亚马逊资源名称 (ARN)。

如果您使用基本身份验证，密钥将存储在 JSON 结构中，其中包含以下键：
```
{
    "username": "user name",
    "password": "password"
}
```
如果您使用 OAuth 2.0 身份验证，则密钥将存储在 JSON 结构中，其中包含以下密钥：
```
{
    "username": "user name",
    "password": "password",
    "clientId": "client id",
    "clientSecret": "client secret"
}
```
注意
注意
我们建议您定期刷新或轮换您的凭证和密码。为了安全起见，请仅提供必要的访问权限级别。我们建议不要跨数据来源以及连接器版本 1.0 和 2.0（如果适用）重复使用凭证和密钥。
IAM ro le —指定RoleArn何时调用CreateDataSource为 IAM 角色提供访问您的 Secrets Manager 密钥的权限以及呼叫 Drupal 连接器 APIs 所需的公众的权限，以及。 Amazon Kendra有关更多信息，请参阅 Drupal 数据来源的IAM 角色。

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

虚拟私有云（VPC）- 指定 VpcConfiguration，以便调用 CreateDataSource。有关更多信息，请参阅配置 Amazon Kendra 为使用 Amazon VPC。
包含和排除筛选条件 - 您可以指定是否包括内容、评论和附件。您也可以指定正则表达式模式来包含或排除内容、评论和附件。

注意
大多数数据来源使用正则表达式模式，即称为筛选条件的包含或排除模式。如果您指定包含筛选条件，则只会为与包含筛选条件匹配的内容编制索引。不会为任何与包含筛选条件不匹配的文档编制索引。如果您指定包含和排除筛选条件，则不会为与排除筛选条件匹配的文档编制索引，即使它们与包含筛选条件相匹配。
I Amazon Kendra dent@@ ity Crawler-指定是否开启身份搜寻器。Identity Crawler 使用文档的访问控制列表 (ACL) 信息，根据用户或其群组对文档的访问权限筛选搜索结果。如果您的文档有 ACL 并选择使用您的 ACL，则也可以选择开启身份爬网程序来配置搜索结果 Amazon Kendra的用户上下文筛选。否则，如果身份搜寻器已关闭，则可以公开搜索所有文档。如果您想对文档使用访问控制并且身份搜寻器已关闭，则可以使用 PutPrincipalMappingAPI 上传用户和群组访问信息以进行用户上下文筛选。
字段映射 - 选择将 Drupal 数据来源字段映射到 Amazon Kendra 索引字段。有关更多信息，请参阅映射数据来源字段。

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

有关要配置的其他重要 JSON 键的列表，请参阅Drupal 模板架构。

备注

Drupal APIs 没有官方的限制限制。
Java SDKs 不适用于 Drupal。
只能使用原生 JSON API 获取 Drupal 数据。
无法爬取与任何 Drupal 视图无关的内容类型。
您需要管理员访问权限才能从 Drupal 数据块中爬取数据。
没有可用于使用 HTTP 动词创建用户定义的内容类型的 JSON API。
文章、基本页面、基本数据块、用户定义的内容类型和用户定义的数据块类型的文档正文和评论以 HTML 格式显示。如果 HTML 内容格式不正确，则与 HTML 相关的标签将出现在文档正文和注释中，并在 Amazon Kendra 搜索结果中可见。
没有描述或正文的内容类型和区块类型不会被 Amazon Kendra收录。只有此类内容或区块类型的评论和附件才会被提取到您的 Amazon Kendra 索引中。

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

Dropbox

GitHub