Amazon OpenSearch 服务中按引擎版本划分的插件 - 亚马逊 OpenSearch 服务
可选插件第三方插件
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

Amazon OpenSearch 服务中按引擎版本划分的插件

Amazon S OpenSearch ervice 域名预先打包了来自 OpenSearch 社区的插件。该服务会自动为您部署和管理插件，但它会部署不同的插件，具体取决于您为域选择的 OpenSearch 旧版 Elasticsearch OSS 版本。

下表按 OpenSearch 版本列出了插件以及旧版 Elasticsearch OSS 的兼容版本。它只包括你可能与之交互的插件，并不全面。 OpenSearch 服务使用其他插件来启用核心服务功能，例如用于快照的 S3 存储库插件和用于优化和监控的 Perfor OpenSearchmance Analyzer 插件。有关域上运行的所有插件的完整列表，请提出以下请求：

GET _cat/plugins?v
插件 所需的最低 OpenSearch 版本 最低要求的 Elasticsearch 版本

HanLP

 2.1.1 不支持

希伯来语分析

 2.1.1 不支持

Amazon Personalize 搜索排名

 2.9 不支持

神经搜索

 2.9 不支持

安全分析

 2.5 不支持

OpenSearch 通知

 2.3 不支持

ML Commons

 1.3 不支持

Sudachi 分析（推荐用于日语）

 1.3 不支持

STConvert

 1.3 不支持

拼音分析

 1.3 不支持

Nori 分析

 1.3 不支持

OpenSearch 可观察性

1.2

 不支持

OpenSearch 跨集群复制

 1.1 7.10

OpenSearch 异步搜索

 1.0 7.10

IK（中文）分析

 1.0 7.7

越南语分析

泰语分析

学习排名

OpenSearch 异常检测

 1.0 7.4

OpenSearch k-NN

 1.0 7.1

OpenSearch 索引状态管理

 1.0 6.8

OpenSearch 安全

 1.0 6.7

OpenSearch SQL

 1.0 6.5

OpenSearch 警报

 1.0 6.2

乌克兰语分析

 1.0 5.3

映射器大小

 1.0 5.3

映射器 Murmur3

 1.0 5.1

Ingest 用户代理处理器

 1.0 5.1

Ingest Attachment 处理器

 1.0 5.1
Stempel Polish 分析 1.0 5.1

智能中文分析

 1.0 5.1

Seunjeon 韩语分析

 1.0 5.1
拼音分析 1.0 2.3
日语 (kuromoji) 分析 1.0 包含在所有域中

ICU分析

 1.0 包含在所有域中

可选插件

除了预先安装的默认插件外，Amazon S OpenSearch ervice 还支持多个可选的语言分析器插件。您可以使用 Amazon Web Services Management Console 和将插件 Amazon CLI 与域关联、取消插件与域的关联以及列出所有插件。可选的插件包与特定 OpenSearch 版本兼容，并且只能与具有该版本的域名相关联。

请注意，对于 Sudachi 插件，当您重新关联字典文件时，它不会立即反映到域中。当作为配置更改或其他更新的一部分在域上运行下一个蓝绿部署时，字典会刷新。您也可以使用更新后的数据创建新的程序包，使用此新程序包创建新索引，利用现有索引重新创建新索引，然后删除旧索引。如果您更喜欢使用重新编制索引的方法，请使用索引别名，这样您的流量就不会受到干扰。

可选插件使用 ZIP-PLUGIN 程序包类型。有关可选插件的更多信息，请参阅 Amazon OpenSearch Service 的定制包裹。

第三方插件

Amazon S OpenSearch ervice 现在支持特定合作伙伴提供的第三方插件。与可选插件一样，您可以使用 Amazon Web Services Management Console 和 Amazon CLI 将插件与域关联起来，取消插件与域的关联，并列出您域中的所有第三方插件。第三方插件包与特定 OpenSearch 版本兼容，并且只能与具有该 OpenSearch 版本的域名相关联。

第三方插件由第三方开发者拥有和提供。您有责任直接从第三方开发者那里获取和维护有效的许可证。这些第三方插件适用于除AmazonAmazon GovCloud (US) 地区以外的所有提供亚马逊 OpenSearch 服务的区域。

注意

某些插件提供商可能无法在所有提供亚马逊 OpenSearch 服务的 Amazon 地区启用其插件，请联系插件提供商，询问与您所在 Amazon 地区的插件可用性有关的问题。

有关第三方插件的更多信息，请参阅 Amazon OpenSearch 服务的自定义套餐。

以下第三方插件现已在 Amazon OpenSearch 服务上可用：

  • Portal26 加密搜索插件（Titanium-Lockbox）：来自 Portal26.ai 的 Portal26 加密插件使用 NIST FIPS 140-2 认证加密来加密亚马逊服务索引的数据。 OpenSearch 此插件包括 Bring Your Own Key (BYOK) 功能，允许您为每个索引设置单独的加密密钥。

  • 适用于 OpenSearch (RNI) 的 Babel Street Match Plugin：该插件精确匹配超过 24 种语言的姓名、组织、地址和日期，增强了安全运营和监管合规性，同时减少了误报并提高了运营效率。

以下第三方插件可用于 Amazon OpenSearch 服务：

插件名称 第三方提供商 所需的最低 OpenSearch 服务版本 最低要求的 Elasticsearch 版本 需要许可证
钛金锁箱 Portal26.ai 2.15 不支持 Y

名称匹配 (RNI) OpenSearch 插件

 babelstreet.com 2.15 不支持 Y

使用第三方插件时，以下亚马逊 OpenSearch 服务功能不可用：

插件名称 加密插件 通天街比赛插件

跨集群搜索

 不支持 不支持

跨集群复制

 不支持 不支持

远程重新索引

 不支持 不支持

自动调谐

 不支持 不支持

超暖

 不支持 支持

带待机功能的多可用区

 不支持 不支持

您可以使用"CreatePackage"、"AssociatePackage"和"DissociatePackage"上传您使用的插件并将其与您的亚马逊 OpenSearch 服务托管域相关联。 "PACKAGE-CONFIG"支持上传插件配置和许可证文件的"PACKAGE-LICENSE"软件包类型。要获取安装 Portal26 的许可证文件，请参阅 Portal26.ai。要获取安装 Name Match (RNI) OpenSearch 插件的许可证文件，请参阅 Babel Stre et。

先决条件

使用以下方式安装第三方插件 Amazon CLI

要使用使用第三方插件， Amazon CLI 您需要应用以下服务模型JSON：

  1. 使用 desc ribe API-packages 获取可用的第三方插件列表。

    aws opensearch --region $REGION describe-packages --filters '[{"Name": "PackageType","Value": ["ZIP-PLUGIN"]}, {"Name": "PackageName","Value": ["<package-name>"]}]'

  2. 使用现有软件包为插件许可证创建新的软件包CreatePackageAPI。

    aws opensearch --region $REGION create-package --package-name <package-name> --package-type PACKAGE-LICENSE --package-source S3BucketName=<bucket>,S3Key=<key>

    请更新存储桶和密钥位置，使其指向账户 s3 存储桶中的许可证文件。该文件必须具有.json 或.xml 扩展名。

  3. 使用现有的软件包为插件配置创建一个新的软件包CreatePackageAPI。

    aws opensearch --region $REGION create-package --package-name <package-name> --package-type PACKAGE-CONFIG --package-source S3BucketName=<bucket>,S3Key=<key
    注意

    请更新存储桶和密钥位置，使其指向调用账户的 s3 存储桶中的配置 zip 文件。s3 必须位于创建软件包的同一区域。配置类型包仅支持 zip 文件。zip 文件的内容必须符合插件预期的目录结构。

  4. 使用新版AssociatePackageAPI将合作伙伴插件以及许可证和配置与兼容的 Amazon Serv OpenSearch ice 域名（匹配版本）关联起来，使用这些软件包的软件包 ID。

    aws opensearch --region $REGION associate-packages --domain-name <domain-name> --package-list '[{"PackageID": "<plugin-package-id>"},{"PackageID": "<license-package-id>","PrerequisitePackageIDList":["<plugin-package-id>"]},{"PackageID":"<config-package-id>","PrerequisitePackageIDList":["<plugin-package-id>"]}]'
    注意

    插件是使用蓝/绿部署过程安装和卸载的。

  5. 使用现有ListPackagesForDomainAPI来查看关联的状态。随着工作流程从变为的进展，关联状态将发生变化ASSOCATING。ACTIVE插件安装工作流程完成且插件准备好使用ACTIVE后，关联状态将更改为。

    aws opensearch --region $REGION list-packages-for-domain --domain-name <domain name>

  6. 使用现有版本GetPackageVersionHistoryAPI查看任何软件包的版本。

  7. 许可证/配置软件包可以使用现有软件包进行更新。UpdatePackageAPI使用以下命令API将软件包更新应用于域。

    aws opensearch --region $REGION update-package --package-id <package-id>  --package-source S3BucketName=<bucket>,S3Key=<key> --package-description <description>

  8. 使用现有版本DissociatePackageAPI从任何域中卸载插件。您可以使用现有的ListPackagesForDomainAPI来查看解除关联的状态。

    aws opensearch --region $REGION dissociate-package --package-id <plugin-package-id> --domain-name <domain name>
    注意

    要卸载插件，您必须先从每个索引中禁用该插件，然后才能解除该插件包的关联。

  9. 使用现有ListPackagesForDomainAPI来查看解除关联的状态。