Entenda e resolva erros recebidos do WebHCat no HDInsight
Saiba mais sobre erros recebidos ao usar o WebHCat com HDInsight e como resolvê-los. WebHCat é usado internamente por ferramentas de cliente como o Azure PowerShell e as Ferramentas do Data Lake para Visual Studio.
O que é o WebHCat
WebHCat é uma API REST para HCatalog, uma tabela e uma camada de gerenciamento de armazenamento para Apache Hadoop. O WebHCat é habilitado por padrão em clusters do HDInsight e é usado por várias ferramentas para enviar trabalhos, obter o status do trabalho e muito mais, sem fazer logon no cluster.
Modificando a configuração
Vários dos erros listados neste documento ocorrerem porque um máximo configurado foi excedido. Quando a etapa de resolução mencionar que você pode alterar um valor, use o Apache Ambari (Web ou API REST) para modificar o valor. Para obter mais informações, consulte Gerenciar o HDInsight usando o Apache Ambari
Configuração padrão
Se os seguintes valores padrão forem excedidos, isso poderá prejudicar o desempenho do WebHCat ou causar erros:
| Configuração | O que faz | Valor padrão |
|---|---|---|
| [yarn.scheduler.capacity.maximum-applications][maximum-applications] | O número máximo de trabalhos que podem estar ativos ao mesmo tempo (em execução ou pendentes) | 10.000 |
templeton.exec.max-procs |
O número máximo de solicitações que podem ser atendidas simultaneamente | 20 |
| [mapreduce.jobhistory.max-age-ms][max-age-ms] | O número de dias pelos quais o histórico de trabalhos é mantido | sete dias |
Número excessivo de solicitações
Código de status HTTP: 429
| Causa | Resolução |
|---|---|
| Você excedeu o máximo de solicitações simultâneas atendidas pelo WebHCat por minuto (o padrão é 20) | Reduza a carga de trabalho para garantir que não sejam enviadas mais do que o número máximo de solicitações simultâneas ou aumente o limite de solicitações simultâneas modificando templeton.exec.max-procs. Para obter mais informações, consulte Modificar a configuração |
Servidor indisponível
Código de status HTTP: 503
| Causa | Resolução |
|---|---|
| Esse código de status geralmente ocorre durante o failover entre o nó de cabeçalho primário e secundário para o cluster | Aguarde dois minutos e repita a operação |
Conteúdo da solicitação inválida: não foi possível encontrar o trabalho
Código de status HTTP: 400
| Causa | Solução |
|---|---|
| Os detalhes do trabalho foram limpos pelo limpador de histórico de trabalhos | O período de retenção padrão para o histórico do trabalho é de sete dias. O período de retenção padrão pode ser alterado modificando mapreduce.jobhistory.max-age-ms. Para obter mais informações, consulte Modificar a configuração |
| Trabalho morto por causa de um failover | Repita o envio do trabalho em até dois minutos |
| Foi usada uma ID de trabalho inválida | Verifique se a ID de trabalho está correta |
Gateway inválido
Código de status HTTP: 502
| Causa | Resolução |
|---|---|
| A coleta de lixo interna está ocorrendo no processo do WebHCat | Aguarde até que a coleta de lixo seja concluída ou reinicie o serviço do WebHCat |
| Tempo limite atingido ao aguardar uma resposta do serviço Resource Manager. Esse erro pode ocorrer quando o número de aplicativos ativos atinge o máximo configurado (padrão de 10.000) | Aguarde até que os trabalhos em execução no momento sejam concluídos ou aumente o limite de trabalhos simultâneos modificando yarn.scheduler.capacity.maximum-applications. Para obter mais informações, consulte a seção Modificar a configuração. |
Tentar recuperar todos os trabalhos por meio da chamada GET /jobs quando Fields está definido como * |
Não recupere todos os detalhes do trabalho. Em vez disso, use jobid para recuperar detalhes somente de trabalhos maiores que determinada ID de trabalho. Ou, não use Fields |
| O serviço do WebHCat está inativo durante o failover do HeadNode | Aguarde dois minutos e repita a operação |
| Há mais de 500 trabalhos pendentes enviados por meio do WebHCat | Aguarde até que os trabalhos pendentes no momento sejam concluídos antes de enviar mais trabalhos |
Próximas etapas
Se você não encontrou seu problema ou não conseguiu resolver seu problema, visite um dos seguintes canais para obter mais suporte:
Obtenha respostas de especialistas do Azure por meio do Suporte da Comunidade do Azure.
Conecte-se com @AzureSupport – a conta oficial do Microsoft Azure para aprimorar a experiência do cliente. Como se conectar à comunidade do Azure para os recursos certos: respostas, suporte e especialistas.
Se precisar de mais ajuda, poderá enviar uma solicitação de suporte do portal do Azure. Selecione Suporte na barra de menus ou abra o hub Ajuda + suporte. Para obter informações mais detalhadas, consulte Como criar uma solicitação de Suporte do Azure. O acesso ao Gerenciamento de assinaturas e ao suporte de cobrança está incluído na sua assinatura do Microsoft Azure, e o suporte técnico é fornecido por meio de um dos Planos de suporte do Azure.