如何對 OpenSearch Service 網域到 QuickSight 的連線錯誤進行疑難排解？

簡短說明

將 QuickSight 連線至 OpenSearch Service 網域之前，請驗證下列條件：

• 您的網域為 7.7 版或更高版本。
• 您的 OpenSearch Service 版本為 1.0 或更高版本。
• 您的 OpenSearch Service 網域位於與 QuickSight 相同的 AWS 區域和帳戶。

注意事項： Amazon OpenSearch Service 支援 OpenSearch 和舊版 Elasticsearch OSS 最高至 7.10 版。

解決方法

遵循適用於使用案例的這些疑難排解步驟。

不支援的引擎版本錯誤

連線至 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 存取。

相關資訊

將 Amazon OpenSearch Service 與 Amazon QuickSight 搭配使用

支援的資料來源

使用 Amazon QuickSight 連線至 VPC

Amazon OpenSearch Service 的最佳操作實務