Come posso risolvere gli errori di eccezione SQL con origini dati SQL personalizzate in QuickSight?

Breve descrizione

Quando QuickSight interroga o aggiorna l'origine dati SQL, viene visualizzato il seguente messaggio di errore:

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

È possibile che il messaggio di errore precedente venga visualizzato per i seguenti motivi:

• La query è scaduta.
• Sussiste un problema con la connessione del cloud privato virtuale (VPC) all'origine dati.
• L'account QuickSight non dispone dell'autorizzazione necessaria per accedere ai dati.
• Il tuo ruolo di servizio QuickSight non è autorizzato ad accedere alla chiave del servizio di gestione delle chiavi (AWS KMS) gestita da AWS.
• Hai utilizzato tipi di dati o funzioni non supportati.

Per ulteriori informazioni sulla causa dell'errore, scegli Mostra dettagli sotto il messaggio di errore.

Se ricevi il messaggio di errore precedente durante l'aggiornamento del set di dati, i dettagli dell'errore sono disponibili in Riepilogo del set di dati. Scegli Stato Importazione non riuscita per maggiori informazioni.

Se nella dashboard viene visualizzato il messaggio di errore precedente, passa ad Analisi sottostante e scegli le visuali interessate. Osserva il set di dati che si trova nel riquadro sinistro dell'analisi, quindi visualizza il Riepilogo del set di dati.

Risoluzione

Nota: se ricevi messaggi di errore durante l'esecuzione dei comandi dell'interfaccia della linea di comando AWS (AWS CLI), consulta Troubleshooting errors for the AWS CLI (Risoluzione degli errori per AWS CLI). Inoltre, assicurati di utilizzare la versione più recente di AWS CLI.

La query è scaduta

Se la query SQL personalizzata scade, semplifica la query per ottimizzare il runtime. Per altre soluzioni relative al timeout delle query, consulta Come posso risolvere gli errori di timeout delle query in QuickSight?

C'è un problema con la connessione VPC all'origine dati

Ricevi uno dei seguenti messaggi di errore:

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

-oppure-

"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 riscontri problemi di connessione VPC alle origini dati, controlla il gruppo di sicurezza di rete nel VPC associato alla risorsa. Per ulteriori informazioni, consulta Connecting to a VPC with Amazon Quicksight.

L'account QuickSight non dispone dell'autorizzazione necessaria per accedere ai dati

Se riscontri un errore di eccezione SQL quando tenti di accedere ai dati in un servizio AWS, verifica le impostazioni di sicurezza e delle autorizzazioni di QuickSight.

Completa i seguenti passaggi:

1. Apri la console QuickSight.
2. Scegli Gestisci QuickSight.
3. Scegli Sicurezza e autorizzazioni.
4. Configura l'accesso alle origini dati supportate che utilizzi.

Se si utilizza AWS Organizations, l'errore viene visualizzato quando non vengono assegnate le policy di controllo dei servizi (SCP) necessarie. È consigliabile chiedere all'amministratore dell'organizzazione di controllare le autorizzazioni assegnate all'utente nelle impostazioni di SCP.

In qualità di amministratore delle organizzazioni, consulta Update a service control policy (SCP) (Aggiornamento delle policy di controllo dei servizi).

Il ruolo di servizio QuickSight non è autorizzato ad accedere alla chiave KMS gestita da AWS

Verrà visualizzato l'errore seguente:

"If you are encrypting query results with KMS key, please ensure you are allowed to access your KMS key."

Per confermare che il ruolo del servizio QuickSight disponga delle autorizzazioni per la chiave AWS KMS corrette, completa i seguenti passaggi:

1. Utilizza la console AWS Identity and Access Management (IAM) per individuare l'ARN del ruolo del servizio QuickSight.
2. Utilizza la console Amazon Simple Storage Service (Amazon S3) per trovare l'ARN per la chiave AWS KMS. Vai al bucket contenente il file di dati. Scegli la scheda Panoramica, quindi individua l'ID chiave KMS AWS.
3. Esegui il comando AWS CLI create-grant per aggiungere l'ARN del ruolo di servizio QuickSight alla policy della chiave AWS KMS:

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

   Nota: sostituisci aws_kms_key_arn con l'ARN della chiave AWS KMS e quicksight_role_arn con l'ARN del ruolo di servizio QuickSight.

I tipi di dati o le funzioni in uso non sono supportati

Se cerchi di importare un tipo di dati non supportato o di utilizzare una funzione SQL non supportata, viene visualizzato un errore di eccezione SQL. Per risolvere questo problema, verifica l'origine dati SQL per determinare se il tipo di dati o la funzione SQL sono supportati.

Per vedere cosa è supportato, consulta le seguenti risorse:

• Supported data types from external data sources (Tipi di dati supportati da origini dati esterne)
• Supported data types and values (Valori e tipi di dati supportati)
• Functions by category (Funzioni per categoria)

Informazioni correlate

Quotas for direct SQL queries

How can I create a private connection from Amazon QuickSight to an Amazon Redshift cluster or an Amazon RDS DB instance that's in a private subnet? (Come posso creare una connessione privata da Amazon QuickSight a un cluster Amazon Redshift o a un'istanza database Amazon RDS che si trova in una sottorete privata?)

Actions, resources, and condition keys for Amazon QuickSight (Azioni, risorse e chiavi di condizione per Amazon QuickSight)