Wie behebe ich SQL-Ausnahmefehler mit benutzerdefinierten SQL-Datenquellen in QuickSight?

Kurzbeschreibung

Du erhältst die folgende Fehlermeldung, wenn QuickSight deine SQL-Datenquelle abfragt oder aktualisiert:

„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.“

Möglicherweise erhältst du die vorherige Fehlermeldung aus den folgenden Gründen:

• Bei der Abfrage wird ein Timeout ausgelöst.
• Es gibt ein Problem mit der Virtual Private Cloud (VPC)-Verbindung zur Datenquelle.
• Dein QuickSight-Konto hat keine Berechtigung zum Zugriff auf die Daten.
• Deine QuickSight-Servicerolle hat keine Berechtigung für den Zugriff auf den von AWS verwalteten Key Management Service (AWS KMS)-Schlüssel.
• Du hast nicht unterstützte Datentypen oder Funktionen verwendet.

Um Informationen über die Ursache des Fehlers zu erhalten, wähle Details einblenden unter der Fehlermeldung aus.

Wenn du beim Aktualisieren des Datensatzes die vorhergehende Fehlermeldung erhältst, findest du Details zum Fehler unter Zusammenfassung des Datensatzes. Wähle Status Import Failed (Status „Import fehlgeschlagen“), um weitere Informationen zu erhalten.

Wenn die vorherige Fehlermeldung in deinem Dashboard angezeigt wird, navigiere zu Underlying analysis (Zugrunde liegende Analyse) und wähle Betroffene Visualisierung(en) aus. Notiere dir den Datensatz, der sich im linken Bereich der Analyse befindet, und sieh dir dann die Zusammenfassung des Datensatzes an.

Lösung

Hinweis: Wenn du beim Ausführen von AWS Command Line Interface (AWS CLI)-Befehlen Fehlermeldungen erhältst, findest du weitere Informationen dazu unter Problembehandlung bei der AWS CLI. Stelle außerdem sicher, dass du die neueste Version der AWS CLI verwendest.

Bei der Abfrage wird ein Timeout ausgelöst

Wenn die benutzerdefinierte SQL-Abfrage ein Timeout verursacht, dann vereinfache die Abfrage, um die Laufzeit zu optimieren. Weitere Lösungen für Abfrage-Timeouts findest du unter Wie kann ich Fehler der Abfragezeitüberschreitung in QuickSight beheben?

Es gibt ein Problem mit der VPC-Verbindung zu deiner Datenquelle

Du erhältst eine der folgenden Fehlermeldungen:

„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.“

-oder-

„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.“

Wenn du Probleme mit der VPC-Verbindung zu den Datenquellen hast, überprüfe die Netzwerksicherheitsgruppe in der VPC, die mit der Ressource verbunden ist. Weitere Informationen findest du unter Verbindung zu einer VPC mit Amazon QuickSight herstellen.

Dein QuickSight-Konto hat keine Berechtigung zum Zugriff auf die Daten

Falls ein SQL-Ausnahmefehler auftritt, wenn du versuchst, auf Daten in einem AWS-Service zuzugreifen, dann überprüfe die QuickSight-Sicherheits- und Berechtigungseinstellungen.

Führe die folgenden Schritte aus:

1. Öffne die QuickSight-Konsole.
2. Wähle QuickSight verwalten.
3. Wähle Sicherheit und Berechtigungen aus.
4. Konfiguriere den Zugriff auf die unterstützten Datenquellen, die du verwendest.

Wenn du AWS Organizations verwendest, erhältst du die Fehlermeldung, wenn dir die erforderlichen Service-Kontrollrichtlinien (SCPs) nicht zugewiesen wurden. Bitte den Organizations-Administrator, die Berechtigungen zu überprüfen, die dir in deinen SCP-Einstellungen zugewiesen wurden.

Wenn du Organizations-Administrator:in bist, findest du weitere Informationen unter Aktualisieren einer Service-Kontrollrichtlinie (SCP).

Deine QuickSight-Servicerolle hat keine Berechtigung für den Zugriff auf den von AWS verwalteten KMS-Schlüssel

Du erhältst die folgende Fehlermeldung:

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

Um sicherzustellen, dass die QuickSight-Servicerolle über die richtigen AWS-KMS-Schlüsselberechtigungen verfügt, führe die folgenden Schritte aus:

1. Verwende die AWS Identity and Access Management (IAM)-Konsole, um den ARN der QuickSight-Servicerolle zu finden.
2. Verwende die Amazon Simple Storage Service (Amazon S3)-Konsole, um den ARN des AWS-KMS-Schlüssels zu finden. Gehe zu dem Bucket, der die Datendatei enthält. Wähle die Registerkarte Übersicht und suche dann die KMS-Schlüssel-ID.
3. Führe den AWS-CLI-Befehl create-grant aus, um den ARN der QuickSight-Servicerolle zur AWS-KMS-Schlüsselrichtlinie hinzuzufügen:

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

   Hinweis: Ersetze aws_kms_key_arn durch den ARN deines AWS-KMS-Schlüssels und quicksight_role_arn durch den ARN deiner QuickSight-Servicerolle.

Du hast nicht-unterstützte Datentypen oder Funktionen verwendet

Wenn du versuchst, einen nicht unterstützten Datentyp zu importieren oder eine nicht unterstützte SQL-Funktion zu verwenden, erhältst du einen SQL-Ausnahmefehler. Um dieses Problem zu beheben, überprüfe die SQL-Datenquelle, um festzustellen, ob der Datentyp oder die SQL-Funktion unterstützt wird.

Um zu sehen, was unterstützt wird, schaue dir die folgenden Ressourcen an:

• Unterstützte Datentypen aus externen Datenquellen
• Unterstützte Datentypen und Werte
• Funktionen nach Kategorie

Ähnliche Informationen

Kontingente für direkte SQL-Abfragen

Wie kann ich eine private Verbindung von Amazon QuickSight zu einem Amazon-Redshift-Cluster oder einer Amazon-RDS-DB-Instance herstellen, die sich in einem privaten Subnetz befindet?

Aktionen, Ressourcen und Bedingungsschlüssel für Amazon QuickSight