¿Cómo soluciono los errores de excepción de SQL con orígenes de datos SQL personalizados en QuickSight?

Descripción corta

Se muestra el siguiente mensaje de error cuando QuickSight consulta o actualiza el origen de datos 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».

Es posible que se muestre el mensaje de error anterior por los siguientes motivos:

• Se agota el tiempo de espera de la consulta.
• Hay un problema con la conexión de la nube virtual privada (VPC) al origen de datos.
• Su cuenta de QuickSight no tiene permiso para acceder a los datos.
• Su rol de servicio de QuickSight no tiene permiso para acceder a la clave de AWS Key Management Service (AWS KMS).
• Ha utilizado funciones o tipos de datos no admitidos.

Para obtener información sobre la causa del error, seleccione Mostrar detalles en el mensaje de error.

Si recibe el mensaje de error anterior al actualizar el conjunto de datos, puede encontrar detalles sobre el error en el resumen del conjunto de datos. Seleccione Estado: No se pudo importar para obtener más información.

Si el mensaje de error anterior aparece en su panel de control, vaya a Análisis subyacente y seleccione Elementos visuales relacionados. Anote el conjunto de datos que se encuentra en el panel izquierdo del análisis y, a continuación, consulte el resumen del conjunto de datos.

Resolución

Nota: Si se muestran errores al poner en marcha comandos de Interfaz de la línea de comandos de AWS (AWS CLI), consulte Solución de problemas de AWS CLI. Además, asegúrese de utilizar la versión más reciente de la AWS CLI.

Se agota el tiempo de espera de la consulta

Si se agota el tiempo de espera de la consulta SQL personalizada, simplifíquela para optimizar el tiempo de ejecución. Para ver otras soluciones de tiempo de espera de consultas, consulte ¿Cómo soluciono los errores de tiempo de espera de las consultas en QuickSight?

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

Es posible que reciba uno de los siguientes mensajes de error:

«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 tiene problemas de conexión de la VPC con sus orígenes de datos, compruebe el grupo de seguridad de red de la VPC que está asociado al recurso. Para obtener más información, consulte Connecting to a VPC with Amazon QuickSight.

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

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

Siga estos pasos:

1. Abra la consola de QuickSight.
2. Elija Administrar QuickSight.
3. Seleccione Seguridad y permisos.
4. Configure el acceso a los orígenes de datos compatibles que utiliza.

Si usa AWS Organizations, se muestra el error cuando no se le han asignado las políticas de control de servicios (SCP) necesarias. Pídale al administrador de AWS Organizations que revise los permisos que se le asignaron en la configuración de SCP.

Si es administrador de una organización, consulte Actualización de una política de control de servicio (SCP).

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

Se muestra el siguiente error:

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

Para confirmar que el rol de servicio de QuickSight tiene los permisos de clave de AWS KMS correctos, siga estos pasos:

1. Utilice la consola de AWS Identity and Access Management (IAM) para localizar el ARN del rol de servicio de QuickSight.
2. Utilice 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. Seleccione la pestaña Descripción general y, a continuación, localice el ID de la clave de AWS KMS.
3. Ejecute el comando create-grant de la AWS CLI para añadir el ARN del rol de servicio de QuickSight a la política de claves de AWS KMS:

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

   Nota: Sustituya aws_kms_key_arn por el ARN de su clave de AWS KMS y quicksight_role_arn por el ARN de su rol de servicio de QuickSight.

Uso de funciones o tipos de datos no compatibles

Si intenta importar un tipo de datos no compatible o utiliza una función SQL no compatible, se mostrará un error de excepción de SQL. Para resolver este problema, compruebe el origen de datos SQL para determinar si se admite el tipo de datos o de función SQL.

Para ver lo que es compatible, consulte los siguientes recursos:

• Tipos de datos compatibles de orígenes de datos externos
• Tipos de datos y valores compatibles
• Functions by category

Información relacionada

Cuotas para consultas de SQL directas

¿Cómo puedo crear una conexión privada de Amazon QuickSight para un clúster de Amazon Redshift o una instancia de base de datos de Amazon RDS que esté en una subred privada?

Acciones, recursos y claves de condición de Amazon QuickSight