本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
Amazon OpenSearch Service 中依引擎版本的外掛程式
Amazon OpenSearch Service 網域預先封裝了來自 OpenSearch 社群的外掛程式。服務會自動為您部署和管理外掛程式，但會根據OSS您為網域選擇的版本 OpenSearch 或舊版 Elasticsearch 來部署不同的外掛程式。
下表依 OpenSearch 版本列出外掛程式，以及舊版 Elasticsearch 的相容版本OSS。它只包含您可能互動的外掛程式，但並不全面。 OpenSearch Service 使用其他外掛程式來啟用核心服務功能，例如快照的 S3 儲存庫外掛程式，以及用於最佳化和監控OpenSearch的效能分析
GET _cat/plugins?v
| 外掛程式 | 最低必要 OpenSearch 版本 | 需要的 Elasticsearch 最低版本 |
|---|---|---|
| 2.11 | 不支援 | |
| 2.11 | 不支援 | |
| 2.9 | 不支援 | |
| 2.9 | 不支援 | |
| 2.5 | 不支援 | |
| 2.3 | 不支援 | |
| 1.3 | 不支援 | |
|
Sudachi Analysis |
1.3 | 不支援 |
| 1.3 | 不支援 | |
| 1.3 | 不支援 | |
| 1.3 | 不支援 | |
|
1.2 |
不支援 | |
| 1.1 | 7.10 | |
| 1.0 | 7.10 | |
| 1.0 | 7.7 | |
| 1.0 | 7.4 | |
| 1.0 | 7.1 | |
| 1.0 | 6.8 | |
| 1.0 | 6.7 | |
| 1.0 | 6.5 | |
| 1.0 | 6.2 | |
|
烏克蘭文分析 |
1.0 | 5.3 |
|
映射器大小 |
1.0 | 5.3 |
|
映射器 Murmur3 |
1.0 | 5.1 |
|
擷取使用者代理程式處理器 |
1.0 | 5.1 |
|
擷取附件處理器 |
1.0 | 5.1 |
| Stempel 波蘭文分析 | 1.0 | 5.1 |
|
智慧型中文分析 |
1.0 | 5.1 |
| 1.0 | 5.1 | |
| 語音分析 | 1.0 | 2.3 |
| 日文 (kuromoji) 分析 | 1.0 | 包含在所有網域中 |
|
ICU 分析 |
1.0 | 包含在所有網域中 |
選用外掛程式
除了預先安裝的預設外掛程式之外，Amazon OpenSearch Service 還支援數個選用的語言分析器外掛程式。您可以使用 AWS Management Console 和 AWS CLI 將外掛程式與網域建立關聯，取消外掛程式與網域的關聯，並列出所有外掛程式。選用的外掛程式套件與特定 OpenSearch 版本相容，並且只能與該版本相關聯的網域相關聯。
請注意，對於 Sudachi 外掛程式
選用外掛程式使用ZIP-PLUGIN套件類型。如需選用外掛程式的詳細資訊，請參閱 Amazon OpenSearch 服務的定制包。
第三方外掛程式
Amazon OpenSearch Service 現在支援來自特定合作夥伴的第三方外掛程式。與選用的外掛程式一樣，您可以使用 AWS Management Console 和 AWS CLI 將外掛程式與網域建立關聯、取消與網域的關聯，並列出網域中的所有第三方外掛程式。第三方外掛程式套件與特定 OpenSearch 版本相容，且只能與該 OpenSearch 版本關聯的網域。
第三方外掛程式由第三方開發人員擁有和提供。您有責任直接從第三方開發人員取得和維護有效的授權。這些第三方外掛程式在提供 Amazon OpenSearch Service 的所有AWS 區域中
注意
某些外掛程式供應商可能無法在提供 Amazon OpenSearch Service 的所有 AWS 區域中啟用其外掛程式，請聯絡外掛程式供應商，詢問您所在 AWS 區域的外掛程式可用性相關問題。
如需第三方外掛程式的詳細資訊，請參閱適用於 Amazon OpenSearch Service 的自訂套件。
下列第三方外掛程式現在可在 Amazon OpenSearch Service 上使用：
-
Portal26 加密搜尋外掛程式 （Titanium-lockbox）：來自 Portal26.ai 的 Portal26 加密外掛程式使用 NIST FIPS 140-2 認證的加密，以加密 Amazon OpenSearch Service 所編製索引的資料。此外掛程式包含自帶金鑰 （BYOK） 功能，可讓您為每個索引設定個別的加密金鑰。
-
適用於 （RNI） 的 OpenSearch Babel Street Match 外掛程式：此外掛程式精確地符合超過 24 種語言的名稱、組織、地址和日期，增強了安全操作和法規合規性，同時減少誤報並提高操作效率。
下列第三方外掛程式可與 Amazon OpenSearch Service 搭配使用：
| 外掛程式名稱 | 第三方供應商 | 最低必要 OpenSearch 服務版本 | 需要的 Elasticsearch 最低版本 | 需要授權 |
|---|---|---|---|---|
| Titanium-lockbox | Portal26.ai | 2.15 | 不支援 | Y |
|
名稱比對 （RNI） OpenSearch plugin |
babelstreet.com | 2.15 | 不支援 | Y |
使用第三方外掛程式時，無法使用下列 Amazon OpenSearch Service 功能：
您可以使用 "CreatePackage"、 "AssociatePackage" 和 "DissociatePackage" 來上傳您使用的外掛程式，並將其與 Amazon OpenSearch Service 受管網域建立關聯。 "PACKAGE-CONFIG"和 "PACKAGE-LICENSE"套件類型支援上傳外掛程式組態和授權檔案。若要取得授權檔案以安裝 Portal26，請參閱 https：//Portal26.ai
必要條件
-
請確定您擁有在 Amazon OpenSearch Service 網域上執行的 theOpenSearch 版本的外掛程式組態和授權檔案。
-
您必須在 Amazon OpenSearch Service 網域上啟用下列項目：
-
將「強制執行HTTPS」設定為「真實」
-
啟用對 TLSSecurityPolicy 'Policy-Min-TLS-1-2-PFS-2023-10' 的支援。如需詳細資訊，請參閱 DomainEndpointOptions。
使用 安裝第三方外掛程式 AWS CLI
若要使用 啟用第三方外掛程式， AWS CLI 您需要套用下列服務模型JSON：
-
使用 describe-packages 擷取可用的第三方外掛程式清單API。
aws opensearch --region $REGION describe-packages --filters '[{"Name": "PackageType","Value": ["ZIP-PLUGIN"]}, {"Name": "PackageName","Value": ["<package-name>"]}]' -
使用現有的 建立新的外掛程式授權套件CreatePackageAPI。
aws opensearch --region $REGION create-package --package-name <package-name> --package-type PACKAGE-LICENSE --package-source S3BucketName=<bucket>,S3Key=<key>請更新儲存貯體和金鑰位置，以指向帳戶 s3 儲存貯體中的授權檔案。檔案必須具有 .json 或 .xml 副檔名。
-
使用現有的 為外掛程式組態建立新套件CreatePackageAPI。
aws opensearch --region $REGION create-package --package-name <package-name> --package-type PACKAGE-CONFIG --package-source S3BucketName=<bucket>,S3Key=<key注意
請更新儲存貯體和金鑰位置，以指向呼叫帳戶 s3 儲存貯體中的組態壓縮檔案。s3 必須位於建立套件的相同區域中。組態類型套件僅支援 zip 檔案。zip 檔案的內容必須遵循外掛程式預期的目錄結構。
-
使用 新 AssociatePackage API 使用這些套件的套件 ID，將合作夥伴外掛程式以及授權和組態與相容的 Amazon OpenSearch Service 網域 （相符版本） 建立關聯。
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>"]}]'注意
外掛程式是使用藍/綠部署程序 進行安裝和解除安裝。
-
使用現有的 ListPackagesForDomain API 來查看關聯的狀態。隨著工作流程從 進展ASSOCATING到 ，關聯狀態將會變更ACTIVE。一旦外掛程式安裝工作流程完成，且外掛程式已準備好可供使用ACTIVE，關聯狀態就會變更為 。
aws opensearch --region $REGION list-packages-for-domain --domain-name <domain name> -
使用現有的 GetPackageVersionHistory
API 來查看任何套件的版本。 -
您可以使用現有的 UpdatePackage 更新授權/組態套件API。使用下列項目API將套件更新套用至網域。
aws opensearch --region $REGION update-package --package-id <package-id> --package-source S3BucketName=<bucket>,S3Key=<key> --package-description <description> -
使用現有的 DissociatePackageAPI，從任何網域解除安裝外掛程式。您可以使用現有的 ListPackagesForDomain API 來查看取消關聯的狀態。
aws opensearch --region $REGION dissociate-package --package-id <plugin-package-id> --domain-name <domain name>注意
若要解除安裝外掛程式，您必須先停用每個索引中的外掛程式，才能取消外掛程式套件的關聯。
-
使用現有的 ListPackagesForDomain API 來查看取消關聯的狀態。
