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

Breve descrição

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

"Your database generated a SQL exception. This can be caused by query timeouts, resource constraints, unexpected DDL alterations before or during a query, and other database errors. Check your database settings and your query, and try again."

É possível 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 Suite não tem permissão para acessar os dados.
• Seu perfil de serviço do Quick Suite 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.

Observação: 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 Como faço para resolver erros de tempo limite de consulta no Quick Sight?

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

Você recebe uma das seguintes mensagens de erro:

"Communications link failure The last packet successfully received from the server was #### milliseconds ago. The last packet sent successfully to the server was #### milliseconds ago."

-ou-

"Communications link failure The last packet sent successfully to the server was 0 milliseconds ago. The driver has not received any packets from the server."

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 Configuração de conexões VPC no Amazon Quick Suite.

Sua conta do Quick Suite 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 o acesso do Quick Suite aos serviços da AWS.

Conclua as etapas a seguir:

1. Abra o console do Quick Suite.
2. Escolha seu nome de usuário na barra de aplicações e selecione Gerenciar Quick Suite.
3. No painel de navegação, em Permissões, escolha Recursos da AWS.
4. Configure o acesso às fontes de dados compatíveis suportadas.

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 do Organizations 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 Suite 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 Suite 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 Suite à 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

Cotas para consultas SQL diretas

How can I create a private connection from Amazon Quick Suite 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 Suite 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 o Amazon Quick Sight