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

Breve descrizione

Quando Quick Sight esegue query su un'origine dati SQL o la aggiorna, ricevi 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.
• È presente un problema di connessione del cloud privato virtuale (VPC) all'origine dati.
• L'account Quick Sight non ha l'autorizzazione necessaria per accedere ai dati.
• Il ruolo di servizio per Quick Sight non è autorizzato ad accedere alla chiave del Servizio AWS di gestione delle chiavi (AWS KMS).
• 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 errori quando esegui i comandi dell'Interfaccia della linea di comando AWS (AWS CLI), consulta 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, semplificala per ottimizzare il runtime. Per altre soluzioni al timeout delle query, consulta Come posso risolvere gli errori di timeout delle query in Quick Sight?

È presente un problema di connessione del 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 riguardanti la connessione del VPC alle origini dati, controlla il gruppo di sicurezza di rete del VPC associato alla risorsa. Per ulteriori informazioni, consulta Configuring VPC connections in Amazon Quick Sight (Configurazione di connessioni VPC in Amazon Quick Sight).

L'account Quick Sight non ha l'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 delle autorizzazioni e della sicurezza in Quick Sight.

Completa i seguenti passaggi:

1. Apri la console Quick Sight.
2. Scegli Gestisci Quick Sight.
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 di Organizations, consulta Aggiornare una policy di controllo dei servizi.

Il ruolo di servizio per Quick Sight non è autorizzato ad accedere alla chiave AWS KMS

Ricevi il seguente errore:

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

Per confermare che il ruolo di servizio per Quick Sight abbia le autorizzazioni per la chiave AWS KMS corrette, completa i seguenti passaggi:

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

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 (Quote per query SQL dirette)

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 Quick Sight a un cluster Amazon Redshift o a un'istanza database Amazon RDS che si trova in una sottorete privata?)

Azioni, risorse e chiavi di condizione per Amazon Quick Sight