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

5 minuto de leitura
0

Tentei usar fontes de dados SQL personalizadas no Amazon QuickSight, mas recebi a mensagem de erro “Seu banco de dados gerou uma exceção SQL.”

Breve descrição

Você recebe a seguinte mensagem de erro quando o QuickSight 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 QuickSight não tem permissão para acessar os dados.
  • Sua função de serviço do QuickSight não tem permissão para acessar a chave do AWS Managed Key Management Service (AWS KMS).
  • Você usou funções ou tipos de dados 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 erros 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 Como faço para resolver erros de tempo limite de consulta no QuickSight?

Há um problema com a conexão da VPC com 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 com suas fontes de dados, verifique o grupo de segurança de rede na VPC associado ao recurso. Para obter mais informações, consulte Connecting to a VPC with Amazon QuickSight.

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 QuickSight.

Conclua as seguintes etapas:

  1. Abra o console do QuickSight.
  2. Escolha Gerenciar o QuickSight.
  3. Escolha 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 administrador de organizações, consulte Atualizar uma política de controle de serviços (SCP).

Seu perfil de serviço do QuickSight 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 KMS, certifique-se de ter permissão para acessar sua chave KMS.”

Para confirmar se a função de serviço do QuickSight tem as permissões de chave corretas do AWS KMS, conclua as seguintes etapas:

  1. Use o console do AWS Identity and Access Management (IAM) para localizar o ARN da função de serviço QuickSight.
  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. Escolha a 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 QuickSight à 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 da sua chave do AWS KMS e quicksight_role_arn pelo ARN de seu perfil de serviço do QuickSight.

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:

Informações relacionadas

Cotas para consultas SQL diretas

Como posso criar uma conexão privada do Amazon QuickSight com 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 o Amazon QuickSight

AWS OFICIAL
AWS OFICIALAtualizada há 3 meses