Wie behebe ich SQL-Ausnahmefehler bei benutzerdefinierten SQL-Datenquellen in Quick Suite?

Kurzbeschreibung

Du erhältst die folgende Fehlermeldung, wenn Quick Suite 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.
• Das Quick-Suite-Konto hat keine Berechtigung für den Zugriff auf die Daten.
• Die Quick-Suite-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.

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

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

Wenn die vorherige Fehlermeldung im Dashboard angezeigt wird, navigiere zu Underlying analysis (Zugrunde liegende Analyse) und wähle Concerned visual(s) (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 Abfrage-Timeout-Fehler in Quick Suite 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 #### milliseconds ago. The last packet sent successfully to the server was #### 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 VPC-Verbindungen in Amazon Quick Suite konfigurieren.

Das Quick-Suite-Konto hat keine Berechtigung für den Zugriff auf die Daten

Wenn beim Versuch, auf Daten in einem AWS-Service zuzugreifen, ein SQL-Ausnahmefehler auftritt, überprüfe deinen Quick-Suite-Zugriff auf AWS-Services.

Gehe wie folgt vor:

1. Öffne die Quick-Suite-Konsole.
2. Wähle in der Anwendungsleiste deinen Benutzernamen aus und wähle dann Manage Quick Suite (Quick Suite verwalten).
3. Wähle im Navigationsbereich unter Berechtigungen AWS-Ressourcen aus.
4. Konfiguriere den Zugriff auf die unterstützten Datenquellen.

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

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

Die Quick-Suite-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.“

Gehe wie folgt vor, um sicherzustellen, dass die Quick-Suite-Servicerolle über die richtigen AWS-KMS-Schlüsselberechtigungen verfügt:

1. Verwende die AWS Identity and Access Management (IAM)-Konsole, um den ARN der Quick-Suite-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 Überblick und suche dann die AWS-KMS-Schlüssel-ID.
3. Führe den AWS-CLI-Befehl create-grant aus, um den ARN der Quick-Suite-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 verwendest nicht unterstützte Datentypen oder Funktionen

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 erstelle ich eine private Verbindung von Amazon Quick Suite zu einem Amazon-Redshift-Cluster oder einer Amazon-RDS-DB-Instance, der/die sich in einem privaten Subnetz befindet?

Aktionen, Ressourcen und Bedingungsschlüssel für Amazon Quick Suite