¿Cómo soluciono los errores de excepción de origen de datos de SQL personalizado en QuickSight?

Descripción corta

Recibe el siguiente mensaje de error cuando Amazon QuickSight consulta o actualiza el origen de datos de 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."

Para obtener información más detallada sobre la causa del error, elija Show Details (Mostrar detalles) en el mensaje de error.

Es posible que reciba el mensaje de error por los siguientes motivos habituales:

• El tiempo de espera de la consulta se agota.
• Hay un problema con la conexión de VPC al origen de datos.
• La cuenta de QuickSight no tiene permiso para acceder a los datos.
• El rol de servicio de QuickSight no tiene permiso para acceder a la clave administrada de AWS Key Management Service (AWS KMS).
• Está utilizando tipos de datos o funciones no admitidos.

Resolución

Si se producen errores al ejecutar comandos de la Interfaz de la línea de comandos de AWS (AWS CLI), asegúrese de que utiliza la versión más reciente de la AWS CLI.

El tiempo de espera de la consulta se agota

Si se agota el tiempo de espera de la consulta de SQL personalizada, simplifique la consulta para optimizar el tiempo de ejecución. Para ver otras soluciones de tiempo de espera de consultas, lea ¿Cómo resuelvo los problemas relacionados con el tiempo de espera de las consultas en QuickSight?

Hay un problema con la conexión de VPC al origen de datos

Los detalles del mensaje de error incluyen lo siguiente:

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.

o

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.

Si no puede conectar la VPC con los orígenes de datos, revise el grupo de seguridad de red en la VPC que está asociada al recurso. Para obtener más información, consulte Connecting to a VPC with Amazon QuickSight (Conectarse a una VPC con Amazon QuickSight).

La cuenta de QuickSight no tiene permiso para acceder a los datos

Si se produce un error de excepción de SQL cuando intenta acceder a los datos de un servicio de AWS, revise la configuración de seguridad y permisos de QuickSight.

1. Abra la consola de Amazon QuickSight.
2. Elija Manage QuickSight (Administrar QuickSight).
3. Elija Security & Permissions (Seguridad y permisos).
4. Configure el acceso a los servicios compatibles que usa.

Si usa AWS Organizations, es posible que reciba el mensaje de error si no tiene asignadas las políticas de control de servicios (SCP) necesarias. Pida al administrador de AWS Organizations que revise la configuración de SCP para verificar los permisos que se le han asignado. Si es administrador de AWS Organizations, consulte Creating, updating, and deleting service control policies (Crear, actualizar y eliminar políticas de control de servicios).

El rol de servicio de QuickSight no tiene permiso para acceder a la clave administrada de AWS KMS

Aparece el siguiente error:

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

Asegúrese de que el rol de servicio de QuickSight tenga los permisos de clave de AWS KMS correctos.

1. Use la consola de AWS Identity and Access Management (IAM) para localizar el ARN del rol de servicio de QuickSight.
2. Use la consola de Amazon Simple Storage Service (Amazon S3) para buscar el ARN de la clave de AWS KMS.
   Vaya al bucket que contiene el archivo de datos.
   Elija la pestaña Overview (Información general) y busque KMS key ID (ID de la clave de KMS).
3. Agregue el ARN del rol de servicio de QuickSight a la política de claves de KMS.

Ejecute el comando create-grant de AWS CLI:

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

Nota: Reemplace aws_kms_key_arn por el ARN de la clave de AWS KMS y quicksight_role_arn por el ARN del rol de servicio de QuickSight.

Está usando tipos de datos o funciones no admitidos

Si intenta importar un tipo de datos no admitido o usa una función de SQL no compatible, recibirá un error de excepción de SQL. Para resolver este problema, revise el origen de datos de SQL a fin de determinar si se admite el tipo de datos o función de SQL.

Para ver qué se admite, consulte los siguientes recursos:

• Supported data types from other data sources (Tipos de datos compatibles de otros orígenes de datos)
• Supported data types and values (Tipos de datos y valores admitidos)
• Functions by category (Funciones por categoría)

---

Información relacionada

Quotas for direct SQL queries (Cuotas para consultas SQL directas)

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? (¿Cómo puedo crear una conexión privada de Amazon QuickSight a un clúster de Amazon Redshift o una instancia de base de datos de Amazon Relational Database Service [Amazon RDS] que se encuentre en una subred privada?)

Actions, resources, and condition keys for Amazon QuickSight (Acciones, recursos y claves de condición de Amazon QuickSight)