我试图将我的 Amazon OpenSearch Service 域连接到 Amazon QuickSight,但收到了一个错误。
简短描述
在将 QuickSight 连接到 OpenSearch Service 域之前,请验证以下条件:
- 您的域版本为 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 Dashboards 上激活了精细的访问控制,则可能会收到以下错误:
"GENERAL_SQL_EXCEPTION.Connection error forbidden."
发生此错误的原因是 QuickSight 服务角色未映射到 OpenSearch Service 角色。
要解决此错误,请按照说明向域添加权限以允许从 QuickSight 进行访问。
相关信息
Using Amazon OpenSearch Service with Amazon QuickSight
Supported data sources
Connecting to a VPC with Amazon QuickSight
Operational best practices for Amazon OpenSearch Service