在 Redash 中可视化 Azure 数据资源管理器的数据

项目
12/21/2023

Redash 可以连接和查询数据源，并可以生成仪表板来可视化数据并将其与同事共享。本文介绍如何将 Azure 数据资源管理器设置为 Redash 的数据源，然后将数据可视化。

先决条件

Azure 订阅。创建 Azure 帐户。
Azure 数据资源管理器群集和数据库。创建群集和数据库。
根据将示例数据引入 Azure 数据资源管理器中所述引入数据。有关更多引入选项，请参阅引入概述。

配置数据源

执行以下步骤将 Azure 数据资源管理器配置为仪表板工具的数据源。我们将在本节中更详细地介绍这些步骤：

创建 Microsoft Entra 服务主体。仪表板工具使用服务主体访问 Azure 数据资源管理器服务。
将 Microsoft Entra 服务主体添加到 Azure 数据资源管理器数据库中的“查看者”角色。
根据 Microsoft Entra 服务主体中的信息指定仪表板工具连接属性，然后测试连接。

创建服务主体

可在 Azure 门户中或使用 Azure CLI 命令行创建服务主体。无论使用哪种方法，创建后都会获得四个连接属性的值，将在后面的步骤中用到这些值。

Azure 门户

要创建服务主体，请按照 Azure 门户文档中的说明进行操作。
1. 在将应用程序分配给角色部分，将“读取者”的角色类型分配给 Azure 数据资源管理器群集。
2. 在获取用于登录的值部分中，复制步骤中的三个属性值：目录 ID（租户 ID）、应用程序 ID 和密码。
在 Azure 门户中，选择“订阅”，然后复制在其中创建服务主体的订阅的 ID 。

Azure CLI

创建服务主体。设置适用范围和角色类型 reader。

az ad sp create-for-rbac --name "https://{UrlToYourDashboard}:{PortNumber}" --role "reader" \
                         --scopes /subscriptions/{SubID}/resourceGroups/{ResourceGroupName}

有关详细信息，请参阅使用 Azure CLI 创建 Azure 服务主体。

该命令返回如下结果集。复制三个属性值：appID、密码和租户。

{
  "appId": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
  "displayName": "{UrlToYourDashboard}:{PortNumber}",
  "name": "https://{UrlToYourDashboard}:{PortNumber}",
  "password": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
  "tenant": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
}

获取订阅的列表。
```
az account list --output table
```
复制相应的订阅 ID。

将服务主体添加到查看者角色

现在已有服务主体，可将其添加到 Azure 数据资源管理器数据库中的“查看者”角色。可在 Azure 门户中的“权限”下执行此任务，也可以使用管理命令在“查询”下执行此任务。

Azure 门户 - 权限

在 Azure 门户中，转到 Azure 数据资源管理器群集。
在“概述”部分中，选择包含 StormEvents 样本数据的数据库。
选择“权限”，然后选择“添加” 。
在“添加数据库权限”下，选择“查看者”角色，然后选择“选择主体” 。
搜索已创建的服务主体。选择主体，然后单击“选择” 。
选择“保存”。

管理命令 - 查询

在 Azure 门户中，转到 Azure 数据资源管理器群集，然后选择“查询” 。
在查询窗口中运行以下命令。使用 Azure 门户或 CLI 中的应用程序 ID 和租户 ID。
```
.add database {TestDatabase} viewers ('aadapp={ApplicationID};{TenantID}')
```
该命令返回如下结果集。在此示例中，第一行用于数据库中的现有用户，第二行用于刚刚添加的服务主体。

在 Redash 中创建 Azure 数据资源管理器连接器

登录到 Redash。选择“开始”以创建帐户。
在“让我们开始吧”中选择“连接数据源”。
在“创建新数据源”窗口中，依次选择“Azure 数据资源管理器(Kusto)”、“创建”。
在“Azure 数据资源管理器(Kusto)”窗口中填写以下表单，然后选择“创建”。
在“设置”窗口中选择“保存”，然后选择“测试连接”以测试“Azure 数据资源管理器(Kusto)”数据源的连接。

在 Redash 中创建查询

在 Redash 的左上方，选择“创建”>“查询”。单击“新建查询”并重命名查询。
在顶部的编辑窗格中键入查询，然后依次选择“保存”、“执行”。选择“发布”以发布查询供将来使用。

在左窗格中，可以在下拉菜单中看到数据源连接名称（在我们的流中为“Github 连接器”），并可以看到所选数据库中的表。
在底部的中间窗格中查看查询结果。选择“新建可视化效果”按钮创建用于查询的可视化效果。
在可视化效果屏幕中选择“可视化效果类型”，以及“X 列”和“Y 列”等相关字段。保存可视化效果。

使用参数创建查询

选择“创建”>“查询”以创建新查询。使用 {{}} 大括号将一个参数添加到查询中。选择“{{}}”打开“添加参数”窗口。还可以选择“设置”图标来修改现有参数的属性，并打开“<参数名称>”窗口。
为参数命名。从下拉菜单中选择“类型: 基于查询的下拉列表” 。选择“确定”

注意

该查询使用多个值，因此必须包含以下语法：| where Type in ((split('{{Type}}', ',')))。有关详细信息，请参阅 in 运算符。这会导致 Redash 应用中出现多个查询参数选项

在 Redash 中创建仪表板

若要创建仪表板，请选择“创建”>“仪表板”。或者，选择现有仪表板：“仪表板”> 从列表中选择仪表板。
在“新建仪表板”窗口中为仪表板命名，然后选择“保存”。在“<仪表板名称>”窗口中，选择“添加小组件”以创建新的小组件。
在“添加小组件”窗口中选择查询名称，然后选择“选择可视化效果”和“参数”。选择“添加到仪表板”
选择“完成编辑”以完成仪表板的创建。
在仪表板编辑模式下，选择“使用仪表板级别筛选器”以使用前面定义的“类型”参数。

后续步骤

Azure 数据资源管理器的编写查询