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

O WebHCat é uma API REST para , uma tabela e uma camada de gerenciamento de armazenamento para HCatalogo 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 do histórico de trabalho	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 devido a 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.