如何排查将 Amazon OpenSearch Service 域连接到 QuickSight 时的连接错误?

上次更新日期:2022 年 7 月 25 日

我正在尝试将我的 Amazon OpenSearch Service 域名连接到 Amazon QuickSight。但是,我收到了一条错误消息。如何解决此问题?

简短描述

要将 QuickSight 连接到您的 Amazon OpenSearch 域,请确保:

  • 您的域版本为 7.7 或更高版本。
  • 您的 OpenSearch 版本为 1.0 或更高版本。
  • 您的 OpenSearch Service 域与 QuickSight 在同一个 AWS 区域和账户中。

注意:Amazon OpenSearch Service 支持 OpenSearch 和最高 7.10 版的旧版 Elasticsearch OSS。

解决方法

请按照您的使用案例执行以下排查步骤。

不支持的引擎版本错误

连接到 OpenSearch Service 域时,您可能会收到以下错误:

"Your database uses an unsupported engine version. Please review supported versions."

如果未在 OpenSearch Service 域上启用兼容模式,则会出现此错误。OpenSearch 1.0 版引入了名为启用兼容模式的域设置。一些 OpenSearch Service 客户端和插件在连接之前会检查集群版本。兼容模式将 OpenSearch Service 设置为报告其版本是 7.10,以便这些客户端继续工作。启用兼容模式后,QuickSight 会识别正确的版本并成功建立连接。

要启用兼容模式,请运行以下命令:

PUT /_cluster/settings
{
     "persistent": {
          "compatibility.override_main_response_version": true
     }
}

光标未启用或无法准备此表错误

OpenSearch Service 域数据导入 SPICE 时,您可能会收到以下错误之一:

Can't perform this Action. The domain X has not enabled cursor.

-或者-

Unable to prepare this table

要在 OpenSearch Service 域中启用 SQL 光标,请运行以下命令:

PUT _opendistro/_sql/settings
{
     "transient": {
          "opendistro.sql.cursor.enabled": "true"
     },
     "persistent": {
          "opendistro.sql.cursor.enabled": "true"
     }
}

连接错误被禁止

如果您在 OpenSearch Service 域中的 OpenSearch 控制面板上启用了精细访问控制,则可能会收到以下错误消息:

GENERAL_SQL_EXCEPTION. Connection error forbidden

出现此错误的原因是 QuickSight 服务角色未映射到 OpenSearch Service 角色。

要解决此错误,请按照说明向域添加权限以允许从 QuickSight 进行访问