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 및 레거시 Elasticsearch OSS를 최대 7.10까지 지원합니다.

해결 방법

사용 사례에 따라 다음 문제 해결 단계를 수행합니다.

지원되지 않는 엔진 버전 오류

OpenSearch Service 도메인에 연결할 때 다음 오류가 발생할 수 있습니다.

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

이 오류는 OpenSearch 서비스 도메인에서 호환 모드가 활성화되지 않은 경우에 발생합니다. OpenSearch 버전 1.0에는 호환 모드 활성화(Enable compatibility mode)라는 도메인 설정이 도입되었습니다. 일부 OpenSearch Service 클라이언트 및 플러그인은 연결하기 전에 클러스터 버전을 확인합니다. 호환 모드는 OpenSearch 서비스가 해당 버전을 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"
     }
}

연결 오류 - 금지됨(forbidden)

OpenSearch Service 도메인에서 OpenSearch Dashboards에 세분화된 액세스 제어를 활성화했다면 다음과 같은 오류가 발생할 수 있습니다.

GENERAL_SQL_EXCEPTION. Connection error forbidden

이 오류는 QuickSight Service 역할이 OpenSearch 역할에 매핑되지 않았기 때문에 발생합니다.

이 오류를 해결하려면 지침에 따라 QuickSight에서 액세스를 허용하도록 도메인에 권한을 추가합니다.