Compréhension et résolution des erreurs reçues à partir de WebHCat sur HDInsight
Découvrez les erreurs reçues lors de l’utilisation de WebHCat avec HDInsight et comment les résoudre. WebHCat est utilisé en interne par les outils côté client tels qu’Azure PowerShell et Data Lake Tools pour Visual Studio.
Présentation de WebHCat
WebHCat est une API REST pour HCatalog, une couche de gestion de table et de stockage pour Apache Hadoop. WebHCat est activé par défaut sur les clusters HDInsight et est utilisé par différents outils pour envoyer des tâches, obtenir le statut d’une tâche, etc. sans se connecter au cluster.
Modification de la configuration
Plusieurs des erreurs répertoriées dans ce document se produisent car une limite maximale configurée a été dépassée. Lorsque l’étape de résolution mentionne que vous pouvez modifier une valeur, utilisez Apache Ambari (web ou API REST) pour modifier la valeur. Pour plus d’informations, consultez Gestion des clusters HDInsight à l’aide d’Apache Ambari
Configuration par défaut
Le dépassement des valeurs par défaut suivantes peut entraîner une baisse des performances de WebHCat ou des erreurs :
| Paramètre | Résultat | Valeur par défaut |
|---|---|---|
| [yarn.scheduler.capacity.maximum-applications][maximum-applications] | Nombre maximal de tâches pouvant être actives simultanément (en attente ou en cours d’exécution) | 10 000 |
templeton.exec.max-procs |
Nombre maximal de demandes pouvant être traitées simultanément | 20 |
| [mapreduce.jobhistory.max-age-ms][max-age-ms] | Nombre de jours pendant lesquels l’historique des tâches est conservé. | sept jours |
Trop de demandes
Code d’état HTTP : 429
| Cause | Résolution |
|---|---|
| Vous avez dépassé le nombre maximal de demandes simultanées prises en charge par WebHCat par minute (20 par défaut) | Réduisez votre charge de travail pour vérifier que vous n’avez pas dépassé le nombre maximal de demandes simultanées ou pour augmenter la limite de demandes simultanées en modifiant templeton.exec.max-procs. Pour en savoir plus, consultez la section Modification de la configuration |
Serveur non disponible
Code d’état HTTP : 503
| Cause | Résolution |
|---|---|
| Ce code d’état se produit généralement lors du basculement entre le HeadNode principal et secondaire du cluster. | Veuillez patienter deux minutes, puis recommencez l’opération. |
Contenu de requête erroné : impossible de trouver le travail
Code d’état HTTP : 400
| Cause | Résolution |
|---|---|
| Les informations détaillées de la tâche ont été nettoyées par la tâche de nettoyage de l’historique | La période de rétention par défaut de l’historique des travaux est de 7 jours. La période de rétention par défaut peut être changée en modifiant mapreduce.jobhistory.max-age-ms. Pour en savoir plus, consultez la section Modification de la configuration |
| Le travail a été tué en raison d’un basculement | Veuillez patienter deux minutes avant de renvoyer la tâche |
| ID de travail utilisé non valide | Vérifiez l’ID de travail |
Passerelle incorrecte
Code d’état HTTP : 502
| Cause | Résolution |
|---|---|
| Le nettoyage de la mémoire interne coïncide avec le processus de WebHCat | Veuillez attendre que le nettoyage de la mémoire se termine ou redémarrez le service WebHCat |
| Expiration du délai d’attente d’une réponse du service Resource Manager. Cette erreur peut se produire lorsque le nombre d’applications actives dépasse le nombre maximal configuré (10 000 par défaut) | Veuillez attendre que les tâches en cours d’exécution se terminent ou augmentez la limite de tâches simultanées en modifiant yarn.scheduler.capacity.maximum-applications. Pour en savoir plus, consultez la section Modification de la configuration. |
Tentative de récupération de toutes les tâches par le biais de l’appel GET /jobs lorsque Fields est défini sur * |
Ne récupérez pas tous les détails des tâches. Utilisez plutôt jobid pour récupérer uniquement les détails des tâches dont l’ID a une valeur supérieure à un ID de tâche particulier. Ou, n’utilisez pas Fields |
| Le service WebHCat est arrêté pendant le basculement du HeadNode | Veuillez patienter deux minutes, puis recommencez l’opération |
| Plus de 500 tâches en attente ont été envoyées via WebHCat | Veuillez patienter le temps que les tâches en attente se terminent avant d’envoyer d’autres tâches |
Étapes suivantes
Si votre problème ne figure pas dans cet article ou si vous ne parvenez pas à le résoudre, utilisez un des canaux suivants pour obtenir de l’aide :
Obtenez des réponses de la part d’experts Azure en faisant appel au Support de la communauté Azure.
Connectez-vous à @AzureSupport, le compte Microsoft Azure officiel pour améliorer l’expérience client. Connexion de la communauté Azure aux ressources appropriées : réponses, support technique et experts.
Si vous avez besoin d’une aide supplémentaire, vous pouvez envoyer une requête de support à partir du Portail Microsoft Azure. Sélectionnez Support dans la barre de menus, ou ouvrez le hub Aide + Support. Pour plus d’informations, consultez Création d’une demande de support Azure. L’accès au support relatif à la gestion et à la facturation des abonnements est inclus avec votre abonnement Microsoft Azure. En outre, le support technique est fourni avec l’un des plans de support Azure.