Como posso solucionar erros de conexão ao conectar um domínio do Amazon OpenSearch Service ao QuickSight?

Breve descrição

Para conectar o QuickSight ao domínio do Amazon OpenSearch, certifique-se de que:

• a versão do domínio é 7.7 ou superior;
• a versão do OpenSearch é 1.0 ou superior;
• o domínio do OpenSearch Service está na mesma região e conta da AWS do QuickSight.

Observação: o Amazon OpenSearch Service oferece suporte ao OpenSearch e ao Elasticsearch OSS legado até a versão 7.10.

Resolução

Siga estas etapas de solução de problemas para o caso de uso.

Erro de versão de mecanismo não compatível

Ao se conectar a um domínio do OpenSearch Service, pode ocorrer o seguinte erro:

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

Esse erro ocorre quando o modo de compatibilidade não está habilitado no domínio do OpenSearch Service. O OpenSearch versão 1.0 introduz uma configuração de domínio denominada Enable compatibility mode (Habilitar modo de compatibilidade). Alguns clientes e plug-ins do OpenSearch Service verificam a versão do cluster antes de se conectar. O modo de compatibilidade define o OpenSearch Service para informar a versão como 7.10 para que esses clientes continuem funcionando. Quando o modo compatível está habilitado, o QuickSight identifica a versão correta e a conexão é estabelecida com êxito.

Para ativar o modo de compatibilidade, execute o seguinte comando:

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

Erro de cursor não habilitado ou impossibilidade de preparar esta tabela

Ao importar os dados de domínio do OpenSearch Service para o SPICE, você pode receber um dos seguintes erros:

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

-ou-

Unable to prepare this table

Para habilitar o cursor SQL no domínio do OpenSearch Service, execute o seguinte comando:

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

Erro de conexão proibida

Se você tiver controle de acesso refinado habilitado no OpenSearch Dashboards no domínio do OpenSearch Service, pode ocorrer o seguinte erro:

GENERAL_SQL_EXCEPTION. Connection error forbidden

Esse erro ocorre porque o perfil de serviço QuickSight não está mapeado para uma função do OpenSearch Service.

Para resolver esse erro, siga as instruções para adicionar permissões a um domínio para conceder acesso no QuickSight.

---

Informações relacionadas

Usar o Amazon OpenSearch Service com o Amazon QuickSight

Fontes de dados compatíveis

Conectar uma VPC ao Amazon QuickSight

Melhores práticas operacionais para o Amazon OpenSearch Service