Comment puis-je résoudre les erreurs de quota de service dans Athena ?

Brève description

Si vos requêtes échouent dans Athena en raison d'erreurs de quota de service, il se peut que vous receviez l'une des réponses d'erreur suivantes :

• TooManyRequestsException
• ThrottlingException
• Expiration de la requête
• Échec de QueryString

Pour vérifier les valeurs par défaut des points de terminaison et des quotas Athena pour les différentes régions AWS, consultez la section Quotas de service.

Résolution

Remarque : Avant de commencer, vérifiez vos quotas Athena actuels.

TooManyRequestsException

Un quota de requêtes DML ou DDL contient des requêtes en cours d'exécution et en file d'attente. Si vous envoyez un nombre de requêtes supérieur à la limite spécifiée pour votre requête DML ou DDL, une réponse d'erreur TooManyRequestsException s'affiche. Les requêtes DDL courantes dans Athena incluent ALTER TABLE ADD PARTITION, CREATE TABLE et DROP. Les requêtes DML courantes dans Athena incluent SELECT, CREATE TABLE AS (CTAS) et INSERT INTO.

Pour vérifier la file d'attente actuelle, utilisez l'une des méthodes suivantes :

Remarque : Si des erreurs surviennent lorsque vous exécutez des commandes de l’interface de la ligne de commande AWS (AWS CLI), consultez la section Résoudre les erreurs liées à l’AWS CLI. Vérifiez également que vous utilisez bien la version la plus récente de l’AWS CLI.

• Ouvrez la console Athena, puis accédez à l'onglet requêtes récentes pour afficher toutes les requêtes actives.
• Exécutez la commande list-query-executions de l'AWS CLI pour afficher tous les ID de requêtes disponibles.

Remarque : Lorsque vous augmentez la simultanéité des requêtes, vous pouvez soumettre davantage de requêtes, mais vous ne disposez pas d’un nombre plus élevé de ressources pour les requêtes. Les requêtes restent en file d'attente jusqu'à ce que des ressources soient disponibles dans Athena pour les exécuter.

Pour résoudre cette erreur, utilisez la capacité allouée d'Athena pour augmenter la simultanéité des requêtes, gérer les charges de travail qui accèdent à la capacité et partager la capacité entre les charges de travail. Pour plus d'informations, consultez la section Gestion de la capacité de traitement des requêtes. Pour plus d'informations sur le prix des réserves de capacité, consultez la section Tarification Amazon Athena.

Pour un dépannage plus approfondi, consultez la section Comment puis-je résoudre l'erreur TooManyRequestsException dans Amazon Athena ?

ThrottlingException

Athena utilise des quotas d'appels d'API par compte AWS. Si vous dépassez vos quotas d'API, un message d'erreur similaire au message suivant s’affiche :

« ClientError : Une erreur s'est produite (ThrottlingException) lors de l'appel de l'opération <API_nom> : Taux dépassé. »

Pour résoudre cette erreur, réduisez la fréquence des appels d'API et utilisez la logique de nouvelle tentative. Pour plus d'informations, consultez la section Logique de nouvelle tentative de la rubrique Gestion et surveillance de la limitation des API dans vos charges de travail.

Expiration de la requête

Un délai d'expiration est appliqué lorsqu'une requête dépasse la limite de temps prédéfinie. Pour les requêtes DML, la limite de temps prédéfinie est de 30 minutes. Pour résoudre cette erreur, consultez la section Comment puis-je résoudre les erreurs « Expiration de la requête » dans Athena ?

Échec de QueryString

La longueur maximale de la chaîne de requête dans Athena est de 262 144 octets (B) et vous ne pouvez pas ajuster le quota. Pour éviter l'échec d'une chaîne de requête, divisez les requêtes longues en requêtes de plus petite taille. Pour plus d'informations, consultez la section Comment puis-je augmenter la longueur maximale des chaînes de requête dans Amazon Athena ?