快速入門：使用 Azure 入口網站執行 Resource Graph 查詢

發行項
04/25/2024

本快速入門說明如何使用 Azure Resource Graph Explorer 在 Azure 入口網站中執行 Azure Resource Graph 查詢。 Resource Graph 總管可讓您查詢 Azure Resource Manager 資源類型和屬性的相關信息。 Resource Graph 總管也提供一個介面，可用來處理多個查詢、評估結果，甚至將某些查詢的結果轉換成可釘選到 Azure 儀錶板的圖表。

必要條件

如果您沒有 Azure 帳戶，請在您開始之前先建立免費帳戶。

執行查詢

使用 Azure Resource Graph Explorer 從 Azure 入口網站執行查詢。

登入 Azure 入口網站。
搜尋 資源圖表 ，然後選取 [資源圖表總管]。
如果您需要變更範圍，請選取 [目錄]。然後，針對您想要查詢的資源選取目錄、管理群組或訂用帳戶。
在視窗的 [ 查詢 1] 部分中，複製並貼上下列查詢。然後選取 [ 執行查詢]。
```
resources
| project name, type
| limit 5
```
此查詢範例不提供像是的 order by排序修飾詞。如果您多次執行查詢，可能會為每個要求產生一組不同的資源。
檢閱 [結果] 索引標籤中的查詢回應，然後選取 [訊息] 索引標籤以查看查詢的詳細數據，包括查詢的結果計數和持續時間。如果有的話，錯誤會顯示在訊息中。
將查詢更新為 order byname 屬性。然後，選取 [ 執行查詢]
```
resources
| project name, type
| limit 5
| order by name asc
```
如同前一個查詢，多次執行此查詢可能會為每個要求產生一組不同的資源。查詢命令的順序很重要。在此範例中，order by 會出現在 limit 之後。查詢會將結果限製為五個資源，然後依名稱排序這些結果。
將查詢更新為 order byname 屬性，然後 limit 更新為前五個結果。然後，選取 [ 執行查詢]。
```
resources
| project name, type
| order by name asc
| limit 5
```
如果此查詢執行數次，且您的環境沒有任何變更，則結果會一致且依 name 屬性排序，但仍限製為五個結果。查詢會依名稱排序結果，然後將輸出限制為五個資源。

架構瀏覽器

架構瀏覽器位於 Resource Graph Explorer 的左窗格中。此資源清單會顯示 Azure Resource Graph 所支援且 存在於租使用者中的所有 Azure 資源資源類型 。選取資源類型或屬性，以顯示可用來建立 Resource Graph 查詢的子屬性。

從架構瀏覽器選取資料表名稱，並新增至查詢。當您選擇資源類型時，它會新增至查詢，例如 where type =="<resource type>"。如果您選取屬性，它會新增至查詢中的下一行，例如 where <propertyName> == "INSERT_VALUE_HERE"。您可以使用架構瀏覽器來尋找可在查詢中使用的屬性。請務必以您自己的值取代 INSERT_VALUE_HERE ，並使用條件、運算符和函式調整查詢。

此範例顯示從架構瀏覽器建置的查詢，方法是選取具有資源類型和 microsoft.authorization/roledefinitions 屬性roleName的數據表authorizationresources。

authorizationresources
| where type == "microsoft.authorization/roledefinitions"
| where properties['roleName'] == "INSERT_VALUE_HERE"

將查詢結果下載為 CSV 檔案

若要從 Azure 入口網站下載逗號分隔值（CSV）結果，請流覽至 Azure Resource Graph 總管並執行查詢。在工具列上，選取 [ 下載為 CSV ]，如下列螢幕快照所示：

當您使用 [ 下載] 作為 Azure Resource Graph Explorer 的 CSV 導出功能時，結果集限制為 55,000 筆記錄。這項限制是無法透過提出 Azure 支援票證來覆寫的平臺限制。

從查詢結果建立圖表

您可以從查詢建立圖表，以輸出資源數目的計數。無法將輸出清單的查詢放入圖表中。如果您嘗試從清單中建立圖表，結果集之類的 訊息與環圈圖視覺效果 不相容，會顯示在 [ 圖表 ] 索引卷標中。

若要從查詢結果建立圖表，請執行下列步驟：

在視窗的 [ 查詢 1] 部分中，輸入下列查詢，然後選取 [ 執行查詢]。

resources
| where type == "microsoft.compute/virtualmachines"
| summarize count() by tostring(properties.storageProfile.osDisk.osType)

選取 [ 結果] 索引標籤，並注意此查詢的回應會提供計數。
選取 [ 圖表] 索引標籤。將類型從 [選取圖表類型... ] 變更為 條形圖 或 環圈圖。

將查詢視覺效果釘選到儀錶板

當您有可可視化查詢的結果時，可以將該數據視覺效果釘選到您的 Azure 入口網站儀錶板。執行上一個查詢之後，請遵循下列步驟：

選取 [儲存]，並使用 [依 OS 類型命名的虛擬機] 和 [類型] 作為 [私人查詢]。然後選取右窗格底部的 [ 儲存 ]。
選取 [ 執行查詢 ] 以重新執行您儲存的查詢。
在 [ 圖表] 索引標籤上，選取數據視覺效果。然後選取 [ 釘選到儀錶板]。
從 [釘選到儀錶板 ] 選取您想要顯示圖表的現有儀錶板。
從漢堡功能表（三條水平線）選取任何入口網站頁面左上方的 [儀錶板]。

查詢現在可在儀錶板上取得，標題 為虛擬機依OS類型。如果查詢未在釘選之前儲存，則名稱會 改為查詢 1 。

每次載入儀錶板時，查詢和產生的數據視覺效果都會執行和更新，直接在工作流程中為您的 Azure 環境提供即時和動態的深入解析。

產生清單的查詢也可以釘選到儀錶板。此功能不限於查詢的數據視覺效果。

從入口網站執行查詢時，您可以選取 [目錄 ] 來變更您要查詢之資源之目錄、管理群組或訂用帳戶的查詢範圍。選取 [釘選到儀錶板] 時，結果會新增至您的 Azure 儀錶板，其中包含執行查詢時所使用的範圍。

如需使用儀錶板的詳細資訊，請參閱在 Azure 入口網站中建立儀錶板。

清除資源

如果您想要從 Azure 入口網站環境中移除範例 Resource Graph 儀錶板，請執行下列步驟：

從漢堡功能表（三條水平線）選取任何入口網站頁面左上方的 [儀錶板]。
在儀錶板上，依OS類型圖表尋找虛擬機，然後選取省略號（...）以顯示功能表。
選取 [從儀錶板 移除] 選取 [ 儲存 ] 以確認。

如果您要依 OS 類型刪除已儲存的查詢，例如虛擬機，請執行下列步驟：

移至 [Azure Resource Graph 總管]。
選取 [ 開啟查詢]。
選取 [輸入私人查詢]。
從 [查詢名稱 ] 中，選取垃圾箱圖示以 刪除此查詢。
輸入 [是] 以確認刪除。

下一步

在本快速入門中，您已使用 Azure Resource Graph Explorer 來執行查詢，並檢閱如何使用圖表和儀錶板。若要深入瞭解，請移至查詢語言詳細數據一文。

了解 Azure Resource Graph 查詢語言

快速入門：使用 Azure 入口網站 執行 Resource Graph 查詢