了解並解決 HDInsight 上從 WebHCat 收到的錯誤

了解搭配 HDInsight 使用 WebHCat 時遇到的錯誤，以及如何解決它們。 WebHCat 是由用戶端工具 (例如 Azure PowerShell 與 Data Lake Tools for Visual Studio) 在內部使用。

什麼是 WebHCat？

WebHCat 是適用於 HCatalog (Apache Hadoop 的資料表和儲存體管理層) 的 REST API。 WebHCat 預設會在 HDInsight 叢集上啟用，並由各種工具用來提交工作、取得工作狀態等，而不需登入叢集。

因為已超過設定的上限，而發生本文件中所列的幾個錯誤。當解決步驟提到您可以變更值時，請使用 Apache Ambari (Web 或 REST API) 來修改此值。如需詳細資訊，請參閱使用 Apache Ambari 管理 HDInsight

如果超過下列預設值，可能會使得 WebHCat 效能變差或導致發生錯誤：

設定	作用	預設值
[yarn.scheduler.capacity.maximum-applications][maximum-applications]	可以同時為作用中 (擱置或執行中) 的工作數目上限	10,000
`templeton.exec.max-procs`	可以同時提供服務的要求數目上限	20
[mapreduce.jobhistory.max-age-ms][max-age-ms]	將保留作業歷程記錄的天數	7 天

HTTP 狀態碼：429

原因	解決方案
您已超出 WebHCat 每分鐘提供服務的並行要求上限 (預設值為 20)	減少您的工作負載以確保不會提交超過並行要求數目上限，或藉由修改 `templeton.exec.max-procs`，來提高並行要求限制。如需詳細資訊，請參閱修改組態。

HTTP 狀態碼：503

原因	解決方案
此狀態碼通常發生於叢集的主要和次要 HeadNode 間的容錯移轉期間	等候兩分鐘，然後重試作業

HTTP 狀態碼：400

原因	解決方案
工作歷程記錄清除器已清除工作詳細資料	工作歷程記錄的預設保留期間為七天。您可以透過修改 `mapreduce.jobhistory.max-age-ms` 來變更預設保留期間。如需詳細資訊，請參閱修改組態。
作業因為容錯移轉而遭到刪除	最多重試工作提交兩分鐘
已使用無效的作業識別碼	檢查作業識別碼是否正確

HTTP 狀態碼：502

原因	解決方案
內部記憶體回收會發生於 WebHCat 程序中	等候記憶體回收完成，或重新啟動 WebHCat 服務
等候 ResourceManager 服務回應時逾時。此錯誤發生於作用中應用程式的數目達到設定的最大值時 (預設值為 10,000)	等候目前執行中的工作完成，或修改 `yarn.scheduler.capacity.maximum-applications`以提高並行工作限制。如需詳細資訊，請參閱修改組態一節。
嘗試在 `Fields` 設定為 `*` 時透過 GET /jobs 呼叫擷取所有作業	不要擷取所有作業詳細資料。請改為使用 `jobid` 只擷取大於特定作業識別碼的作業詳細資料。或者，不要使用 `Fields`
WebHCat 服務在 HeadNode 容錯移轉期間關閉	等候兩分鐘，然後重試作業
有 500 個以上透過 WebHCat 提交的擱置工作	等到目前擱置的工作完成，再送出更多工作

如果您沒有看到您的問題，或無法解決您的問題，請瀏覽下列其中一個管道以取得更多支援：

透過 Azure 社群支援獲得由 Azure 專家所提供的解答。
連線至 @AzureSupport，這是用來改善客戶體驗的官方 Microsoft Azure 帳戶。將 Azure 社群連線到正確的資源：解答、支援和專家。
如果需要更多協助，您可在 Azure 入口網站提交支援要求。從功能表列中選取 [支援] 或開啟 [說明 + 支援] 中樞。如需詳細資訊，請參閱如何建立 Azure 支援要求。 Microsoft Azure 訂用帳戶包括訂用帳戶管理及帳務支援的存取權，而技術支援由其中一項 Azure 支援方案提供。