當你在 Azure Data Explorer 中操作儀表板時，磚塊可能會顯示錯誤而非視覺化。 這些錯誤會被分類，幫助你了解問題類型並決定下一步。 每種錯誤類型代表查詢、資料擷取或渲染過程中發生失敗的不同階段。
了解磚錯誤類型
以下各節將說明常見的瓦片錯誤類別、其含義，以及一般處理方式。
拒絕存取
該磁磚無法存取或擷取底層資料來源的資料。 此錯誤發生在使用者未取得存取資料來源的權限時。
怎麼辦：
- 確認資料來源是否存在且可取得。
- 確認你有權限存取該資料來源。
- 確認可用狀態後，再試著重新整理。
語法錯誤
磁磚中使用的查詢包含無效語法，無法解析。 此錯誤發生在編輯查詢後或建立新圖塊時。
怎麼辦：
- 檢視查詢是否有語法問題，例如缺少運算子或無效表達式。
- 在查詢編輯器中驗證查詢。
- 如果錯誤在修改後出現，請還原最近的變更。
語意錯誤
查詢在語法上有效，但使用了無效的參考或邏輯。 當查詢指向不存在的資料表、欄位或不相容的資料型態時，會發生此錯誤。
怎麼辦：
- 確保有參考的資料表和欄位存在。
- 檢查是否有重新命名或刪除的物件。
- 驗證查詢邏輯與資料型別。
- 更新查詢以符合目前的架構。
網路錯誤
儀表板與後端服務的連線中斷了。 此錯誤是因為暫時性的連線問題或服務中斷所致。
怎麼辦：
- 檢查你的網路連線。
- 重新整理儀錶板。
- 如果問題是暫時性的，過一陣子再試一次。
- 如果問題持續，請檢查服務健康狀況或聯絡客服。
視覺格式問題
因為設定或格式問題，磁磚無法渲染視覺效果。 當查詢成功執行但視覺顯示無法正確時，會發生這個問題。
怎麼辦：
- 檢視視覺設定，例如欄位分配和格式規則。
- 確保必填欄位皆有填寫。
- 簡化或重置視覺配置。
- 如果需要，可以重現視覺效果。
發生錯誤
發生了一個不符合上述類別的一般錯誤。 這種通用錯誤可能因各種原因而發生，例如未預期的例外或未處理的情況。
怎麼辦：
- 請查看錯誤訊息，以取得詳細資料。
- 檢視圖塊、查詢或資料來源的最新變更。
- 試著刷新儀表板。
- 如果問題依舊，請聯絡客服並提供錯誤細節。
從錯誤訊息中獲取更多細節
當方塊錯誤發生時，將滑鼠移到方塊上方即可顯示 「詳情 」按鈕。 點選此按鈕可獲得更多錯誤資訊，包括錯誤代碼及有助於辨識根本原因的訊息。
例如：
一般故障排除方法
如果你不確定該如何繼續：
- 重新整理儀表板以排除暫時性問題。
- 檢查其他地磚：
- 如果多個磁磚都失敗，可能是資料來源或服務出了問題。
- 如果有一個圖塊失敗，很可能是查詢或設定問題。
- 檢視近期變更：
- 查詢編輯
- 資料來源更新
- 權限變更
- 盡可能在編輯器中驗證查詢。
- 如果問題涉及存取權限或共用資源，請聯絡你的管理員或資料擁有者。