跳轉到主要內容
Data Explorer 功能目前為公開預覽版。隨著我們持續收集意見反應
並針對客戶使用進行最佳化，預期此功能會持續變更。 Data Explorer 進階模式是針對更複雜的查詢和更深入的解析而設計，使用 Azure Data Explorer 查詢語言，這是一種針對臨機操作資料探索最佳化的類 SQL 語言。若要了解如何撰寫非技術性查詢，請參閱 開始使用 Data Explorer 基本模式 教學課程。

​
撰寫自訂查詢

若要開始在進階模式中撰寫您自己的查詢，請務必先了解您所存取之資料的結構。

​
events.all 資料表

events.all 資料表是所有傳入事件的預設目的地。它是單一的半結構化資料表，包含常見值的資料行，例如時間和事件名稱。您很快就會熟悉 EventData 資料行，其中包含完整的原始 JSON 承載，幾乎在所有查詢中都很有用。您可以閱讀以下關於 events.all 資料表 的文件。

​
查詢的結構

查詢運算式最常以資料表名稱開頭，後面接著管道分隔符號 (|)。 接下來是一或多個運算子。每個運算子都以管道分隔符號分隔。 運算式 依個人偏好，查詢可以寫在單一行，也可以在每個管道分隔符號前換行。這對查詢本身沒有任何影響。 查詢窗格 查詢窗格可以包含多個查詢。這讓您可以輕鬆地從簡單的運算式開始，驗證其可以執行，再以此為基礎繼續建構。 空白行會將一個查詢與另一個查詢分隔開來。當您按下「Run」按鈕時，游標位置會決定要執行哪一個查詢。您也可以醒目提示查詢的一部分，只執行該運算式。 執行

​
建立您的第一個查詢

現在讓我們從頭開始撰寫您的第一個查詢。您可以在查詢窗格中輸入資料表名稱，但我們將使用一個小捷徑。在資源窗格中找到 events.all 資料表。您可能需要按一下箭頭來展開您的遊戲 ID 資料庫。 Events.all 資料表 找到 events.all 資料表後，按兩下資料表名稱。您會發現此運算式已新增至查詢窗格。
在預覽版中，您需要手動在資料表名稱周圍加上方括號和單引號。我們正在修正此不便之處。
請注意名稱周圍的方括號和單引號。每當資料表或資料行名稱包含「.」時，都必須加上這些符號。您的游標現在位於撰寫第一個運算子的正確位置。讓我們開始使用 take 運算子。
執行此查詢。請注意，結果窗格現在會顯示 100 列原始資料。 在結果窗格中，選取最上面一列。使用向右鍵瀏覽至 FullName_Name 資料行。這是事件的名稱。按向下鍵，直到找到 player_logged_in 事件。找到之後，按向右鍵移至 EventData 資料行並按兩下。您現在應該會看到： Event Data 資料行 您的查詢可以使用點標記法 (.) 參考 EventData JSON 中的任何屬性。您現在可以試試看，修改查詢以只傳回單一玩家的 player_logged_in 事件。按兩下 EntityID GUID 並將其複製到剪貼簿。 現在依照下列方式更新您的查詢，並插入您複製的 GUID：
雙等號用來評估字串是否相等。開頭和結尾的單引號用來標示字串。
執行查詢，您會看到結果窗格只顯示所選玩家的 player_logged_in 事件。您可以使用點標記法參考多個巢狀層級的 JSON 階層，只要在每個層級之間加上一個點即可。 現在讓我們建立第二個查詢，依地區將玩家登入分組。在不刪除已撰寫內容的情況下，按兩次 Enter 鍵。讓我們使用「//」為下一個查詢加上註解。註解不會被執行，有助於追蹤每個查詢背後的意圖。
再次從資源窗格按兩下 events.all 資料表。這次，讓我們在運算式中加入時間分隔，將查詢範圍限定為過去三天。
執行此查詢，即可取得過去三天所有登入事件的完整清單。不過，我們想知道的是有多少不同的玩家登入，而不是事件的數量。為此，我們將依 Entity ID 使用 distinct 運算子。
此查詢會傳回過去三天內曾登入的 Entity ID 清單。結果窗格會顯示記錄數目，因此我們可以看到總數。 記錄 現在讓我們取得從每個平台登入的玩家人數。為此，我們需要依 EventData JSON 中的 platform 屬性分組的 Entity ID 相異計數。這需要使用 summarize 運算子。由於 summarize 不支援動態類型，我們也需要將 platform 轉換為字串。
讓我們以精彩的方式收尾。只要再加入一個運算式，我們就可以將結果轉譯為直條圖。
查詢

​
範例查詢

我們只觸及了在 Explorer 中可撰寫之查詢類型的皮毛。您可以在 Explorer 頁面按下「What’s This」來載入更多範例查詢。每個範例查詢都經過挑選，用以示範各種可用的運算子，以及如何將其應用於真實世界的問題。
由於您的資料結構可能與我們的示範資料集不同，您可能需要修改範例查詢，才能在您的案例中執行。

​
限制

有兩項限制規範 Explorer 查詢的使用方式：
  1. 最長查詢執行時間：個別查詢的執行時間不得超過 30 秒。如果超過此限制，查詢將會終止，而且您會收到錯誤訊息。
  2. 間隔使用量：每個遊戲在任何 10 分鐘的間隔內，累計總執行時間上限為三分鐘。如果超過此限制，您會收到錯誤訊息，而且必須等待一段時間才能執行其他查詢。

​
資料保留

根據預設，Data Explorer 查詢會在熱儲存體上執行，您可以在管理工具中設定熱儲存體。搜尋超出熱儲存體中所儲存資料的查詢，執行時間會明顯較長，而且可能會逾時。
最後修改於 2026年10月6日