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

1 分钟阅读

我正在尝试将我的 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 进行访问。