快速入门：使用 Azure Resource Graph Explorer 运行第一个 Resource Graph 查询

  • 项目

可以直接在 Azure 门户中通过 Azure Resource Graph Explorer 使用 Azure Resource Graph 的强大功能。 通过 Resource Graph 资源管理器，可以查询有关 Azure 资源管理器资源类型和属性的信息。 Resource Graph Explorer 还提供一个界面来处理多个查询、评估结果，甚至是将某些查询的结果转换为可固定到 Azure 仪表板的图表。

先决条件

如果没有 Azure 帐户，请在开始前创建一个试用帐户。

运行首个 Resource Graph 查询

使用 Azure Resource Graph 资源管理器从 Azure 门户中运行第一个查询。

  1. 登录 Azure 门户。

  2. 搜索 Resource Graph 并选择“Resource Graph 资源管理器”。

    用于搜索 Resource Graph 的 Azure 门户的屏幕截图。

  3. 在窗口的“查询 1”部分中，复制并粘贴以下查询。 然后选择“运行查询”。

    resources
| project name, type
| limit 5

    Azure Resource Graph 资源管理器的屏幕截图，其中突出显示了运行查询、结果和消息。

    此查询示例并不提供排序修饰符，如 order by。 如果你多次运行此查询，则可能会为每个请求生成一组不同的资源。

  4. 在“结果”选项卡中查看查询响应，然后选择“消息”选项卡，以查看有关查询的详细信息，包括结果计数和查询持续时间。 如果有错误，错误将显示在“消息”中。

  5. 更新查询，将 order by 条件指定为 name 属性。 然后选择“运行查询”

    resources
| project name, type
| limit 5
| order by name asc

    与第一个查询类似，多次运行此查询可能会为每个请求生成一组不同的资源。 查询命令的顺序非常重要。 在本例中，order by 位于 limit 之后。 命令按此顺序执行，首先会限制查询结果，然后对它们进行排序。

  6. 将查询更新为先按 name 属性应用 order by，然后对前五个结果应用 limit。 然后选择“运行查询”。

    resources
| project name, type
| order by name asc
| limit 5

    多次运行最后一个查询且环境中没有任何变化时，结果将是一致的且按 name 属性排序，但仍限制为前五个结果。

架构浏览器

架构浏览器位于 Resource Graph Explorer 的左窗格中。 此资源列表显示 Azure 资源的所有资源类型，这些类型受 Azure Resource Graph 的支持，并且存在于你的租户中。 选择资源类型或属性以显示可用于创建 Resource Graph 查询的子属性。

从架构浏览器中选择一个表名，此表名会添加到查询中。 选择资源类型时，它会添加到查询中，如 where type =="<resource type>"。 如果选择属性，它会添加到查询的下一行中，如 where <propertyName> == "INSERT_VALUE_HERE"。 可以使用架构浏览器查找可在查询中使用的属性。 请确保将 INSERT_VALUE_HERE 替换为自己的值，并调整包含条件、运算符和函数的查询。

本示例显示通过选择表 authorizationresources 以及资源类型 microsoft.authorization/roledefinitions 和属性 roleName 而在架构浏览器中生成的查询。

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

Azure Resource Graph 资源管理器架构浏览器的屏幕截图，其中突出显示了资源类型和属性。

将查询结果下载为 CSV 文件

若要从 Azure 门户下载逗号分隔值 (CSV) 结果，请浏览到 Azure Resource Graph 资源管理器并运行查询。 在工具栏上，选择“下载为 CSV”，如下面的屏幕截图所示：

Azure Resource Graph 资源管理器的屏幕截图，其中突出显示了“下载为 CSV”。

使用 Azure Resource Graph 资源管理器的“下载为 CSV”导出功能时，结果集限制为 55,000 条记录。 此限制是无法通过提交 Azure 支持工单而替代的平台限制。

基于 Resource Graph 查询创建图表

运行前面的查询后，如果你选择“图表”选项卡，则会看到一条消息，指出“该结果集与饼图可视化效果不兼容。”列出结果的查询无法生成图表，但提供资源计数的查询则可以。

  1. 在窗口中的“查询 1”部分输入以下查询，然后选择“运行查询”。

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

  2. 选择“结果”选项卡，可以看到，此查询的响应提供了计数。

  3. 选择“图表”选项卡。在“选择图表类型...”中将类型更改为“条形图”或“圆环图”。

    Azure Resource Graph 资源管理器的屏幕截图，其中突出显示了图表下拉菜单。

将查询可视化效果固定到仪表板

如果查询返回的结果可以可视化，则你可以将该数据可视化固定到 Azure 门户仪表板。 运行前面的查询后，请执行以下步骤：

  1. 选择“保存”，并提供名称“按 OS 类型统计的 VM 数目”。 然后在右窗格底部选择“保存”。
  2. 选择“运行查询”，以重新运行已保存的查询。
  3. 在“图表”选项卡上，选择一种数据可视化效果。 然后选择“固定到仪表板”。
  4. 从“固定到仪表板”中，选择希望在其上显示图表的现有仪表板。

现在，该查询会显示在仪表板上，其磁贴标题为“按 OS 类型统计的 VM 数目”。 如果在固定之前该查询未保存，则其名称将是“查询 1”。

每当加载仪表板时，该查询和生成的数据可视化就会运行并更新，直接在工作流中提供 Azure 环境的实时动态见解。

也可以将生成列表的查询固定到仪表板。 此功能并不局限于查询的数据可视化。

有关使用仪表板的详细信息，请参阅在 Azure 门户中创建仪表板。

清理资源

若要从 Azure 门户环境中删除示例 Resource Graph 仪表板，可执行以下步骤：

  1. 从任何门户页面左上角的汉堡菜单（三条水平线）中选择“仪表板”。
  2. 在仪表板上，找到“按 OS 类型统计的 VM 数目”图表，然后选择省略号 (...) 以显示菜单。
  3. 选择“从仪表板中删除”，选择“保存”进行确认。

后续步骤

本快速入门已介绍如何使用 Azure Resource Graph 资源管理器运行第一个查询，并提供了 Resource Graph 支持的仪表板示例。 若要详细了解 Resource Graph 语言，请继续阅读查询语言详细信息页。

了解 Azure Resource Graph 查询语言