分享方式：

教學課程：在 Azure 入口網站中建立和共用 Azure Resource Graph 查詢

  • 文章

Azure Resource Graph Explorer 可讓您直接在 Azure 入口網站中儲存 Resource Graph 查詢。 有兩種類型的查詢：私人和共用。 私人查詢會儲存在您的 Azure 入口網站設定中。 共用查詢是一種 Azure Resource Manager 資源，可以使用 Azure 角色型存取控制 (Azure RBAC) 來管理，並使用資源鎖定加以保護。 這兩種類型的查詢都會在待用時加密。

將查詢儲存在 Azure 入口網站中，可讓您省下在尋找慣用或常用查詢時可能耗費的時間。 在共用查詢時，您將協助小組成員透過重複的動作實現一致性和效率的目標。

在本教學課程中，您將完成下列工作：

  • 建立和刪除私人查詢
  • 建立共用查詢
  • 探索共用查詢
  • 刪除共用查詢

必要條件

若要完成此教學課程，您需要 Azure 訂用帳戶。 如果您沒有 Azure 訂用帳戶，請在開始前建立免費帳戶。

建立和刪除私人查詢

只有建立私人查詢的帳戶才可存取及檢視這些查詢。 這些查詢儲存於帳戶的 Azure 入口網站設定後，就只能在 Azure 入口網站中加以建立、使用和刪除。 私人查詢不是 Resource Manager 資源。 若要建立新的私人查詢，請執行下列步驟：

  1. 從入口網站功能表中選取 [所有服務]，或使用所有頁面頂端的 Azure 搜尋方塊。 搜尋並選取 [Resource Graph Explorer]。

  2. 在 [Azure Resource Graph Explorer] 頁面的 [查詢 1] 索引標籤上，輸入下列查詢：

    Resources
| where type =~ 'Microsoft.Compute/virtualMachines'
| summarize count() by tostring(properties.storageProfile.osDisk.osType)

    選取 [執行查詢]，以查看底部窗格中的查詢結果。

    如需此查詢的詳細資訊，請參閱樣本 - 依作業系統類型計算虛擬機器。

  3. 選取 [儲存] 或 [另存新檔]，輸入「依作業系統計算 VM 計數」作為名稱，並將類型保留為 [私人查詢]，然後在 [儲存查詢] 窗格底部選取 [儲存]。 索引標籤標題會從「查詢 1」變更為「依作業系統計算 VM 計數」。

  4. 從 Azure 入口網站中的 Azure Resource Graph Explorer 移出，然後再返回該處。 請注意，已儲存的查詢已不再顯示，而會回復為 [查詢 1] 索引標籤。

  5. 選取 [開啟查詢]。 請確定類型為 [私人查詢]。 此時，已儲存的名稱「依作業系統計算 VM 計數」會出現在 [查詢名稱] 清單中。 當您選取已儲存查詢的標題連結時，該查詢會載入至具有該查詢名稱的新索引標籤中。

    注意

    當已儲存的查詢開啟，且索引標籤顯示其名稱時，若選取 [儲存] 按鈕，將會以已進行的任何變更來更新該查詢。 若要從這個開啟的查詢建立新儲存的查詢，請選取 [另存新檔] 並繼續操作，如同儲存全新的查詢一般。

  6. 若要刪除已儲存的查詢，請再次選取 [開啟查詢]，並確認 [類型] 欄位設定為 [私人查詢]。 在已儲存的 Count VMs by OS 查詢的資料列上，選取 [刪除] (垃圾桶圖示)。 在確認對話方塊中選取 [是]，以完成查詢的刪除作業。 然後，關閉 [開啟查詢] 窗格。

建立共用查詢

不同於私人查詢，共用查詢是 Resource Manager 資源。 這表示查詢會儲存至資源群組、可透過 Azure RBAC 來管理和控制，甚至可使用資源鎖定加以保護。 作為資源，任何人只要具有適當的權限，即可加以檢視和使用。 若要建立新的共用查詢，請執行下列步驟：

  1. 從入口網站功能表中選取 [所有服務]，或使用所有頁面頂端的 Azure 搜尋方塊，來搜尋並選取 [Resource Graph Explorer]。

  2. 在 [Azure Resource Graph Explorer] 頁面的 [查詢 1] 索引標籤上，輸入下列查詢：

    Resources
| where type =~ 'Microsoft.Compute/virtualMachines'
| summarize count() by tostring(properties.storageProfile.osDisk.osType)

    選取 [執行查詢]，以查看底部窗格中的查詢結果。

    如需此查詢的詳細資訊，請參閱樣本 - 依作業系統類型計算虛擬機器。

  3. 選取 [儲存] 或 [另存新檔]。

    Save the new query using the save button

  4. 在 [儲存查詢] 窗格中，輸入「依作業系統計算 VM 計數」作為名稱。

  5. 將類型變更為 [共用查詢]，並將 [描述] 設定為 [依作業系統類型計算虛擬機器計數]，然後設定 [訂用帳戶] 以指定查詢資源的建立位置。

  6. 讓 [發佈至 resource-graph-queries 資源群組] 核取方塊保持選取狀態，並將 [資源群組位置] 設定為 [(US) 美國中西部]。

  7. 選取 [儲存查詢] 窗格底部的 [儲存]。 索引標籤標題會從「查詢 1」變更為「依作業系統計算 VM 計數」。 第一次使用 resource-graph-queries 資源群組時，建立資源群組所需的儲存時間會比預期還要久。

    Save the new query as a Shared query

    注意

    如果您想要提供現有資源群組的名稱用以儲存共用查詢，您可以清除 [發佈至 resource-graph-queries 資源群組] 核取方塊。 將具有預設名稱的資源群組用於查詢，可讓共用查詢更易於探索。 此外也可讓該資源群組的用途更為明顯。 不過，基於安全考量，您可以選擇根據現有的權限來選取現有的資源群組。

  8. 從 Azure 入口網站中的 Azure Resource Graph Explorer 移出，然後再返回該處。 請注意，已儲存的查詢已不再顯示，而會回復為 [查詢 1] 索引標籤。

  9. 選取 [開啟查詢]。 請確認 [類型] 設定為 [共用查詢]，且 [訂用帳戶] 和 [資源群組] 的組合與您儲存查詢之處相符。 此時，已儲存的「依作業系統計算 VM 計數」項目會出現在 [查詢名稱] 清單中。 選取已儲存查詢的標題連結，可將該查詢載入至具有該查詢名稱的新索引標籤中。 該查詢為共用查詢，在索引標籤中的標題旁會顯示一個圖示，指出它是共用的。

    Show the Shared Query with icon

    注意

    當已儲存的查詢開啟，且索引標籤顯示其名稱時，[儲存] 按鈕將會以已進行的任何變更來更新該查詢。 若要建立新儲存的查詢，請選取 [另存新檔] 並繼續操作，如同儲存全新的查詢一般。

探索共用查詢

共用查詢是 Resource Manager 資源，因此有數種方式可尋找此類查詢：

  • 從 Resource Graph 總管。 選取 [開啟查詢]，並將類型設定為 [共用查詢]。
  • 從 Resource Graph 查詢入口網站頁面。
  • 從共用查詢儲存所在的資源群組。
  • 透過對 Resource Graph 的查詢。

檢視 Resource Graph 查詢

在 Azure 入口網站中，Resource Graph 查詢頁面會顯示已登入的帳戶可存取的共用查詢。 此頁面可讓您依名稱、訂用帳戶、資源群組和 Resource Graph 查詢的其他屬性進行篩選。 您也可以使用此介面來標記、匯出和刪除 Resource Graph 查詢。

選取其中一個查詢，即會開啟 Resource Graph 查詢頁面。 就像其他 Resource Manager 資源一樣，此頁面也提供互動式概觀，以及活動記錄、存取控制和標籤。 您也可以直接從這個頁面套用資源鎖定。

從入口網站功能表中選取 [所有服務]，或使用所有頁面頂端的 Azure 搜尋方塊，即可進入 Resource Graph 查詢頁面。 搜尋並選取 [Resource Graph Explorer]。

列出資源群組資源

Resource Graph 查詢會與屬於資源群組的其他資源一起列出。 選取 Resource Graph 查詢，即會開啟該查詢的頁面。 選取並按住 (或按一下滑鼠右鍵)即觸發的省略符號和捷徑功能表選項與 Resource Graph 查詢頁面上的運作方式相同。

查詢 Resource Graph

您可以透過查詢 Resource Graph 來尋找 Resource Graph 查詢。 下列 Resource Graph 查詢會受到類型 Microsoft.ResourceGraph/queries 的限制，然後使用 project 而僅列出名稱、修改時間和查詢本身：

Resources
| where type == "microsoft.resourcegraph/queries"
| project name, properties.timeModified, properties.query

執行共用查詢

您可以使用 {{shared-query-uri}} 語法 (預覽) 來執行 Resource Graph 的共用查詢。 如需詳細資訊，請參閱共用查詢語法。

刪除共用查詢

不再需要共用查詢時，請將其刪除。 刪除共用查詢時，會移除對應的 Resource Manager 資源。 此時，任何釘選了結果圖表的儀表板都會顯示錯誤訊息。 該錯誤訊息顯示時，請使用 [從儀表板移除] 按鈕清除您的儀表板。

您可以透過下列介面來刪除共用查詢：

  • Resource Graph 查詢頁面
  • Resource Graph 查詢頁面
  • Resource Graph Explorer 中的 [開啟查詢] 頁面
  • 資源群組頁面

清除資源

完成本教學課程後，如果不再需要您所建立的私人和共用查詢，請加以刪除。

下一步

在本教學課程中，您已建立私人和共用查詢。 若要深入了解 Resource Graph 語言，請繼續前往查詢語言詳細資料頁面。

取得有關查詢語言的詳細資訊