Como resolvo erros de exceção de SQL com fontes de dados SQL personalizadas no Quick Sight?

Breve descrição

Você recebe a seguinte mensagem de erro quando o Quick Sight consulta ou atualiza sua fonte de dados SQL:

“Seu banco de dados gerou uma exceção SQL. Isso pode ser causado por tempos limite de consulta, restrições de recursos, alterações inesperadas de DDL antes ou durante uma consulta e outros erros do banco de dados. Verifique as configurações do banco de dados e sua consulta e tente novamente.”

Você pode receber a mensagem de erro anterior pelos seguintes motivos:

• O tempo limite da consulta foi atingido.
• Há um problema com a conexão da nuvem privada virtual (VPC) com sua fonte de dados.
• Sua conta do Quick Sight não tem permissão para acessar os dados.
• Seu perfil de serviço do Quick Sight não tem permissão para acessar a chave gerenciada pelo AWS Key Management Service (AWS KMS).
• Você usou tipos de dados ou funções não compatíveis.

Para obter informações sobre o que causou o erro, escolha Mostrar detalhes abaixo da mensagem de erro.

Se você receber a mensagem de erro anterior ao atualizar o conjunto de dados, poderá encontrar detalhes sobre o erro em Resumo do conjunto de dados. Escolha Falha na importação de status para obter mais informações.

Se a mensagem de erro anterior for exibida em seu painel, navegue até Análise subjacente e escolha Visuais preocupantes. Observe o conjunto de dados que está no painel esquerdo da análise e, em seguida, visualize o Resumo do conjunto de dados.

Resolução

Observação: se você receber erros ao executar comandos da AWS Command Line Interface (AWS CLI), consulte Solução de problemas da AWS CLI. Além disso, verifique se você está usando a versão mais recente da AWS CLI.

O tempo limite da consulta foi atingido

Se a consulta SQL personalizada atingir o tempo limite, simplifique a consulta para otimizar o runtime. Para outras soluções de tempo limite de consulta, consulte How do I resolve query timeout errors in Quick Sight? (Como faço para resolver erros de tempo limite de consulta no QuickSight?)

Há um problema com a conexão da VPC à sua fonte de dados

Você recebe uma das seguintes mensagens de erro:

“Falha no link de comunicação O último pacote recebido com sucesso do servidor foi há nnnn milissegundos. O último pacote enviado com sucesso para o servidor foi há nnnn milissegundos.”

-ou-

“Falha no link de comunicação O último pacote enviado com sucesso ao servidor foi há 0 milissegundos. O driver não recebeu nenhum pacote do servidor.”

Se você tiver problemas de conexão da VPC às suas fontes de dados, verifique o grupo de segurança de rede na VPC associada ao recurso. Para obter mais informações, consulte Connecting to a VPC with Amazon Quick Sight (Conectando-se a uma VPC com o Amazon Quick Sight).

Sua conta do QuickSight não tem permissão para acessar os dados

Se você tiver um erro de exceção de SQL ao tentar acessar dados em um serviço da AWS, verifique suas configurações de segurança e permissões do Quick Sight.

Conclua as etapas a seguir:

1. Abra o console do Quick Sight.
2. Clique em Gerenciar Quick Sight.
3. Selecione Segurança e permissões.
4. Configure o acesso às fontes de dados compatíveis suportadas que você usa.

Se você usa o AWS Organizations, receberá o erro quando as políticas de controle de serviços (SCPs) necessárias não forem atribuídas a você. Peça ao administrador da organização que verifique as permissões atribuídas a você em suas configurações de SCP.

Se você for um administrador do Organizations, consulte Atualizar uma política de controle de serviços (SCP).

Seu perfil de serviço do Quick Sight não tem permissão para acessar a chave KMS gerenciada pela AWS

Você recebe o seguinte erro:

“Se você estiver criptografando os resultados da consulta com a chave do KMS, certifique-se de ter permissão para acessar sua chave do KMS.”

Para confirmar se o perfil de serviço do Quick Sight tem as permissões de chave corretas do AWS KMS, conclua as seguintes etapas:

1. Use o console do AWS Identity and Access Management (AWS IAM) para localizar o ARN do perfil de serviço do Quick Sight.
2. Use o console do Amazon Simple Storage Service (Amazon S3) para encontrar o ARN da chave do AWS KMS. Vá até o bucket que contém seu arquivo de dados. Clique na guia Visão geral e localize o ID da chave do AWS KMS.
3. Execute o comando create-grant da AWS CLI para adicionar o ARN do perfil de serviço do Quick Sight à política de chaves do AWS KMS:

   aws kms create-grant --key-id aws_kms_key_arn --grantee-principal quicksight_role_arn --operations Decrypt

   Observação: substitua aws_kms_key_arn pelo ARN da sua chave do AWS KMS e quicksight_role_arn pelo ARN do seu perfil de serviço do Quick Sight.

Você usa tipos de dados ou funções não compatíveis

Se você tentar importar um tipo de dado não compatível ou usar uma função SQL não aceita, receberá um erro de exceção SQL. Para resolver esse problema, verifique a fonte de dados SQL para determinar se o tipo de dados ou a função SQL são compatíveis.

Para ver o que é compatível, consulte os seguintes recursos:

• Tipos de dados compatíveis de fontes de dados externas
• Tipos e valores de dados compatíveis
• Funções por categoria

Informações relacionadas

Quotas for direct SQL queries (Cotas para consultas SQL diretas)

How can I create a private connection from Amazon Quick Sight to an Amazon Redshift cluster or an Amazon RDS DB instance that's in a private subnet? (Como posso criar uma conexão privada do Amazon Quick Sight a um cluster do Amazon Redshift ou uma instância de banco de dados do Amazon RDS que esteja em uma sub-rede privada?)

Ações, recursos e chaves de condição para a Amazon Quick Sight